通过 API 获取 AI 分析数据。
作为 Analytics 的一部分，IDE Services Cloud 提供了一个 公共 API ，使您能够洞察各类与 AI 相关的指标，帮助了解本组织内 AI 采用情况及 AI 活动及其影响。
用户与采用情况
可通过 API 获取以下采用与使用指标：
用户可访问 AI - 在所选时间段内启用 AI 的唯一用户总数。
活跃用户 - 在所选时间段内至少向 JetBrains AI 发起过一次请求的唯一用户总数。
获取用户与采用情况指标
要获取 AI 功能采用情况指标，包括在指定时间段内唯一启用与活跃用户数：
调用
GET /api/analytics/ai/users-adoption并填写以下参数：fromDate- 时间范围的开始日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。toDate- 时间范围的结束日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。groupBy- 用于分组指标的时间粒度。 可能的取值：DAY、WEEK、MONTH、YEAR。profileId（可选）- 获取指定用户画像指标所用的画像 ID。
每个用户在每个分组时间段内仅统计一次。 例如，如果某用户分别于 1 月 15 日和 1 月 26 日发起请求，则该用户在按月分组的 1 月指标中只统计一次。
AI 活动与影响
IDE 和插件版本要求
数据来自 IDE 及 IDE 内的插件。 这些数据包括生成的代码建议及其被接受或拒绝的信息，以及与 AI 工具和功能的交互次数。 IDE 和插件需满足以下版本要求，方可提供这些数据：
IDE 版本 2025.3.0 或更高版本
AI Assistant 版本 2025.3.0 或更高版本
Junie 版本 253.487.77 或更高版本
旧版 IDE 与插件不会发送该分析段所需的数据。 版本仅部分满足要求时，AI 活动与影响不会包含所有 AI 工具和功能的数据。 例如，如 IDE 与 AI Assistant 版本已满足要求但 Junie 版本低于最低要求，则分析中不会包含 Junie 相关数据。
包含在指标中的 AI 工具和功能
Chat-based interactions (基于聊天的交互) ：与 AI 模型和编码代理的聊天交互相关的数据。 指标包括下述工具中操作相关的数据：
Junie ，在 Code (代码) 模式下使用时。
Claude Agent ，由 Anthropic 提供的第三方编码代理，并已集成至 AI Assistant。
AI Assistant ，用于以 Chat (聊天) 模式发送的消息。
In-editor interactions (编辑器内交互) ：由以下功能在编辑器内生成的代码建议：
获取 AI 活动与影响指标
获取汇总的 AI 活动与影响指标
检索在指定时间段内 AI 工具的聚合活动与影响指标，包括建议、接受和调用次数。 当选择多个工具时，此端点会将所有工具的指标在每个时间段合并为一组数据。
要检索指定时间段内的活动与影响数据：
调用
GET /api/analytics/ai/effectiveness/metrics并填写以下参数：fromDate- 时间范围的开始日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。toDate- 时间范围的结束日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。groupBy（可选）- 用于分组指标的时间粒度。 可能的取值：DAY、WEEK、MONTH、YEAR。tool（可选）- 以逗号分隔的工具列表用于筛选。 可能的取值：junie、aia、claude_code、code_completion、nes。
按功能获取 AI 活动与影响指标
检索按单项功能拆分的活动与影响指标，包括每个工具的建议、接受和调用次数。 该端点将在响应中为每个工具保留独立指标。
要按功能检索活动与影响指标：
调用
GET /api/analytics/ai/effectiveness/metrics-by-feature并填写以下参数：fromDate- 时间范围的开始日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。toDate- 时间范围的结束日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。groupBy（可选）- 用于分组指标的时间粒度。 可能的取值：DAY、WEEK、MONTH、YEAR。tool（可选）- 以逗号分隔的工具列表用于筛选。 可能的取值：junie、aia、claude_code、code_completion、nes。
获取 AI 活动与影响总指标
检索整个指定时间段的聚合活动与影响指标，不按时间分组。 该端点会为范围内所有日期提供单一的指标汇总。
要获取总活动与影响指标：
调用
GET /api/analytics/ai/effectiveness/metrics/totals并填写以下参数：fromDate- 时间范围的开始日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。toDate- 时间范围的结束日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。tool（可选）- 以逗号分隔的工具列表用于筛选。 可能的取值：junie、aia、claude_code、code_completion、nes。
获取按用户分的 AI 活动与影响指标
按用户获取指标，支持基于游标的分页。 每条记录代表某个用户、日期和工具组合的指标数据。 结果包含用户信息（姓名和邮箱），以及其在指定工具下的每日指标。
要获取按用户分的 AI 活动与影响指标：
调用
GET /api/analytics/ai/effectiveness/metrics/users.paged并填写以下参数：fromDate- 时间范围的开始日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。toDate- 时间范围的结束日期（包含），使用 ISO 日期格式（YYYY-MM-DD）。tool（可选）- 以逗号分隔的工具列表用于筛选。如果未指定，包含所有工具。 如果未指定，包含所有工具。 可能的取值：junie、aia、claude_code、code_completion、nes。query（可选）- 以逗号分隔的用户 UUID 用于筛选指定用户。 如果未指定，包含所有用户。cursor（可选）- 用于分页的游标字符串。 取自上一个响应的nextCursor。 如未填写，返回第一页。limit（可选）- 每页记录数。 必须介于 1 到 1000 之间。 默认值为 50。sortOrder（可选）- 结果排序方式。 可能的值：ASC、DESC。 默认值为ASC。 结果按工具、日期和用户 ID 排序。