Appearance
GitHub Copilot Cloud Agent 在 GitHub Actions 环境中自主完成开发任务——从研究代码库、制定计划到写代码、提 PR，全程在后台运行，你不需要全程盯着。本页解释它和 IDE Agent 模式的本质区别，以及适合委托给它处理的任务类型。
GitHub Copilot Cloud Agent：让 AI 独立完成整个开发任务
什么是 Cloud Agent
GitHub Copilot Cloud Agent 让 Copilot 像一个真实的团队成员一样在后台工作：你分配一个任务，它研究代码库、规划方案、写代码、创建分支、推送提交，最终提一个 Pull Request 请你审查。
它能处理的任务：
- 修复已知 Bug
- 实现新功能（需要明确的需求描述）
- 改善测试覆盖率
- 更新文档
- 偿还技术债务
- 解决合并冲突
Cloud Agent vs IDE Agent 模式：关键区别
很多人会混淆这两个概念：
| 维度 | Cloud Agent | IDE Agent 模式 |
|---|---|---|
| 运行环境 | GitHub Actions 云端（独立） | 你的本地 IDE（实时） |
| 交互方式 | 提交任务后异步等待 PR | 实时观察 AI 操作 |
| 结果形式 | 提一个 PR 供你审查 | 直接修改本地文件 |
| 适合场景 | 背景任务、异步开发 | 需要实时介入的复杂任务 |
| 干预时机 | 通过 PR 评论 steer | 随时暂停/修改 |
触发 Cloud Agent 的入口
- GitHub Issues：将 Issue 分配给 Copilot
- GitHub.com Chat：输入
/task+ 任务描述 - VS Code：Chat 中使用「委托给 Cloud Agent」按钮
- JetBrains / Eclipse：Chat 面板中的 Cloud Agent 按钮
- GitHub CLI：
gh agent-task create - GitHub Mobile：点击 Copilot 图标
- Agents 面板/页面：直接创建新任务
任务执行流程
- 你描述任务（可以包含具体需求、期望的实现方式）
- Cloud Agent 开始研究相关代码，在 Issue 上留 👀 反应
- 自动创建分支，制定实现计划
- 编写代码，运行测试和代码检查
- 推送提交，提 Draft PR
- 请求你进行 Code Review
整个过程可以通过 PR 评论进行 steer——直接在 PR 上 @copilot 给出指导。
限制和注意事项
- 一次任务只能操作一个仓库（不能跨仓库）
- 只支持托管在 GitHub.com 的仓库（不支持 GitHub Enterprise Server）
- 某些分支保护规则可能阻止 Cloud Agent 推送（需要管理员配置）
- 不支持内容排除设置（Content Exclusion 对 Cloud Agent 无效）
- 消耗 GitHub Actions 分钟数 + Copilot Premium 请求配额
自定义 Cloud Agent 行为
- Custom Instructions：在
.github/copilot-instructions.md写入项目规范 - MCP 服务器：接入数据库、外部 API 等工具
- Custom Agents：创建专门处理特定任务的 Agent
- Hooks：在特定阶段触发自定义操作
- Agent Skills：添加特定的能力扩展
和 Claude Code 的对比
Claude Code 的 Agent 模式也支持自主完成多步任务，但在本地终端实时运行，适合需要实时介入的场景。Cloud Agent 完全在云端异步执行，适合"我去干别的，让 AI 在后台工作"的场景。
常见问题
Q: Cloud Agent 提的 PR 我不满意，可以让它改吗？
A: 可以。在 PR 的评论区 @copilot 加上具体的修改要求，Cloud Agent 会继续在同一个 session 中修改代码并更新 PR。
Q: Cloud Agent 失败了怎么办？
A: 查看 PR 里的 session 日志（每个 commit message 包含日志链接），了解卡在哪里。如果是 Issue 分配任务失败，取消分配后重新分配即可重试。
Q: 用 Cloud Agent 消耗多少额度？
A: 消耗 GitHub Actions 分钟数（开发环境运行） + Copilot Premium 请求（AI 推理）。复杂任务可能消耗较多 Premium 请求。Copilot Free 不包含 Cloud Agent，需要 Pro 及以上。