# 策展 · X (Twitter) 🔥🔥🔥🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Cursor (@cursor_ai) · 平台：X (Twitter) · 日期：2026-05-24

> 原始來源：https://x.com/cursor_ai/status/2057913121558413770

## 中文摘要

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 來獲取指引。
1. 安裝 SDK：
   ```bash
   uv pip install cursor-sdk
   ```
2. 設定認證：在建立 Agent 之前，需設定 `CURSOR_API_KEY` 環境變數。
3. 執行 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 官方文件](http://cursor.com/docs/sdk/python)。

## 標籤

SDK, IDE, Agent, 新產品, 功能更新, Cursor