---
title: "Cloud Agent"
description: "按 GitHub 官方文档梳理 Copilot cloud agent 的启动、研究计划、迭代、PR 审查和 Actions 安全边界。"
verifiedAt: "2026-05-06"
---

Copilot cloud agent（云端代理，曾用名 Copilot coding agent）是 GitHub 上的异步开发代理。它可以在自己的临时开发环境里研究仓库、创建计划、改分支、跑测试，最后把结果交给你 review。

这组页面只处理云端 agent 的完整链路：什么时候交给它、怎么启动、先 branch 迭代还是直接 PR、如何审查输出、哪些安全边界不能省。

> [!TIP]
> **阅读目标**：读完本组索引，你应该能把 cloud agent 任务纳入 branch、PR、review、Actions 和回滚流程。

## 1. 工作流地图

- **About**：理解 cloud agent 能做什么、在哪里运行、可用范围和适合任务。
- **Kick off**：从 issue、Agents tab、prompt、repository seed 或 IDE 入口启动任务。
- **Research / Plan / Iterate**：先让 Copilot 研究和计划，再在 branch 上迭代，最后决定是否 PR。
- **Review output**：PR 进入普通 review 流程，必要时用 `@copilot` 请求修改。

```mermaid
flowchart TD
    Task["任务"] --> Entry{"启动入口"}
    Entry --> Issue["Assign issue"]
    Entry --> Prompt["Agents prompt"]
    Entry --> Repo["Seed repository"]
    Issue --> PR["直接创建 PR"]
    Prompt --> Branch["默认先在 branch 工作"]
    Repo --> Draft["Draft PR"]
    Branch --> Iterate["研究 / 计划 / 迭代"]
    Iterate --> PR
    PR --> Review["人工 review"]
    Review --> Merge{"可合并?"}
    Merge -->|否| Copilot["@copilot 请求修改"]
    Copilot --> Review
    Merge -->|是| Done["Merge"]

    style Branch fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style Review fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Done fill:#dcfce7,stroke:#16a34a,stroke-width:2px
```

## 2. 本组页面

<Cards>
  <Card title="Cloud Agent 是什么" description="理解 cloud agent 的能力、临时开发环境、适合任务和可用限制。" href="/docs/github-copilot/official/04-cloud-agent/about-cloud-agent" />
  <Card title="启动任务" description="从 issue、Agents tab、prompt、repository seed、IDE 或 GitHub Chat 启动云端任务。" href="/docs/github-copilot/official/04-cloud-agent/kick-off-a-task" />
  <Card title="研究、计划和迭代" description="先研究和计划，再在 branch 上审 diff、补充约束、创建 PR。" href="/docs/github-copilot/official/04-cloud-agent/research-plan-iterate" />
  <Card title="审查输出" description="按普通 PR 标准审查 Copilot 改动、Actions、merge conflict 和反馈。" href="/docs/github-copilot/official/04-cloud-agent/review-output" />
</Cards>

## 3. 适合的任务

适合 cloud agent：

- backlog 里长期没人做的 “nice to have” 改进。
- 小到中型 bug 修复。
- 文档更新、测试覆盖率提升、技术债清理。
- 需要 PR review 的异步任务。
- 先研究仓库并给计划的复杂问题。

不适合：

- 需要你实时盯住每个编辑动作的微小改动。
- 生产部署、删数据、改云资源。
- 没有验收标准的“你自己看着办”。
- 需要未授权私有系统、密钥或线下上下文的任务。

## 4. 团队上线清单

- 确认仓库启用了 cloud agent，且不是 managed user account 场景。
- 明确哪些任务允许从 issue assign 给 Copilot。
- 规定 prompt 必须包含目标、非目标、测试、不可触碰范围。
- 规定是否允许自动运行 GitHub Actions。
- 规定 reviewer 必须看 diff、session logs 和 workflow file 变更。
- 规定 `@copilot` follow-up 只由有 write access 的成员发起。

<details>
<summary>深读：Cloud agent 不是免 review 的外包开发者</summary>

Cloud agent 能在后台做事，节省等待时间，但它仍然是通过 prompt、仓库上下文和自动工具完成任务。它输出的是候选分支和 PR，不是最终结论。

商业级用法是把它当作额外开发资源，同时保留和人类贡献一样的审查、测试、批准和回滚流程。
</details>

## 本组自检

读完整组后，用这 4 个问题检查：

1. 当前任务适合直接 PR，还是应该先 branch 研究和迭代？
2. Copilot 能看到的 issue、prompt、comments 和仓库上下文是否足够？
3. PR 里 GitHub Actions 是否需要人工批准运行？
4. Review 失败时，是用 `@copilot` 继续迭代，还是人工接管分支？

通过标准：cloud agent 输出进入普通工程审查流程，而不是绕过 review。

## 官方来源

- [About GitHub Copilot cloud agent](https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent) —— 官方概念页。
- [Use Copilot agents](https://docs.github.com/en/copilot/how-tos/copilot-on-github/use-copilot-agents) —— 官方 agents 操作入口。
- [Kick off a task with Copilot agents on GitHub](https://docs.github.com/copilot/how-tos/copilot-on-github/use-copilot-agents/kick-off-a-task) —— 官方启动任务页。
- [Review output from Copilot](https://docs.github.com/en/copilot/how-tos/copilot-on-github/use-copilot-agents/review-copilot-output) —— 官方审查输出页。

## 接下来去哪

<Cards>
  <Card title="Cloud Agent 是什么" description="先理解 cloud agent 的运行环境和适用场景。" href="/docs/github-copilot/official/04-cloud-agent/about-cloud-agent" />
  <Card title="启动任务" description="再学习从 issue 和 prompt 启动任务的区别。" href="/docs/github-copilot/official/04-cloud-agent/kick-off-a-task" />
</Cards>
