使用 Copilot 云代理创建自动化

创建和管理 automations，以按计划、响应存储库中的事件或通过 API 以编程方式运行 Copilot cloud agent。

谁可以使用此功能？

Automations可用于GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Max、GitHub Copilot Business和GitHub Copilot Enterprise计划。 Automations 仅在专用存储库和内部存储库中可用。 在已被存储库管理员禁用、由 托管用户帐户 拥有的存储库中，或在未启用 Copilot cloud agent 的存储库中，它们不可用。
Sign up for Copilot

在本文中

Introduction

使用 automations，可以设置 Copilot cloud agent 自动运行，可按计划执行、响应存储库中的事件，或通过 API 触发。 Automations 可以在其配置所在的仓库中执行操作，例如发起拉取请求或为议题添加标签。

可以从 automations 上存储库的“智能体”**** 选项卡中创建和管理 GitHub。

还可以通过以下方法创建和管理 automations ：

  • 位于 GitHub Copilot app 中的 Automations 选项卡
  • VS Code 中的 “代理” 窗口
  • REST API

有关触发器、工具、可见性和安全性的概述 automations，请参阅 Copilot自动化。

先决条件

若要 automations 在存储库中可用，以下所有内容都必须为 true：

  • 存储库必须是 专用存储库或内部存储库。 Automations 在公共存储库中不可用。
  • 必须为该存储库启用 Copilot cloud agent。 如果您拥有 Copilot Business 或 Copilot Enterprise，则管理员必须启用 Copilot cloud agent 策略。 请参阅“为企业或组织管理云中的GitHub Copilot”。
  • 组织必须在存储库中同时允许 Copilot cloud agent 和 automations（二者默认均处于启用状态）。 请参阅“在云中管理组织的GitHub Copilot”。

Automations可用于GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Max、GitHub Copilot Business和GitHub Copilot Enterprise计划。

在VS Code中启用云automations

若要使用来自automations的云VS Code，请完成上述存储库先决条件，然后：

  1. 更新到 VS Code 1.144 或更高版本。
  2. 在“设置”编辑器中，启用 chat.automations.cloud.enabled。
  3. 打开 “代理 ”窗口，然后选择 Automations 选项卡。

有关创建和管理的说明，请参阅文档中的VS Code。

创建 automation

警告

由 Copilot cloud agent 启动的 automation 会话对其他有权访问该存储库的人可见。 不要在提示中包含机密或其他敏感信息。 若要授予 Copilot 对敏感值的访问权限，请使用存储库机密。 请参阅“为 Copilot 云代理配置机密和变量”。

  1. 在 GitHub 上，导航到存储库的主页面。
  2. 在存储库名称下，单击 智能体。
  3. 在边栏中，单击 Automations。
  4. 单击“ 创建 automation”。
  5. 单击借助代理创建，与Copilot协作来创建你的automations，或手动创建，通过表单设置automations。

使用 Copilot 创建automation

单击“使用代理创建”后，将显示聊天窗口，并且Copilot会询问要自动执行哪些操作。

可以与 Copilot 协作来设计 automation，设置触发器、工具和提示。

Copilot 甚至可以帮助你创建由 automations 组成的自我改进组，这些组会从结果中学习，并提出自我改进建议。

