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
若要从VS Code使用云automations,请满足上述存储库先决条件,然后:
- 更新到 VS Code 1.144 或更高版本。
- 在“设置”编辑器中,启用
chat.automations.cloud.enabled。 - 打开 “代理 ”窗口,然后选择 Automations 选项卡。
有关创建和管理说明,请参阅VS Code文档中的创建和管理智能体自动化。
创建 automation
警告
由 Copilot cloud agent 启动的 automation 会话对其他有权访问该存储库的人可见。 不要在提示中包含机密或其他敏感信息。 若要授予 Copilot 对敏感值的访问权限,请使用存储库机密。 请参阅“为 Copilot 云代理配置机密和变量”。
- 在 GitHub 上,导航到存储库的主页面。
- 在存储库名称下,单击 智能体。
- 在边栏中,单击 Automations。
- 单击“ 创建 automation”。
- 单击使用智能体创建以与Copilot协作创建你的automations,或单击手动创建以使用表单设置automations。
使用Copilot创建automation
单击“使用代理创建”后,将显示聊天窗口,并且Copilot会询问要自动执行哪些操作。
可以与 Copilot 协作来设计 automation,设置触发器、工具和提示。
Copilot 甚至可以帮助你创建由 automations 组成的自我改进组,它们能够从结果中学习,并提出自我改进建议。
具有相同所有权的成员共享永久性项目存储,而对其他信息的访问权限取决于每个 automation成员的工具和权限。 请参阅 建议的改进。
手动创建automation
-
为**** 输入automation。
-
在类型下,选择你要创建的automation类型:
- 个人:只有你才能看到automation。 AI credits 的费用将计入你名下,并且在 GitHub 上采取的操作会使用你的身份。
- 共享:有权访问存储库的每个人都可以看到 automation。 AI credits 的费用由拥有存储库的组织或用户承担,并且在 GitHub 上执行的操作会使用 Copilot 的身份。
创建后 automation无法更改类型。 请参阅“Copilot自动化”。
-
选择一个或多个 触发器 ,确定 automation 何时运行。 你可以选择为触发器配置筛选器,以控制它们何时触发。
对于问题和拉取请求触发器,可以选择:
- 运行期间可以更新哪些资源GitHub。 在 “已配置的工具可更改的内容” 下拉列表中,选择 此存储库中的任何内容,让 GitHub 工具创建和更新存储库中的任何资源。 选择 “仅此问题” 以限制这些工具对触发运行的问题或拉取请求的写入操作,以及对运行期间创建的任何资源的写入操作。 此设置不会限制 MCP 服务器中的工具,这些工具可以访问其服务器配置和凭据允许的资源。 根据你的存储库配置,此存储库中的任何内容选项可能不可用。
- 云中的 Copilot 的活动是否可以触发此 automation:在Copilot下拉列表中,选择Copilot,以忽略由 **** 触发的事件,包括 automations。 选择 任意项 以侦听所有事件,包括由 Copilot 触发的事件。
- 仅具有存储库读取访问权限的用户是否可以触发此automation操作:默认情况下,automations会忽略对存储库没有写入访问权限的用户的活动。 取消选中忽略由对此存储库没有写入权限的用户触发的事件框,以侦听这些事件。 根据存储库配置,忽略由对该存储库没有写入权限的用户触发的事件选项可能被锁定为启用状态。
注意
由 GitHub Apps 创建的某些事件无法触发自动化。 无论应用的存储库权限如何,都会筛选出应用创作的标签、分配、关闭、评论和评审事件。 授予该应用写入权限并不会使该事件触发自动化。
-
在 提示 字段中,描述每次运行时要 Copilot 执行 automation 的任务。
例如:
Label this issue as a bug, an enhancement, or other, based on its content. -
(可选)选择您希望**** 使用的Copilot和推理级别。 请参阅“更改 GitHub Copilot 云代理的 AI 模型”。
-
选择 automation**** 在 Copilot 运行时可使用的工具,例如推送更改、更新问题标签或创建拉取请求。
可以选择 GitHub 工具,以及在存储库的 MCP 设置中配置的任何 MCP 服务器中的工具。 若要使外部系统的工具可用,存储库管理员必须先为存储库配置其 MCP 服务器。 请参阅“为存储库配置 MCP 服务器”。
仅选择任务所需的工具。 您选择的工具决定了 Copilot 在您的存储库中可以执行哪些操作。 (可选)可以使用“ 建议工具 ”按钮根据提示询问 Copilot 建议工具。 请参阅“Copilot自动化”。
-
(可选)在 AI 额度限制下,设置 automation 可消耗多少 AI credits 的限制。 请参阅设置AI credits限制。
-
单击“automation”保存。****
设置AI credits限制
每次automation运行时都会消耗AI credits;个人automation的费用向你收取,共享automation的费用则向存储库所有者收取。 若要控制成本,你可以在创建或编辑automation时,在AI 额度限制部分设置限制。
可以在 AI credits 中设置以下可选限制。 如果不想设置限制,请将限制留空。
- 每次运行:一旦达到限制,就会停止此次运行。 最小值为 30 AI credits。
- 每日:防止在达到限制后启动新的运行。 每天在 00:00 UTC 重置。
- 每周:阻止新运行在达到限制后启动。 每周一 00:00 UTC 重置一次。
- 每月:防止新运行在达到限制后启动。 于每月第一天 00:00 UTC 重置。
每日、每周和每月限制不会停止正在进行的运行。 若要限制每个运行的成本,请设置每次运行上限。
若要删除限制,请编辑 automation 并清除值。
测试 automation。
可以立即运行一个 automation ,而无需等待其触发器触发,以检查它是否按预期运行。
-
automation从Automations 窗格中打开要测试的控件。
-
单击“运行”按钮。****
-
从 “触发器” 下拉列表中,选择要模拟的触发器。
-
如果选择了 手动 触发器,可选择输入 上下文,该内容将包含在代理提示中。 可以使用此方法通过 API 模拟触发 automation。
如果你选择了其他触发器,请在资源 URL中填写相关资源,例如已打开的问题的 URL 或已创建的拉取请求评论的 URL。
-
单击“立即运行”。
Copilot 启动会话 Copilot cloud agent ,并使用所选工具运行 automation'提示符。 可以打开会话以跟踪其进度并查看其所做的任何更改。
管理你的 Automations
你的个人 automations 仅你可见。 共享automations对具有存储库读取权限的所有人可见,任何具有写入权限的人都可以编辑它们。
从任何 automation 启动的会话对具有存储库读取权限的所有人都可见。
在存储库中的 Automations 窗格中,您可以:
- 查看个人 automations 和存储库的共享 automations、其已启动的会话以及其已使用的 AI credits。
- 编辑automation以更改其名称、提示、触发器、工具、模型、推理工作量或AI credits限制,并跟踪automation的修订历史。
- 审查由automation自身或其他automations提议的对automation的工具、触发器或提示的改进建议。
- 禁用 automation 以使其停止运行,或稍后重新启用它。
- 删除不再需要的项 automation 。
若要查看每个存储库中的所有 automations 内容,并导航到管理每个存储库,请使用 Automations 用户级别的视图。