Skip to main content
POST
Cascade Analyticsを取得

概要

提案数・採用数、モデル使用量、クレジット消費量、ツールの利用統計など、Cascade 固有の分析データを取得します。

リクエスト

string
必須
「Teams Read-only」権限を持つサービスキー
string
結果を特定のグループのユーザーに絞り込みます。emails パラメータとは併用できません。
string
RFC 3339 形式の開始時刻 (例: 2023-01-01T00:00:00Z)
string
RFC 3339 形式の終了時刻 (例: 2023-12-31T23:59:59Z)
array
結果の絞り込みに使用するメールアドレスの配列。group_name パラメータとは併用できません。
array
IDE の種類で絞り込みます。利用可能なオプション:
  • "editor" - Devin Desktop Editor
  • "jetbrains" - JetBrains Plugin
  • "cli" - Devin CLI
省略した場合は、すべての IDE のデータを返します。
Devin CLI ("cli") で絞り込む場合、cascade_runsmode フィールドには値が設定されません。cascade_linescascade_tool_usage は Devin CLI と Devin Local のアクティビティを対象としますが、これらのエージェントがデータの報告を開始して以降に記録されたデータのみを含みます。
array
必須
実行するデータソースのクエリの配列です。各オブジェクトには、サポートされているデータソースのいずれか 1 つを含める必要があります。

データソース

cascade_lines

日次の、提案済みおよび採用済みの Cascade lines をクエリします。
レスポンスフィールド:
  • day - RFC 3339形式の日付
  • linesSuggested - 提案された行数
  • linesAccepted - 採用された行数

cascade_runs

モデルの使用量、クレジットの消費量、およびモードデータをクエリします。
レスポンスフィールド:
  • day - RFC 3339形式の日付
  • model - 使用したモデル名
  • mode - Cascadeモード (以下のモードを参照)
  • messagesSent - 送信されたメッセージ数
  • cascadeId - 一意の会話ID
  • promptsUsed - 消費されたクレジット (セント単位)
Cascadeモード:
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - 書き込みモード
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - 読み取りモード
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - レガシーモード
  • UNKNOWN - 不明なモード

cascade_tool_usage

ツール使用量の統計情報 (集計数) をクエリします。
レスポンス フィールド:
  • tool - ツール識別子 (以下のツール対応表を参照)
  • count - ツールが利用された回数

ツール使用の対応表

リクエスト例

応答

array
各クエリリクエストに対応するクエリ結果の配列

レスポンス例

注意事項

  • API は生データを返すため、"UNKNOWN" の値が含まれる場合があります
  • メトリクスを分析する際は、関心のある特定のフィールドごとに集計してください (例: 使用量のパターンを把握するには promptsUsed の合計を使用します)
  • モードとプロンプトのデータは複数のエントリに分かれている場合があります
  • クレジット消費量 (promptsUsed) はセント単位で返されます (100 = 1 クレジット)