Skip to main content
POST
Cascade Analytics の取得

概要

提案された行数・受け入れられた行数、AI モデルの利用状況、クレジット消費量、ツールの利用統計など、Cascade 固有の Analytics データを取得します。

リクエスト

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" - Windsurf Editor
  • "jetbrains" - JetBrains Plugin
省略時は、両方の IDE のデータを返します。
array
必須
実行するデータソースクエリの配列。各オブジェクトには、サポート対象のいずれかのデータソースを含めてください。

データソース

cascade_lines

1日ごとの Cascade の提案行数と受け入れ行数をクエリします。
レスポンス項目:
  • day - RFC 3339 形式の日付
  • linesSuggested - 提案行数
  • linesAccepted - 受け入れ行数

cascade_runs

AI モデルの使用状況、クレジット消費量、およびモードに関するデータをクエリします。
レスポンスフィールド:
  • day - 日付(RFC 3339 形式)
  • model - 使用した AI モデル名
  • 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 - ツール ID(下記のツールマッピングを参照)
  • count - ツールが使用された回数

ツール利用マッピング

リクエストの例

Response

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

返答例

注意事項

  • API は未加工のデータを返し、その中には「UNKNOWN」という値が含まれる場合があります
  • メトリクス分析では、関心のある特定のフィールドごとに集計します(例: 使用パターン分析のために promptsUsed を合計する)
  • Mode や prompt のデータは、複数のエントリに分割されている場合があります
  • クレジット消費量(promptsUsed)はセント単位で返されます(100 = 1 クレジット)