カスタム API 利用状況ダッシュボードを構築する
Devin には利用状況ダッシュボードが組み込まれていますが、カスタムメトリクスが必要な場合や Devin のデータを他のデータソースと組み合わせたい場合は、v3 API を使って Devin に要件に合わせたカスタム版を作成させることができます。APIアクセス用のサービスユーザーを作成する
v3 API は、個人の APIキー ではなくサービスユーザー用トークンで認証します。Devin がデータを取得できるようにするには、事前にサービスユーザーを作成しておく必要があります。
- app.devin.ai > Settings > Service Users に移動します
- Create Service User をクリックし、
ViewAccountMetricsとManageBilling権限を含むロールを割り当てます — セッションメトリクスと利用データを読み取るのに必要です - 作成後に表示される API トークンをコピーします — 表示されるのは一度きりです
- トークンを Secret として
DEVIN_SERVICE_USER_TOKENという名前で保存します。これにより、ハードコードせずに Devin がセッション中にトークンを使用できます
Devin に何を作るか伝える
Devin は Devin docs MCP を通じて自分自身のドキュメントにネイティブアクセスできます。そのため、プロンプトに API リファレンスを貼り付ける必要はありません。適切なエンドポイントを指定すれば、リクエスト形式、クエリパラメータ、レスポンス構造を学ぶためにドキュメントを読み込みます。
Devin が構築するもの
Devin は docs MCP 経由で v3 API docs を読み、正確なリクエスト形式を把握したうえで、次のようにアプリの骨組みを作成します。
- API ドキュメントを読む — Devin docs MCP から consumption および metrics のエンドポイントスキーマを検索し、
start_date、end_dateなどのクエリパラメータやレスポンス構造を学習します - API ルートを作成する —
DEVIN_SERVICE_USER_TOKENシークレットからサービスユーザー用トークンを取得し、それを用いてhttps://api.devin.ai/v3/enterprise/*へのリクエストをプロキシする Next.js API ルートを構築します - ダッシュボード UI を構築する — Recharts を使ってレスポンシブなダッシュボードページを作成し、次を含めます:
- 総セッション数、消費された ACU、週間アクティブユーザー数を表示する KPI カード
/consumption/daily/organizationsエンドポイントから取得した日次消費量の時系列チャート/consumption/daily/usersから取得したユーザー別の内訳- セッションリストエンドポイントから取得したステータス、継続時間、ACU コスト付きのセッションテーブル
- フィルタリングを追加する — すべてのエンドポイントを、更新された
start_dateとend_dateパラメータで再フェッチする日付範囲ピッカーを接続します - PR を作成する — 環境変数、ローカル開発セットアップ（
npm run dev）、および Vercel へのデプロイ方法を説明したREADME.mdとともにアプリをプッシュします