手动创建automation

  1. 为**** 输入automation。

  2. 在 “类型” 下，选择要创建的 automation 类型：

    • 个人：只有你才能看到automation。 AI credits 会向你收费，并且在 GitHub 上采取的操作将使用你的身份。
    • 共享：有权访问存储库的每个人都可以看到 automation。 AI credits 的费用由拥有存储库的组织或用户承担，并且在 GitHub 上执行的操作使用 Copilot 的身份。

    创建后 automation无法更改类型。 请参阅“Copilot自动化”。

  3. 选择一个或多个 触发器 ，确定 automation 何时运行。 可以选择配置筛选器，以控制触发器何时触发。

    对于问题和拉取请求触发器，可以选择：

    • 运行期间可以更新哪些资源GitHub。 在 “已配置的工具可更改的内容” 下拉列表中，选择 此存储库中的任何内容，让 GitHub 工具创建和更新存储库中的任何资源。 选择 “仅此问题” 以限制这些工具对触发运行的问题或拉取请求的写入操作，以及对运行期间创建的任何资源的写入操作。 此设置不会限制 MCP 服务器中的工具，这些工具可以访问其服务器配置和凭据允许的资源。 根据存储库配置，此存储库中的任何内容选项可能不可用。
    • 云中的 Copilot 活动是否可以触发此 automation：在Copilot下拉列表中，选择Copilot，以忽略由 **** 触发的事件，包括 automations。 选择 任意项 以侦听所有事件，包括由 Copilot 触发的事件。
    • 仅具有存储库读取访问权限的用户是否可以触发此automation操作：默认情况下，automations忽略对存储库没有写入访问权限的用户的活动。 取消选中 忽略由对该仓库没有写入权限的用户触发的事件 复选框，以接收这些事件。 根据存储库配置，忽略由对该存储库没有写入权限的用户触发的事件选项可能被锁定为启用状态。

  4. 在 提示 字段中，描述每次运行时要 Copilot 执行 automation 的任务。

    例如： Label this issue as a bug, an enhancement, or other, based on its content.

  5. （可选）选择您希望**** 使用的Copilot和推理级别。 请参阅“更改 GitHub Copilot 云代理的 AI 模型”。

  6. 选择在 **** 运行时可使用的Copilotautomation，例如推送更改、更新问题标签或创建拉取请求。

    可以选择 GitHub 工具，以及在存储库的 MCP 设置中配置的任何 MCP 服务器中的工具。 若要使外部系统的工具可用，存储库管理员必须先为存储库配置其 MCP 服务器。 请参阅“为存储库配置 MCP 服务器”。

    仅选择任务所需的工具。 您选择的工具决定了 Copilot 在您的存储库中可以执行哪些操作。 （可选）可以使用“ 建议工具 ”按钮根据提示询问 Copilot 建议工具。 请参阅“Copilot自动化”。

  7. （可选）在 AI 额度限制下，设置 automation 可消耗多少 AI credits 的限制。 请参阅 “设置限制AI credits”。

  8. 单击“automation”保存。****

设置AI credits限制

每次 automation 运行时，它都会消耗 AI credits，这些费用会向你收取（针对个人 automation），或者向共享 automation 的存储库所有者收取。 若要控制成本，可以在创建或编辑**** 时，在automation部分设置限制。

可以在 AI credits 中设置以下可选限制。 如果不想设置限制，请将限制留空。

  • 每次运行：一旦达到限制，就会停止此次运行。 最小值为 30 AI credits。
  • 每日：防止在达到限制后启动新的运行。 每天在 00：00 UTC 重置。
  • 每周：阻止新运行在达到限制后启动。 每周一 00：00 UTC 重置一次。
  • 每月：防止新运行在达到限制后启动。 于每月第一天 00:00 UTC 重置。

每日、每周和每月限制不会停止正在进行的运行。 若要限制每个运行的成本，请设置每次运行上限。

若要删除限制，请编辑 automation 并清除值。

测试 automation。

可以立即运行一个 automation ，而无需等待其触发器触发，以检查它是否按预期运行。

  1. automation从Automations 窗格中打开要测试的控件。

  2. 单击“运行”按钮。****

  3. 从 “触发器” 下拉列表中，选择要模拟的触发器。

  4. 如果选择了 手动 触发器，可选择输入 上下文，该内容将包含在代理提示中。 可以使用此方法通过 API 模拟触发 automation。

    如果选择了另一个触发器，请使用相关资源填写 资源 URL，例如，已打开的问题的 URL 或已创建的拉取请求评论。

  5. 单击“立即运行”。

Copilot 启动一个 Copilot cloud agent 会话，并使用所选工具运行 automation 的提示。 可以打开会话以跟踪其进度并查看其所做的任何更改。

管理你的 Automations

你的个人 automations 仅你可见。 共享的 automations 对存储库具有读取访问权限的每个人都可见，具有写入访问权限的任何人都可以编辑它们。

从任何 automation 启动的会话对具有存储库读取权限的所有人都可见。

在存储库中的 Automations 窗格中，您可以：

  • 查看个人 automations 和存储库的共享 automations、其已启动的会话以及其已使用的 AI credits。
  • 编辑 automation 以更改其名称、提示、触发器、工具、模型、推理或 AI credits 限制，并跟踪 automation 的修订历史记录。
  • 查看由 automation 自身或其他 automation 提出的对 automations 的工具、触发器或提示的建议改进。
  • 禁用 automation 以使其停止运行，或稍后重新启用它。
  • 删除不再需要的项 automation 。

若要查看每个存储库中的所有 automations 内容，并导航到管理每个存储库，请使用 Automations 用户级别的视图。

延伸阅读