获取成员的 AI 使用数据

更新于: 2026-06-11 19:19:28

获取指定时间范围内，指定成员的 AI 使用数据。

所需权限

statistics

请求方式

POST /openapi/v1/statistics/user-metrics

请求体

参数	类型	是否必填	默认值	描述
`start_date`	string	是	-	开始日期。格式：YYYY-MM-DD。
`end_date`	string	是	-	结束日期。格式：YYYY-MM-DD。
`timezone`	string	否	`"Asia/Shanghai"`	时区。需使用 IANA 时区名称。
`user_ids`	int64[]	是	-	成员的 ID，最多 100 个。
`emails`	string[]	是	-	成员的邮箱，最多 100 个。

提示

user_ids 和 emails 参数只需提供其中一个。
由于 user_ids 的优先级高于 emails，若同时传入两个参数，emails 会被忽略。

响应参数

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

参数	类型	描述
`user_id`	int64	成员的 ID。
`email`	string	成员的邮箱。
`metrics`	object	时间范围内的整体汇总数据。
`daily_trend`	array	按天拆分的趋势数据。

metrics 对象和 daily_trend 数组包含的参数如下：

参数	类型	描述
`date`	string	日期。格式：YYYY-MM-DD。该参数为 `daily_trend` 部分独有。
`ai_generation_rate`	float64	AI 生成代码在总代码产出中的占比（%）。
`ai_contribution_rate`	float64	AI 代码贡献率（%），表示最终提交到仓库的代码中，有多少来自 AI。
`ai_generated_code_lines`	int64	在对话和自动补全中，AI 生成的代码总行数。
`chat_code_gen_lines`	int64	在对话中，AI 生成的总代码行数。
`chat_code_accept_lines`	int64	在对话中，AI 生成的代码被采纳的总行数。
`cue_recommend_count`	int64	CUE 提供代码建议的总次数。
`cue_recommend_accepted`	int64	CUE 提供的代码建议被采纳的总次数。
`ai_commit_lines`	int64	AI 生成的代码被提交到仓库的总行数。
`non_ai_commit_lines`	int64	非 AI 生成的代码被提交到仓库的总行数。
`total_commit_lines`	int64	提交到仓库的总代码行数。

请求示例

{
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "user_ids": [123456],
  "emails": ["name@example.com"]
}

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "users": [
      {
        "user_id": 12314124,
        "email": "name@example.com",
        "metrics": {
          "ai_generation_rate": 35.5,
          "ai_contribution_rate": 22,
          "ai_generated_code_lines": 120000,
          "chat_code_gen_lines": 500,
          "chat_code_accept_lines": 350,
          "cue_recommend_count": 50000,
          "cue_recommend_accepted": 150,
          "ai_commit_lines": 10000,
          "non_ai_commit_lines": 10000,
          "total_commit_lines": 20000
        },
        "daily_trend": [
          {
            "date": "2026-01-15",
            "ai_generation_rate": 25.5,
            "ai_contribution_rate": 18,
            "ai_generated_code_lines": 5000,
            "chat_code_gen_lines": 130,
            "chat_code_accept_lines": 100,
            "cue_recommend_count": 60,
            "cue_recommend_accepted": 30,
            "ai_commit_lines": 1000,
            "non_ai_commit_lines": 1000,
            "total_commit_lines": 2000
          }
        ]
      }
    ]
  }
}