从 Agentic CLI customizations now in the usage metrics API 的官方信息进行确认

PowerShellカテゴリを表すパンダのイラスト PowerShell
2026.10.05

本文是使用AI创建的技术说明与实现示例。所发布的代码和步骤基于一手信息构建，但作者并未在实际设备上进行运行验证。根据环境和版本的不同，运行结果可能会有所差异。

用于掌握 GitHub Copilot 使用情况的 Usage Metrics API 中，已追加了关于 Agentic CLI customizations（智能体式 CLI 自定义功能）的新报告范围。本文将整理从官方更新日志（Changelog）中解读出的规格、追加的指标以及提供报告的期限和权限要求。

通过本文，将简要阐述组织或企业管理员安全且实用地掌握 Copilot CLI 自定义使用情况的前置知识，以及使用 API 时的注意事项。

1. 目的与本文涉及范围

本文的目的是根据 GitHub 官方更新日志“Agentic CLI customizations now in the usage metrics API”，准确解读新增功能的组成要素和报告规格。

由于【尚未进行实机验证】，本文无法进行实际的 API 请求或使用 PowerShell 等获取各环境的输出结果，因此重点在于整理官方的规格说明。

2. 前提与注意事项

一手信息中记载了，若要使用 Usage Metrics API 确认自定义 CLI 的使用情况，需要满足以下角色、权限并启用相关策略。

  • 目标角色: 企业所有者、账单管理员、组织所有者，或者拥有被授予 View Copilot Metrics 权限的自定义组织和企业角色的用户

  • 前提条件: 必须启用 Copilot usage metrics 策略

  • 隐私保护规格: 为了保护隐私，不会显示用户自定义的名称，仅显示识别出的 GitHub 提供的项目名称。

    • 技能、自定义智能体、MCP 服务器和插件将归类在 other 标签下。

    • 关于自定义斜杠命令，其行为与传统的 Copilot CLI 遥测行为相同，将使用 custom 标签。

3. 追加的指标种类与规格

官方信息显示，本次更新添加了技能（skills）、自定义代理（custom agents）、Model Context Protocol（MCP）服务器、斜杠命令（slash commands）和插件（plugins）的活动指标。

这些字段将出现在企业和组织的“每日报告（per-user 和 aggregate）”、“每 28 天报告（per-user）”以及每 28 天汇总报告的 day_totals 条目中。

报告主要回答以下两个问题：

  1. 哪些项目使用频率最高？

  2. 使用了多少种不同的项目？

4. 用于识别高频使用项目的数组字段

为了了解高频使用的项目，准备了以下数组字段。它们列出了活动记录最多的前 5 个项目，并且每个项目都包含 interaction_count。

  • totals_by_skill

  • totals_by_custom_agent

  • totals_by_mcp

  • totals_by_slash_cmd

  • totals_by_plugin

交互次数的计数规范

根据类别定义了 interaction_count 所统计的内容。

  • 技能、斜杠命令和插件技能: 计算各自的调用（invocations）次数。

  • 自定义代理: 计算启动（starts）次数。

  • MCP 服务器: 计算 Copilot CLI 尝试连接或重新连接到服务器的次数。成功和失败的尝试都将计入统计。从同一个已连接的服务器调用多个工具不会增加此计数。

  • 插件: 计算插件包含的技能的调用次数。

5. 独立使用计数（Distinct Counts）

为了解使用了多少种不同的项目，提供了以下独立计数统计字段：

  • distinct_skill_use_count

  • distinct_custom_agent_use_count

  • distinct_mcp_use_count

  • distinct_slash_cmd_use_count

  • distinct_plugin_use_count

报告分类

  • 用户报告: 按单个用户维度进行统计

  • 聚合报告: 汇总整体使用情况

6. 注意事项与字段缺失时的表现

在使用 API 获取数据时需要注意以下几点：

  • 若对应期间内没有使用记录，相关字段可能会返回 null 或省略不显示。

  • 由于插件指标是技能指标的一个子集，因此不能进行简单的数值相加。

7. 总结

通过 GitHub Changelog 中关于 Agentic CLI customizations 在 Usage Metrics API 中的更新，要点如下：

  • 权限要求:

    • 需要企业所有者、账单管理员、组织所有者权限

    • 或者被授予 View Copilot Metrics 权限的自定义角色

  • 核心要点:

    • 为了保护隐私，用户自定义的名称不会显示，而是被分组为 other 和 custom。

    • 由于插件指标是技能指标的一个子集，因此不能进行简单相加。

    • MCP 服务器的交互次数是指连接尝试次数，而不是工具调用次数。

    • 由于【实机验证前】，本文未展示实际的 API 响应 JSON 结构及 PowerShell 获取结果。如需详细的架构确认，请参考官方的 Copilot usage metrics API 文档。

参考信息

この記事の更新履歴

この記事は、生成AIを活用した自動レビュー・更新フローにより内容を見直し、必要な修正を反映しています。

2026年10月6日

  • 変更修复了第4章中插件部分损坏的乱码文字。
  • 変更修复了第5章中关于总数和不同项目计数说明的乱码文本。
  • 変更修复了第6章中由于乱码导致的截断与不完整段落。
  • 変更修复了第7章总结部分的乱码与未完成的表述。

文档信息

文章??
从 Agentic CLI customizations now in the usage metrics API 的官方信息进行确认
?布日期
更新日期
来源
https://papanda925.com/?p=17856&lang=zh

?可: ?于本站?有相??利的正文及原??表，除非?有?明，可依据 CC BY 4.0 使用。本文可能包含使用生成式AI?建或??的内容。若代??有?可声明，或?接的GitHub???定了?可，?代?以??可?准。引用内容、第三方?料、?片及商?不在本?可范?内。 使用政策

标题和URL已复制