响应字段 request_id string 请求标识,可用于问题排查 data object 用量查询结果 data.query_range object 实际统计区间。仅 workspace、agent 维度返回;session 维度不返回该字段 data.query_range.start_time string 对齐后的开始时间,包含该时刻,固定使用 +08:00 时区 data.query_range.end_time string 对齐后的结束时间,不包含该时刻,固定使用 +08:00 时区 data.data_updated_at string / null 本次返回用量记录中最近的已知更新时间,固定使用 +08:00 时区;无记录或更新时间未知时为 null data.usage object 总量及分组明细 data.usage.total object 查询范围内的汇总指标,详见 汇总指标(total) data.usage.models array 按模型名称分组的用量明细,无明细时为 [] data.usage.tools array 按工具来源和名称分组的用量明细,无明细时为 [] Session 查询返回相同的 usage 结构,不包含 query_range 或 Session 标题、状态等元数据。服务先校验 Session 归属,再查询生命周期累计用量。Session 存在但尚无统计记录时,指标 value 为 null,模型和工具明细为空数组;不会据此返回 Session 不存在。 | 响应示例 成功时返回 HTTP 200,顶层字段为 request_id、data。以下为上述 Agent 请求的汇总示例:秒级起止时间按 hour 对齐为 UTC+8 10:00—15:00,数值仅用于说明响应结构。 {
"request_id": "req_summary_example",
"data": {
"query_range": {
"start_time": "2026-11-02T10:00:00+08:00",
"end_time": "2026-11-02T15:00:00+08:00"
},
"data_updated_at": "2026-11-02T14:10:00+08:00",
"usage": {
"total": {
"input_tokens": {"value": 1000, "unit": "tokens"},
"output_tokens": {"value": 200, "unit": "tokens"},
"total_tokens": {"value": 1200, "unit": "tokens"},
"cache_read_tokens": {"value": 400, "unit": "tokens"},
"cache_creation_tokens": {"value": 100, "unit": "tokens"},
"cache_hit_ratio": {"value": 0.4, "unit": "ratio"},
"model_call_count": {"value": 5, "unit": "count"},
"tool_call_count": {"value": 3, "unit": "count"},
"builtin_tool_call_count": {"value": 0, "unit": "count"},
"mcp_tool_call_count": {"value": 3, "unit": "count"},
"custom_tool_call_count": {"value": 0, "unit": "count"},
"turns": {"value": 2, "unit": "count"},
"steps": {"value": 8, "unit": "count"},
"interrupt_error_count": {"value": 0, "unit": "count"},
"model_failed_count": {"value": 1, "unit": "count"},
"tool_failed_count": {"value": 1, "unit": "count"},
"runtime_ms": {"value": 60000, "unit": "ms"}
},
"models": [
{
"model_name": "qwen-plus",
"usage": {
"input_tokens": {"value": 1000, "unit": "tokens"},
"output_tokens": {"value": 200, "unit": "tokens"},
"total_tokens": {"value": 1200, "unit": "tokens"},
"cache_read_tokens": {"value": 400, "unit": "tokens"},
"cache_creation_tokens": {"value": 100, "unit": "tokens"},
"cache_hit_ratio": {"value": 0.4, "unit": "ratio"},
"call_count": {"value": 5, "unit": "count"},
"failed_count": {"value": 1, "unit": "count"}
}
}
],
"tools": [
{
"source": "mcp",
"tool_name": "web_search",
"usage": {
"call_count": {"value": 3, "unit": "count"},
"failed_count": {"value": 1, "unit": "count"}
}
}
]
}
}
}
|