メインコンテンツへスキップ
POST
Cascade Analyticsを取得

概要

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

リクエスト

service_key
string
必須
「Teams Read-only」権限を持つサービスキー
group_name
string
結果を特定のグループのユーザーに絞り込みます。emails パラメータとは併用できません。
start_timestamp
string
RFC 3339 形式の開始時刻 (例: 2023-01-01T00:00:00Z)
end_timestamp
string
RFC 3339 形式の終了時刻 (例: 2023-12-31T23:59:59Z)
emails
array
結果の絞り込みに使用するメールアドレスの配列。group_name パラメータとは併用できません。
ide_types
array
IDE の種類で絞り込みます。利用可能なオプション:
  • "editor" - Devin Desktop Editor
  • "jetbrains" - JetBrains Plugin
  • "cli" - Devin CLI
省略した場合は、すべての IDE のデータを返します。
Devin CLI ("cli") で絞り込む場合、データが返されるのは cascade_runs のみです。cascade_linescascade_tool_usage のデータソースは Devin CLI ではサポートされていないため、空の結果が返されます。
query_requests
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 - ツールが利用された回数

ツール使用の対応表

リクエスト例

応答

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

レスポンス例

注意事項

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