获取指定时间范围内，指定成员的 AI 使用数据汇总与逐日趋势。

所需权限

statistics:read

请求说明

请求方式：POST

请求地址：{域名}/openapi/v1/statistics/user-metrics

注意事项

时间跨度最长为 180 天。

user_ids 与 emails 至少传入一个。系统会分别去除重复的成员 ID 和邮箱；去重后，两个数组的元素总数不得超过 100。同一成员同时通过 ID 和邮箱传入时，仍按两个元素计数，但响应中该成员只返回一次。

请求参数

请求头参数

Header 参数	是否必填	描述
Authorization	是	固定取值为 Bearer {access_token}。关于如何获取访问令牌，参考鉴权。
Content-Type	是	固定取值为 application/json。

请求体参数

参数	类型	是否必填	默认值	描述
start_date	string	是	-	开始日期。格式：YYYY-MM-DD。
end_date	string	是	-	结束日期。格式：YYYY-MM-DD。
timezone	string	否	"Asia/Shanghai"	时区。需使用 IANA 时区名称。
user_ids	string[]	条件必填	-	目标成员的 ID。与 emails 至少传一个。成员的 ID 可以通过 “获取成员列表” 接口获取。
emails	string[]	条件必填	-	目标成员的邮箱。与 user_ids 至少传一个。成员的邮箱可以通过 “获取成员列表” 接口获取。
use_git_ai	bool	否	false	是否按 Git AI 统计口径返回代码贡献数据： true：按 Git AI 统计口径返回数据 false：按原有统计口径返回数据

响应参数

响应数据按成员维度组织，返回每位指定成员各自的 AI 使用数据。

参数	类型	描述
users	array	成员维度的结果列表。
users[].user_id	int64	成员的 ID。
users[].user_id_str	string	成员 ID 的字符串形式。
users[].email	string	成员的邮箱。
users[].account_type	int	成员的账号类型，1 表示全端账号，2 表示 Work 专属账号。
users[].metrics	object	成员在时间范围内的整体汇总数据。
users[].daily_trend	array	成员的逐日数据。

metrics 对象和 daily_trend 数组包含的参数如下表所示。

其中，ai_commit_lines、non_ai_commit_lines 和 total_commit_lines 按以下规则统计：

查询时间范围内仅包含按原有口径上报的数据时，按原有口径计算。

查询时间范围内同时包含两种口径的数据时，聚合后再计算。例如，前三天按原有口径上报、从第四天起按 Git AI 口径上报时，响应结果会聚合整个查询时间范围内的数据。

参数	类型	描述
date	string	日期。格式：YYYY-MM-DD。该参数为 daily_trend 数组独有。
ai_generation_rate	float64	AI 生成代码在总代码产出中的占比（%）。计算公式：（ai_generated_code_lines ÷ 期间内生成的总代码行数）× 100%。数据来源：TRAE、TRAE Plugin。
ai_contribution_rate	float64	AI 代码贡献率。表示最终提交到仓库的代码中，AI 生成代码的占比（%）。计算公式：（ai_commit_lines ÷ total_commit_lines）× 100%。数据来源：TRAE、TRAE Plugin。
ai_generated_code_lines	int64	在问答和自动补全功能中，AI 生成的代码总行数。数据来源：TRAE、TRAE Plugin。
chat_code_gen_lines	int64	在问答功能中，AI 生成的总代码行数。数据来源：TRAE、TRAE Plugin。
chat_code_accept_lines	int64	在问答功能中，AI 生成的代码被采纳的总行数。数据来源：TRAE、TRAE Plugin。
cue_recommend_count	int64	CUE 提供代码建议的总次数。数据来源：TRAE、TRAE Plugin。
cue_recommend_accepted	int64	CUE 提供的代码建议被采纳的总次数。数据来源：TRAE、TRAE Plugin。
ai_commit_lines	int64	AI 生成的代码被提交到仓库的总行数。数据来源：TRAE、TRAE Plugin。
non_ai_commit_lines	int64	非 AI 生成的代码被提交到仓库的总行数。数据来源：TRAE、TRAE Plugin。
total_commit_lines	int64	提交到仓库的总代码行数。数据来源：TRAE、TRAE Plugin。
total_requests	int64	总问答次数。数据来源：TRAE、TRAE Plugin、TRAE CLI、TraeWork 桌面版与网页版、TRAE 移动端。
chat_requests	int64	与内置智能体 “Chat” 产生的问答次数。数据来源：TRAE、TRAE Plugin。
agent_requests	int64	含以下两部分指标：在 TRAE 中，与内置智能体 “Agent” 与 “SOLO Agent”，以及自定义智能体产生的问答次数。在 TRAE Plugin 中，与内置智能体 “Agent” 与自定义智能体产生的问答次数。
agent_accepted_requests	int64	含以下两部分指标：在 TRAE 中，内置智能体 “Agent” 与 “SOLO Agent”，以及自定义智能体的输出被采纳的次数。在 TRAE Plugin 中，内置智能体 “Agent” 与自定义智能体的输出被采纳的次数。
cli_requests	int64	在 TRAE CLI 中产生的问答次数。
work_requests	int64	在 TraeWork 桌面版与网页版，以及 TRAE 移动端中产生的问答次数。

示例

请求示例

响应示例

错误码

若该接口的请求返回错误码，参考错误码文档进行排查。

TRAE CN