PuppyIP 资源中心
AI 企业管理动态 6 分钟 发布于 2026-11-04

Copilot用量API区分BYOK与企业自定义模型:别重复加总,也别把缺报当零

Copilot现在能在用量报告里区分开发者自行配置的BYOK和管理员配置的企业自定义模型。新增分类已经包含在原总量内,不能再加一遍;本地遥测不完整时,少报也不等于没有使用。管理员应先确认请求经过哪条路径,再核字段、报表日期和权限。

GitHub Copilot BYOK 用量API 企业自定义模型

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • GitHub 2026年11月3日公告称,两类分类已进入企业和组织的用户级、汇总级报告,覆盖1日及28日报告。
  • 本地BYOK从Copilot CLI或Copilot应用直接访问开发者的提供商或本地模型;企业自定义模型经GitHub路由,不能仅凭相同模型名合并。
  • 新增本地分类是totals_by_cli和totals_by_copilot_app的子集;企业自定义模型本来就在totals_by_client内,原总量不变。
  • 本地遥测关闭或提供商不报告token时会少报;11月3日发布前的报表日不会回填is_custom_enterprise_model。

先分清两条BYOK路径,再解释用量

BYOK是“自带密钥”(bring your own key)的缩写,本文中的本地BYOK报表分类也包括本地模型。GitHub此次区分两类路径:本地BYOK由开发者在客户端配置,请求从Copilot CLI或Copilot应用直接发往自己的提供商或本地模型;企业自定义模型由管理员在GitHub设置中配置,请求经过GitHub转发给提供商。

这里的“本地BYOK”是报表分类,不保证推理发生在本机。它也包括使用开发者自己的远程提供商密钥。相反,企业自定义模型由GitHub服务端观察,新增标记覆盖各客户端,包括IDE。

这是报告可见性的改进,不是新的免费额度或模型开放公告。原文没有提供完整国家、费用或资格表,不能据此推定任何账户都能启用某个模型或免除提供商费用。

本地BYOK看哪些字段?

用户级报告中的used_local_byok表示该用户当天是否至少在Copilot CLI或Copilot应用发出一次本地BYOK请求。totals_by_local_byok同时出现在用户级和汇总级报告,记录会话、请求、提示及token数量。

totals_by_local_byok按byok_kind区分local_managed、local_user、local_auto和remote_user,并按surface区分copilot_cli与copilot_app。字段值应按官方定义保留,不能把它们改名后当作新的计费产品。

汇总报告还提供daily_active_local_byok_users、weekly_active_local_byok_users和monthly_active_local_byok_users。它们分别统计日、自然周和自然月内去重的活跃用户,不是三个可以直接相加的独立人群,也不能把自然月人数当作28天人数。

企业自定义模型怎样与托管模型分开?

在totals_by_client[].totals_by_model[]的每条模型记录上,is_custom_enterprise_model为true表示请求使用了组织或企业配置的自定义模型。GitHub称这些记录包含实际请求和token数量。

同一个模型既通过Copilot托管服务使用,又作为企业自定义模型使用时,会出现两条独立记录。整理报告时保留这个布尔字段和客户端维度,不能只按显示模型名合并,否则会再次混淆两条路径。

自定义模型用量已经包含在totals_by_client里。本地BYOK用量也已经包含在totals_by_cli和totals_by_copilot_app里;新增分类只是拆分原总量,没有凭空增加另一份用量。

为什么不能用少报的本地数据断言没人使用?

本地BYOK字段依赖客户端遥测,即客户端向统计系统报告的使用记录。关闭遥测时会少报;有些本地提供商不返回token数量,也会使token统计偏低。这类数值应按可见下限解释,不能作为完整使用量或零使用的证明。

企业自定义模型由GitHub服务端观察,官方说明它不受上述本地遥测限制。仍要保留报告自己的日期、范围和权限条件,不能因此宣布所有报表没有任何缺失。

假设同一份报告显示CLI总请求100次,其中本地BYOK 30次,不能写成总请求130次。这只是说明子集关系的假设例子,不是PuppyIP或任何客户的实测数据;请求数和token数也不能直接换算成账单金额。

旧报表缺标记,先看日期与访问条件

GitHub明确说,发布前的报表日不会补上is_custom_enterprise_model。因此,历史记录里没有这个字段,不等于字段值为false,也不证明当时没有自定义模型请求。跨发布日比较时,单独标记可用字段的变化。

访问还要求启用Copilot用量统计策略,以及相应角色或权限。公告列出企业所有者、企业账单管理员、组织所有者及获得View Copilot Metrics权限的自定义角色;REST文档进一步按企业、组织和端点区分具体读取权限。

REST文档要求企业的Copilot usage metrics策略设为Enabled everywhere。报告端点返回有时效的下载链接,并不直接把所有用量明细放进端点响应。应由已有权限的管理员按端点文档读取;不要把下载链接、密钥或用户级明细发到公开讨论。

管理员怎样把这次变化纳入现有复盘?

先确认需要分析的是本地BYOK、企业自定义模型,还是Copilot托管请求。再固定企业或组织、用户级或汇总级、1日或28日等报表范围,并保留实际报告日;不要把重叠窗口相加。

随后在原总量旁展示子集,将缺失字段、本地遥测限制及发布前后边界单独注明。需要解释费用时,再对照适用账单和提供商规则;用量分类本身不替代账单、模型权限或企业使用政策。

本文只核对公开公告及REST文档,没有访问私人用量API、下载实际组织报告或变更任何统计设置。上线可见的字段,也不能证明某个团队已经采用BYOK、降低成本或完成合规审查。

资料来源

常见问题

能从报告里查到开发者使用的每个本地模型名称吗?

不能据此次更新这样期待。GitHub说明,本地BYOK不按模型名拆分;企业自定义模型沿用现有名称标准化规则,未识别名称可能显示为unknown。unknown是名称归一化结果,不能直接当作未知提供商、恶意请求或没有使用。

latest的28日报告为什么不一定包含今天?

REST文档定义的最新28日报告,以最近已处理完成的数据日为结束日,并由响应提供实际起止日期。latest不是实时监控保证;先读报告日期,不要用页面访问日替代数据截至日,也不要把尚未处理的当天记成零。