​
Background Agents API

Background Agents API 讓你以程式方式建立與管理由 AI 驅動的程式碼代理，它們會在你的儲存庫上自主運作。 你可以用這個 API 自動回應使用者回饋、修復錯誤、更新文件，還有更多！
Background Agents API 目前在 beta 階段，很期待聽到你的回饋！

​
主要功能

  • 自主程式碼產生 - 建立能理解你的提示並對程式碼庫進行變更的代理
  • 儲存庫整合 - 直接與 GitHub 儲存庫合作
  • 後續提示 - 為執行中的代理加入額外指示
  • 依使用量計費 - 只為你使用的權杖（tokens）付費
  • 可擴展 - 每個 API 金鑰最多支援 256 個同時運作的代理

​
快速開始

​
1. 取得你的 API 金鑰

前往 Cursor Dashboard → Integrations 建立你的 API 金鑰。

​
2. 開始使用 API

所有 API 端點皆是以下基底 URL 的相對路徑： 
https://api.cursor.com
詳見 API 參考 以取得完整端點清單。

​
驗證

所有 API 請求都必須使用 Bearer 權杖進行驗證： 
Authorization: Bearer YOUR_API_KEY
API 金鑰可在 Cursor Dashboard 建立。金鑰僅作用於你的帳戶，並授予建立與管理代理（agents）的權限（受你的方案限制與儲存庫存取權限所約束）。

​
定價

API 目前為 Beta，定價與 Background Agents 相同。隨著服務擴大，定價可能會變動。詳見 Background Agent 定價。

​
下一步