云端 Automations
按计划或仓库事件执行任务,理解访问前提、可见范围和任务归属。
Automations 保存任务提示、触发器、模型和可用工具,在条件满足时自动启动 cloud agent。适合 Issue 分类、周期性测试修复和发布说明等重复任务。
使用前提
必须同时满足:
- 仓库为 private 或 internal;public 仓库不支持这套 Automations。
- 仓库已开启 cloud agent;Business / Enterprise 使用者还需要管理员允许相应策略。
- 组织允许仓库使用 cloud agent 与 Automations。该功能专题将组织的两项允许设置描述为默认启用,但仍需满足上层许可与策略。
- 使用 Pro、Pro+、Max、Business 或 Enterprise 套餐,并具有仓库写权限。
可从仓库 Agents → Automations 或 Copilot app 的 Automations 标签页管理。不要把这里的仓库条件套用到所有 GitHub Actions 或 Agentic Workflows。
可用触发器
| 触发器 | 条件 | 可选筛选 |
|---|---|---|
| On a schedule | 每小时、每天、每周重复 | 按界面设定时间 |
| When an issue is created | 创建 Issue | 搜索查询 |
| When a pull request is opened | 打开 PR | 搜索查询、变更文件 |
| When a pull request is synchronized | PR 推送新提交 | 搜索查询、变更文件 |
同一个自动化可以有多个触发器。默认忽略没有仓库写权限的用户触发的事件,也可选择允许此类事件;是否纳入外部贡献者应按实际任务决定。
工具与继承配置
工具选择决定它能做什么,例如更新 Issue 标签、推送修改或创建 PR。可手动选择,也可用 Suggest tools 生成建议,再检查是否符合任务范围。
自动化只对所配置的单一仓库执行动作,并继承该仓库的 custom instructions、Skills、防火墙、Secrets 和变量。不会因为定时运行而自动获得跨仓库操作范围。
私有配置与共享执行
自动化配置只对创建者可见,其他人甚至仓库管理员也不能查看它。但其启动的 cloud agent 会话对有仓库访问权的人可见,包括提示、日志和生成的改动。
因此不要把密钥直接写进 prompt。需要凭据时使用Agents Secrets。私有配置也不代表运行产物或会话提示是私有的。
归属和计费
PR 和代码归属于自动化创建者;创建者不能用自己的批准满足相应 PR 的审批要求。每次运行消耗 GitHub Actions minutes 与 GitHub AI Credits,自动化专题将这些使用量计入创建者。
PR Actions 工作流默认需要有写权限的人批准。Automations 概览使用了较绝对的审批表述,而 cloud agent 设置专题允许管理员调整工作流批准要求;具体仓库行为应结合仓库设置确认。
创建与管理步骤见管理 Automations。如果需要配置随 Git 版本管理和 PR 审查,使用Agentic Workflows对应机制。