GitHub 在 ２０２６ 年 ５ 月 １３ 日推出 Copilot cloud agent 的 Agent tasks REST API 公開預覽，讓 Copilot Business 與 Copilot Enterprise 使用者可以用 API 啟動雲端代理任務。
這代表 Copilot cloud agent 不再只是從 GitHub UI 或 IDE 中叫起，而可以被接進內部自動化流程。對大型工程團隊來說，這是很關鍵的一步，因為 agent 開始能被系統排程、批次觸發與追蹤。
Agent tasks REST API 是什麼？
Agent tasks REST API 讓你用程式啟動 Copilot cloud agent 任務。GitHub 官方說明，cloud agent 會在自己的背景開發環境中工作，能修改與驗證程式碼，最後開 pull request。
API 啟動後，也可以透過 API 追蹤任務進度。
官方提到目前支援：
- personal access tokens。
- fine-grained personal access tokens。
- OAuth tokens。
GitHub App installation access tokens 與 Copilot Pro、Pro+ 使用者支援則會之後到來。
適合哪些自動化？
GitHub 官方舉了幾個例子：
- 跨多個 repository 批次 refactor。
- 從內部開發者入口一鍵建立新 repo。
- 每週自動準備 release 與 release notes。
除此之外，也適合：
| 場景 | 用法 |
|---|---|
| 大量套件升級 | 每個 repo 啟動一個 agent 任務，開 PR 給人審 |
| API migration | 分批替換 deprecated API |
| 樣板同步 | 讓多個 repo 跟上公司標準模板 |
| 安全修補 | 針對已知 pattern 建立修補 PR |
| 文件補齊 | 對缺 README、CHANGELOG、typedoc 的 repo 開任務 |
這些任務的共通點是：步驟重複、範圍可描述、最後仍需要 PR review。
和 GitHub Actions 差在哪？
GitHub Actions 適合跑固定流程，Agent tasks API 適合啟動需要判斷與改碼的任務。
| 比較 | GitHub Actions | Agent tasks REST API |
|---|---|---|
| 核心能力 | 執行明確 workflow | 啟動 AI coding agent |
| 輸入 | YAML、script、event | 任務描述與 repo context |
| 輸出 | build、test、artifact、deploy | code changes 與 pull request |
| 適合 | 可預測流程 | 需要理解程式碼的修改 |
| 風險 | 腳本錯誤 | agent 改錯、測試不足、PR 品質不穩 |
兩者可以搭配。Actions 可以偵測事件並呼叫 Agent tasks API，agent 完成後再由 Actions 跑測試、lint、安全掃描。
企業導入要注意什麼？
這類 API 不能只看「能不能啟動 agent」，更要看治理。
建議先設計：
- 哪些系統可以呼叫 API。
- 哪些 repo 允許被 agent 修改。
- 任務描述模板。
- 單次任務最大範圍。
- PR 必要 reviewer。
- 測試與安全掃描 gate。
- 失敗時如何關閉任務。
- 成本與併發限制。
最怕的不是 agent 不會改，而是一次開太多 PR、改太大範圍，最後 reviewer 無法消化。
任務描述怎麼寫比較安全？
比較好的任務描述應包含：
- 目標。
- 不要碰的範圍。
- 預期修改檔案類型。
- 驗證方式。
- PR 說明格式。
- 若測試失敗要怎麼處理。
範例方向：
Upgrade all usages of the deprecated internal logging helper to the new logger API in this repository.
Do not change business logic.
Do not modify generated files.
Run unit tests related to modified packages.
Open one pull request with a summary of changed call sites and any unresolved failures.任務越像工程 ticket，agent 越容易產出可審查的 PR。
重點整理
Agent tasks REST API 的意義，是讓 Copilot cloud agent 從個人互動工具，往平台化自動化前進。未來工程團隊可以把 agent 放進內部入口、排程、migration 工具和安全修補流程。
但這也代表管理問題會變多：誰能啟動、能改哪裡、改多大、誰負責審、失敗怎麼收斂。
真正適合先做的，不是讓 agent 接管所有開發，而是挑重複度高、風險可控、PR 可審查的任務。