# 衡量GitHub Copilot试用的成功

通过使用Copilot使用指标分析采用情况、参与度和早期使用模式，来衡量Copilot试用的成功。

运行 Copilot 试用版时，成功的关键在于了解团队如何采用和使用 Copilot。
通过结合使用情况指标仪表板和 API 中的 Copilot 见解，可以评估早期结果、确定启用需求并确定是否扩展推出。

本教程演示如何：

1. 定义明确的试用目标和成功标准。
2. 在仪表板中查看和解释采用和参与数据。
3. 评估试用结果。
4. 纳入开发人员的定性反馈。
5. 通过 Copilot 使用情况指标 API 扩展评估。
6. 决定是否扩大推行。

## 步骤 1：定义试用目标

在分析指标之前，请确定确保组织成功的试验结果。 设置明确的目标可以更轻松地解释结果并向利益干系人传达价值。

| 示例目标     | 成功的样子是怎样的                    | 相关指标                           |
| :------- | :--------------------------- | :----------------------------- |
| 收养       | 大多数许可的开发人员会定期激活和使用 Copilot 。 | 活动用户总数、每日活跃用户（DAU）、每周活动用户（WAU） |
| 参与       | 开发人员探索多个功能和模式。               | 每个聊天功能的请求数，代理使用情况              |
| 工作效率和满意度 | 开发人员表示效率提升，并且信任建议。           | 验收率、内部反馈、满意度调查                 |
| 赋能效果     | 团队了解如何以及何时使用 Copilot。        | 跨语言和 IDE 的用法广度                 |

## 步骤 2：在仪表板中查看采用和参与指标

1. 导航到您的企业。 例如，从 GitHub.com 上的 [公司](https://github.com/settings/enterprises?ref_product=ghec\&ref_type=engagement\&ref_style=text) 页面。
2. 单击“见解”\*\*\*\* 选项卡。

仪表板显示所有许可用户的 28 天聚合 IDE 遥测数据。 在试用期间专注于这些 **关键指标** ：

| 指标          | 它显示的内容                       | 为什么它很重要                       |
| :---------- | :--------------------------- | :---------------------------- |
| 活动用户总数      | 在试用期间至少使用 Copilot 过一次的开发人员数。 | 指示许可证激活和总体覆盖范围。               |
| 每日活跃用户（DAU） | 每天活动的唯一用户数。                  | 揭示早期采用趋势 -- 兴趣是增长、稳定还是下降。     |
| 代理采用        | 使用了 Copilot agent 的活跃用户百分比。  | 显示超出基本完成功能的参与度和探索深度。          |
| 接受率         | 已接受的 Copilot 建议百分比。          | 反映相关性和信任 — 价值和用户满意度的关键指标。     |
| 语言和模型用法     | 使用的编程语言和模型的分布。               | 帮助确定 Copilot 在跨团队协作中何处最能发挥价值。 |

> \[!NOTE]
> Copilot 使用情况指标主要反映受支持 IDE 中的活动。 服务器端遥测对客户端 IDE 遥测进行补充，以显示其他活动用户。 在 Copilot Chat、GitHub.com、GitHub Mobile 或 Copilot code review 上的 Copilot CLI 使用情况不包含在仪表板数据中。

> \[!TIP]
> 活动用户和 DAU 总数显示开发人员是否正在使用 Copilot ，但并不显示其深度。 有关反映试用使用是否随时间逐步深入的信号，例如开发人员逐步从补全功能过渡到代理工作流，请参阅 [查看 Copilot 影响力仪表板](/zh/enterprise-cloud@latest/copilot/how-tos/administer-copilot/view-impact-dashboard)。

## 步骤 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 存储下载报告文件，并说明文件涵盖的报告期限。

示例响应：

```json
{
  "download_links": [
    "https://example.com/copilot-usage-report.ndjson"
  ],
  "report_start_day": "2025-07-18",
  "report_end_day": "2025-08-14"
}
```

有关完整的字段定义，请参阅 [GitHub Copilot 使用情况指标](/zh/enterprise-cloud@latest/copilot/reference/copilot-usage-metrics)。

### 自动化您的报告

若要自动执行报告，可以设置计划作业以定期（例如每日或每周）调用 API，并将结果存储在数据库或data warehouse以供进一步分析。 这样，就可以跟踪一段时间内的趋势，并根据需要生成自定义报表。

## 步骤 6：决定是否展开推出

使用仪表板和 API 数据中的发现做出有关扩展 Copilot 使用情况的明智决策。

| 决策区域 | 应考虑的问题                                 | 支持指标              |
| :--- | :------------------------------------- | :---------------- |
| 收养   | 大多数试用用户是否处于活动状态？ 他们是否继续一致地使用 Copilot ？ | 活动用户总数、DAU、WAU    |
| 支持需求 | 团队是否需要更多指导或资源？                         | 跨语言或模型使用低或不一致     |
| 参与   | 开发人员是否正在探索基本完成功能以外的功能？                 | 代理使用情况、每项功能的聊天请求数 |
| 满意度  | 团队是否认为 Copilot 很有价值？                   | 接受率，来自调查的反馈       |

记录调查结果并与利益干系人共享，以告知下一阶段的推出情况。

## 后续步骤

现在，您已经了解如何衡量 Copilot 试用的成效，因此在逐步扩大使用范围时，您可以继续跟踪采用情况和参与度。 若要了解有关推动采用和启用开发人员的详细信息，请参阅 [推动您的公司采用GitHub Copilot](/zh/enterprise-cloud@latest/copilot/tutorials/roll-out-at-scale/enable-developers/drive-adoption)。 若要跟踪使用深度，并在试用期后扩大使用规模时将支出与拉取请求产出关联起来，请参阅 [查看 Copilot 影响力仪表板](/zh/enterprise-cloud@latest/copilot/how-tos/administer-copilot/view-impact-dashboard)。