Agent SDK 即日起開放使用。你可以用一個程式碼資料夾定義代理，透過評估進行測試，再部署到 Cursor 或你自己的基礎架構。

執行 npx @cursor/agent-sdk init ./my-bot，接著執行 agent-sdk dev，即可在本機啟動機器人，並透過 playground 進行測試。加上 --template 參數即可從範本開始，可選擇安全審查員、owners 政策核准者、PR 自動修正工具，或 Linear／Jira 事件分級處理工具。

#隨時隨地部署代理

當你準備好讓代理正式上線時，只要在專案目錄中執行 agent-sdk deploy，即可將它部署到 Cursor。這個指令會建置代理、為其指派 URL，並在我們的基礎架構上啟動。你可以在儀表板中管理機密與整合，同時沿用本機可使用的日誌、評估與 playground。

#以程式碼定義代理

一個代理就是一個專案。instructions.md 是提示詞；tools/ 中的每個檔案都是一個具型別的動作，可供模型呼叫。skills/ 存放模型隨需載入的程序，mcp-connections/ 從 MCP 伺服器加入工具，channels/ 則定義機器人在哪裡接收並回覆訊息。agent-sdk validate 會檢查專案，agent-sdk info 則會輸出探索到的內容。

#頻道

代理會在以下情況下被喚醒：GitHub、GitLab 和 Bitbucket 的 PR (拉取請求) 、留言與 CI 事件；Slack 中的提及與私訊；任何供應商傳來的 webhooks；以及 cron 排程。GitHub 事件會透過你的 Cursor 帳號擷取，因此不需要公開的 webhook URL。Slack 則開箱即用，支援完善。

每段對話都有自己的工作階段，並完整記錄每則訊息與每次工具呼叫。在 PR (拉取請求) 或 Slack 討論串中提出的後續提問，會接續同一個工作階段。

#評估

評估會向機器人傳送一則固定訊息，並針對它的行為進行斷言：執行了哪些工具、使用了什麼輸入，以及回覆的結構。你可以在本機或 CI 中執行 agent-sdk eval。

agent-sdk github replay <pr-url> 會將真實的 PR (拉取請求) 轉換成已簽署的 webhook 酬載並傳送給機器人，因此不必等待推送，就能測試由 GitHub 觸發的機器人。加上 --dry-run --fixtures-dir fixtures/，即可將這些酬載儲存為評估用的 fixture。

#開始使用

Agent SDK 即日起正式全面推出。歡迎參閱文件，立即開始使用。