Skip to main content
POST
获取 Cascade Analytics

概览

获取 Cascade 专属的 Analytics 数据,包括建议/接受的代码行数、AI 模型使用情况、额度消耗以及工具使用统计。

请求

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 插件
如未指定,将返回两种 IDE 的数据。
array
必填
要执行的数据源查询数组。每个对象应包含一个受支持的数据源。

数据来源

cascade_lines

查询每日由 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 - 工具标识符(参见下文的工具映射)
  • count - 工具使用次数

工具使用映射

示例请求

响应

array
查询结果数组,每个查询请求对应一个查询结果

示例回复

注意事项

  • API 返回的是原始数据,其中可能包含 “UNKNOWN” 值
  • 进行指标分析时,请按感兴趣的特定字段进行聚合(例如,对 promptsUsed 求和以分析使用模式)
  • Mode 和 prompt 数据可能会拆分到多条记录中
  • 点数消耗(promptsUsed)以“分”为单位返回(100 = 1 credit)