运行 Copilot 试用版时,成功的关键在于了解团队是如何采用和使用 Copilot 的。 通过结合 Copilot 使用情况指标仪表板和 API 中的见解,可以评估早期结果、确定启用需求并确定是否扩大推出区域。
本教程演示如何:
- 定义明确的试用目标和成功标准。
- 在仪表板中查看和解释采用和参与数据。
- 评估试用结果。
- 纳入开发人员的定性反馈。
- 通过 Copilot 使用情况指标 API 拓展你的评估。
- 决定是否扩大推行。
步骤 1:定义试用目标
在分析指标之前,请确定确保组织成功的试验结果。 设置明确的目标可以更轻松地解释结果并向利益干系人传达价值。
| 示例目标 | 成功的样子是怎样的 | 相关指标 |
|---|---|---|
| 收养 | 大多数持证开发人员会定期激活和使用 Copilot。 | 活动用户总数、每日活跃用户(DAU)、每周活动用户(WAU) |
| 参与 | 开发人员探索多个功能和模式。 | 每个聊天功能的请求数,代理使用情况 |
| 工作效率和满意度 | 开发人员表示效率提升,并且信任建议。 | 验收率、内部反馈、满意度调查 |
| 赋能效果 | 团队了解如何以及何时使用 Copilot。 | 跨语言和 IDE 的用法广度 |
步骤 2:在仪表板中查看采用和参与指标
- 单击“见解”**** 选项卡。
仪表板显示所有许可用户的 28 天聚合 IDE 遥测数据。 在试用期间专注于这些 关键指标 :
| 指标 | 它显示的内容 | 为什么它很重要 |
|---|---|---|
| 活动用户总数 | 试用期间至少使用过 Copilot 一次的开发人员人数。 | 指示许可证激活和总体覆盖范围。 |
| 每日活跃用户(DAU) | 每天活动的唯一用户数。 | 揭示早期采用趋势 -- 兴趣是增长、稳定还是下降。 |
| 代理采用 | 使用过 Copilot 代理 的活跃用户所占百分比。 | 显示超出基本完成功能的参与度和探索深度。 |
| 接受率 | 接受的 Copilot 建议所占百分比。 | 反映相关性和信任 — 价值和用户满意度的关键指标。 |
| 语言和模型用法 | 使用的编程语言和模型的分布。 | 帮助识别 Copilot 在各个团队中带来最大价值的领域。 |
注意
Copilot 使用指标仅反映受支持 IDE 中的活动。 GitHub.com、GitHub Mobile、Copilot代码审查或Copilot 命令行界面(CLI)上的Copilot对话中的使用情况不包括在仪表板数据中。
步骤 3:评估试用结果
将仪表板数据与试用目标进行比较。 常见成功指标包括:
| 目标 | 要度量的内容 | 成功的迹象 |
|---|---|---|
| 许可证激活 | 活动用户总数 | 试用许可证的 70-90% 在第一个月内显示使用情况。 |
| 持续参与 | 每日和每周活动用户 | DAU 和 WAU 在一段时间内稳定或增加。 |
| 使用情况的广度 | 每个聊天功能的请求数、语言用法 | 用户跨多种语言和功能进行试验。 |
| 使用深度 | 代理采用率、接受率 | 开发人员正在探索高级Copilot功能。 |
| 积极反馈 | 团队调查或内部反馈 | 开发人员报告工作效率提升或工作流改进。 |
如果未满足一个或多个目标,请考虑在扩展推出之前是否需要增加资源支持、加强沟通或调整 IDE 配置。
步骤 4:合并定性反馈
虽然采用和参与度是量化的,但满意度指标可帮助你了解感知的价值和开发人员情绪。 请考虑将 GitHub 外部的以下反馈源合并到分析中。
| 来源 | Description |
|---|---|
| Copilot 满意度调查 | 开发人员关于有用性、信任和工作效率的定期反馈。 |
| 内部反馈渠道 | 围绕工作流变化和感知到的效率提升开展的团队回顾会议或脉搏调查。 |
| 技术支持趋势 | 更少的“我该如何…” 随着时间的推移,问题往往表明信心和满意度增加。 |
将使用情况指标与开发人员反馈相结合可以展现 Copilot 影响的全貌。
步骤 5:通过 Copilot 使用情况指标 API 拓展你的评估
试用期过后,可以通过 Copilot 使用情况指标 API 继续监视采用和参与度。 API 可让你更好地控制所收集的数据以及分析数据的频率。
检索企业范围数据
可以使用 Copilot 使用情况指标端点下载企业 28 天的使用情况报告。 这些报告包含在 Copilot 使用情况指标仪表板中显示的相同数据集。 API 提供两个终结点。
| 端点 | Description |
|---|---|
GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-28-day/latest | 返回最新 28 天 企业级 使用情况报告的已签名下载链接。 |
GET /enterprises/{enterprise}/copilot/metrics/reports/users-28-day/latest | 返回最新 28 天 用户级 使用情况报告的已签名下载链接。 |
每个终结点响应包含具有时间限制的签名URL,用于从Azure Blob Storage下载报告文件,并说明文件涵盖的报告期限。
示例响应:
{
"download_links": [
"https://example.com/copilot-usage-report.json"
],
"report_start_day": "2025-07-18",
"report_end_day": "2025-08-14"
}
有关完整的字段定义,请参阅 GitHub Copilot 使用情况指标。
自动化您的报告
若要自动执行报告,可以设置计划作业以定期(例如每日或每周)调用 API,并将结果存储在数据库或data warehouse以供进一步分析。 这样,就可以跟踪一段时间内的趋势,并根据需要生成自定义报表。
步骤 6:决定是否展开推出
使用来自仪表板和 API 数据的发现,针对扩展 Copilot 的使用做出明智的决策。
| 决策区域 | 应考虑的问题 | 支持指标 |
|---|---|---|
| 收养 | 大多数试用用户是否处于活动状态? 他们是否持续一致地使用 Copilot? | 活动用户总数、DAU、WAU |
| 支持需求 | 团队是否需要更多指导或资源? | 跨语言或模型使用低或不一致 |
| 参与 | 开发人员是否正在探索基本完成功能以外的功能? | 代理使用情况、每项功能的聊天请求数 |
| 满意度 | 团队是否认为 Copilot 有价值? | 接受率,来自调查的反馈 |
记录调查结果并与利益干系人共享,以告知下一阶段的推出情况。
后续步骤
现在你已经了解如何衡量 Copilot 试用的成效,可以在扩大使用范围的同时持续监控采用情况和用户参与度。 若要了解有关推动采用和启用开发人员的详细信息,请参阅 推动您的公司采用GitHub Copilot。