---
title: "启动任务"
description: "说明从 issue、Agents tab、prompt、repository seed、IDE 和 Chat 启动 Copilot cloud agent 任务的方式。"
verifiedAt: "2026-05-06"
---

启动 cloud agent 任务时，prompt 要像 issue 规范（issue spec），而不是随口聊天。官方页面的核心分工是：**assign issue 会直接创建 PR**；**从 prompt 启动默认在 branch 上工作**，方便你先 review、补提示、迭代，再决定是否创建 PR。

> [!TIP]
> **阅读目标**：读完本章，你应该能选择 issue assignment、Agents prompt、seed repository 或 IDE 入口，并写出可执行的任务说明。

## 1. 启动入口

官方文档列出几种常见入口：

- **Assign issue to Copilot**：把 issue 指派给 Copilot；它会工作并在完成后请求 review。
- **Agents tab / agents panel**：选择 repository，输入 prompt，默认先在 branch 上工作。
- **github.com/copilot/agents**：集中查看和启动 agent sessions。
- **Copilot Chat `/task`**：从 GitHub.com Chat 或 dashboard prompt box 启动。
- **Seed new repository**：创建新仓库时让 Copilot scaffold starter code，并打开 draft PR。
- **IDE / GitHub Chat 创建 PR**：某些入口可以请求 Copilot 开 PR；在 IDE 里通常需要 `@github` participant。

```mermaid
flowchart TD
    Start["启动任务"] --> Issue["Assign issue"]
    Start --> Prompt["Agents prompt"]
    Start --> Seed["Seed repository"]
    Start --> Chat["Chat / IDE"]
    Issue --> DirectPR["直接 PR"]
    Prompt --> Branch["默认 branch 迭代"]
    Seed --> DraftPR["Draft PR"]
    Chat --> PR["请求创建 PR"]
    Branch --> Review["review diff / follow-up prompt"]
    Review --> CreatePR["准备好后创建 PR"]

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

## 2. Issue assignment 的注意点

Assign issue 适合已有明确 issue 的任务。官方页面说明，Copilot 会在 assignment 时接收 issue title、description 和已有 comments。

关键边界：

- Assignment 之后新增到 issue 的 comments，Copilot 不会自动看到。
- 后续信息应该放到 Copilot 创建的 pull request 里。
- 可以在 Optional prompt 里补充编码模式、要改的文件、测试要求。
- 可以选择 target repository、base branch、agent 或 custom agent。

## 3. Prompt 启动的注意点

从 Agents prompt 启动默认先在 branch 工作。适合你想先看 diff、继续 prompt 迭代，然后再创建 PR 的场景。

一个合格 prompt 至少包含：

```text
目标：
实现友好的错误提示

范围：
只改登录错误处理

不要改：
认证协议和数据库 schema

验证：
运行 auth 测试
说明未覆盖风险
```

如果你希望一开始就创建 PR，要在 prompt 里明确说明。

## 4. 视觉输入

官方启动任务页说明，从 prompt 启动时可以添加视觉输入，例如 screenshot 或 UI mockup；支持 image/png、image/jpeg、image/gif、image/webp。

适合：

- UI 文案和布局修复。
- 错误状态截图。
- 设计稿与当前页面差异。

不适合：

- 粘贴含账号、客户数据、token 或内部地址的截图。

## 5. 模型和第三方 agent

官方页面说明，Copilot Pro 或 Pro+ 用户可以选择 cloud agent 使用的模型；也可以在任务入口选择 custom agent。第三方 coding agents 在 GitHub Copilot Pro+ 和 Copilot Enterprise plans 中可用。

团队不要把这些选项写死为永久状态。模型、plan 和第三方 agent 可用性都属于高频变化事实，教程里要标核验日期。

<details>
<summary>深读：为什么 issue 和 prompt 的默认结果不同</summary>

Issue assignment 更像“把已有工单交给 Copilot 做成 PR”；Agents prompt 更像“先开一个可迭代的云端工作分支”。前者快，后者更适合先研究和调整。

如果任务还没完全定义清楚，优先用 prompt + branch 迭代；如果 issue 已经写清楚验收标准，可以直接 assign。
</details>

## 本章自检

完成本章后，用这 4 个问题检查：

1. 这个任务应该直接 PR，还是先 branch 迭代？
2. Prompt 是否写了目标、范围、不可触碰内容和验证方式？
3. 如果从 issue 启动，后续上下文是否会写到 PR 里？
4. 是否包含敏感截图、密钥或不能给 cloud agent 的上下文？

通过标准：任务启动后，reviewer 能从 issue、prompt 或 PR 里复盘 Copilot 被要求做什么。

## 官方来源

- [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) —— 官方启动任务页。
- [Troubleshooting GitHub Copilot cloud agent](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent) —— 官方排障页，说明 IDE 入口和 `@github` participant 边界。
- [Creating custom agents for Copilot cloud agent](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents) —— 官方 custom agents 入口。

## 接下来去哪

<Cards>
  <Card title="研究、计划和迭代" description="如果你从 prompt 启动，继续学习如何审 plan 和 branch diff。" href="/docs/github-copilot/official/04-cloud-agent/research-plan-iterate" />
  <Card title="审查输出" description="如果 Copilot 已经开 PR，继续学习怎么审查。" href="/docs/github-copilot/official/04-cloud-agent/review-output" />
</Cards>
