@cursor_ai：Cursor 推出 SDK 支援自訂 Agent。5 功能。 Cursor 官方近期宣布正式釋出 Cursor SDK，這項工具讓開發者能透過 Pytho…

Cursor 推出 SDK 支援自訂 Agent。5 功能。 Cursor 官方近期宣布正式釋出 Cursor SDK，這項工具讓開發者能透過 Python 或 TypeScript 程式碼，直接呼叫並操控與 Cursor IDE、CLI 及網頁版相同的 Agent 核心。為了鼓勵開發者嘗試，官方更祭出限時優惠，在長週末期間透過 SDK 使用 Composer 的費用將享有 90% 的折扣。 核心功能與應用 Cursor SDK 的設計目標是提供統一的介面，讓開發者能無縫切換本地端（local）與雲端（cloud）的執行環境。開發者只需透過 Agent.create() 設定執行環境，即可撰寫通用的程式碼，無需針對不同環境進行大幅調整。該 SDK 支援同步與非同步（async）客戶端，並提供型別化的資料類別（dataclasses），能有效提升程式碼的開發效率與型別檢查能力。 快速上手與安裝 開發者可以透過 Python 套件管理工具進行安裝，並使用 Cursor 內建的 /sdk skill 來獲取指引。 安裝 SDK： `bash uv pip install cursor-sdk ` 設定認證：在建立 Agent 之前，需設定 CURSORAPIKEY 環境變數。 執行 Agent：開發者可選擇使用 Agent.prompt() 進行單次提示詞（one-shot）操作，或透過 Agent.create() 建立長駐的 Agent 實例。 雲端 Agent 與排程整合 針對雲端 Agent 的使用，SDK 提供了原生的支援，允許開發者列出已連接的儲存庫（repositories）、啟動 Agent 並監控執行結果。值得注意的是，由 SDK 啟動的雲端 Agent 預設不會出現在一般的 Agent 清單中，使用者若需檢視，必須在 Cursor Web 或 Agent 視窗中透過「Filter > Source > SDK」進行篩選。此外，SDK 支援在執行時傳遞 env_vars，適用於需要短效憑證或其他環境變數的場景。 進階開發與控制 對於需要複雜排程或伺服器端整合的應用，SDK 提供了完整的非同步支援。 非同步操作：建議在伺服器或機器人應用中使用 AsyncClient，並透過 AsyncClient.launch_bridge(...) 作為非同步上下文管理器，確保每個事件迴圈（event loop）擁有獨立的客戶端。 串流與狀態管理：SDK 支援串流事件處理，開發者可以透過 run.stream() 提取助理的回應文字、處理工具呼叫（tool calls）並讀取執行狀態。 自訂配置：SDK 允許開發者注入自訂的 httpx 客戶端，以滿足代理伺服器（proxy）或特殊的 HTTP 配置需求。同時，透過 with_options(...) 方法，開發者可以靈活調整逾時（timeout）與重試機制。 注意事項與限制 目前 Python SDK 處於公開測試階段（Public Beta），API 介面在正式發布前仍可能變動。此外，目前尚未支援團隊管理員（Team Admin）的 API 金鑰。開發者在使用時應注意，SDK 的執行費用與使用量將遵循與 IDE 及雲端 Agent 相同的計費規則，相關數據會顯示在團隊儀表板的「SDK」標籤下。更多詳細技術文件可參考 Cursor SDK 官方文件。原文：https://easyvibecoding.app/curated/1512