跳转到主要内容
POST
获取 Cascade 分析数据

概述

获取 Cascade 特有的分析数据,包括建议和采纳的代码行数、模型用量、额度消耗以及工具用量统计。

请求

service_key
string
必填
具有“Teams 只读”权限的服务密钥
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
必填
要执行的数据源查询数组。每个对象都应包含一个受支持的数据源。

数据源

cascade_lines

查询 Cascade 每日建议及已接受的代码行数。
响应字段:
  • 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 积分)