Skip to main content
Skip to content

管理使用贵组织 Copilot 的 GitHub 应用

控制哪些 GitHub Apps 可以使用您组织的 Copilot,并将其支出归属到相应对象。

谁可以使用此功能?

Organization owners

Copilot Enterprise or Copilot Business

注意

使用组织安装访问令牌对 Copilot 进行身份验证处于 公开预览 阶段,且可能会发生变化。

在组织上安装的 GitHub App 安装可以使用其自己的安装访问令牌发出 Copilot 请求,而无需用户登录。 拥有该安装实例的组织为使用付费。

了解访问和计费

应用必须将组织 Copilot 请求 权限设置为 只读。 在此上下文中, 只读 并不意味着应用不会产生费用。 该权限授权应用发出消耗贵组织的AI credits的请求。

此身份验证方法具有以下限制:

  • 它适用于已安装到组织的应用。 个人帐户和企业安装不能使用此身份验证方法。
  • 应用只能使用组织策略允许的 Copilot 模型。
  • 您的组织的计费和支出控制适用。 不能为单个应用或安装项创建预算。
  • 无需启用 允许使用由组织计费的 Copilot CLI 策略。 该策略适用于不同的身份验证路径。

此方法不同于用户授权,其中请求使用用户的标识,并根据该用户 Copilot 的访问权限归因于该用户。 它也不同于GitHub Actions,其中工作流使用内置的GITHUB_TOKEN和GitHub Actions特定策略和预算。

在批准访问之前查看应用

仅批准你信任可使用你组织的 Copilot 用量的应用。

  1. 与请求访问权限的团队确认应用的所有者、用途和预期使用情况。
  2. 查看所有请求的组织和存储库权限。 确认 Copilot请求 是一个设置为 只读 的组织权限。
  3. 查看组织的模板策略和支出控制。 如果预算必须停止额外的使用,请确保在 达到预算限制时停止使用 。
  4. 安装应用或批准其更新的权限。

有关安装应用的说明,请参阅 从第三方途径安装 GitHub Apps。 如果已安装的应用添加了该权限,请参阅 批准 GitHub 应用的更新权限。

识别应用使用情况

应用归因在 CSV 导出中可用,不在 AI 使用情况 视图中提供 GitHub。

  1. 下载 AI 使用情况报告。 请参阅“查看按流量计费的产品和许可证的使用情况”。
  2. 在 organization 列中查找包含您的组织且在 app_client_id 列中具有值的行。
  3. 使用“列出组织的应用安装”REST API 终结点,并将报表中的app_client_id与响应中的client_id进行匹配。 app_slug 值标识应用。 请参阅“适用于组织的 REST API 终结点”。

对于归因于用户的使用情况、GitHub、其他app_client_id拥有的应用,以及在可提供应用归因之前的历史使用情况,GitHub Actions字段为空。 有关完整字段定义,请参阅 账单报告参考资料。

控制应用开支

组织安装的应用的 Copilot 使用情况会计入该组织的预算。 仅发送警报的预算限制不会阻止支出。 若要在达到限制后阻止请求,请启用达到预算限制时停止使用。

不能为一个应用或安装创建预算。 有关组织级别控件的详细信息,请参阅 基于使用情况的计费预算。

阻止应用访问

若要停止来自一个应用安装的请求,请为你的组织暂停或卸载它。 这还会阻止安装实例对其他组织资源的访问。 请参阅“查看和修改已安装GitHub应用”。