API 与程序化接入

Cursor 的程序接口覆盖 Agent 工作流、团队管理与统计。Cloud Agents API 和 SDK 运行带上下文、工具、命令与编辑能力的 Agent，不是独立的模型推理或 chat-completions API。

选择接口

接口	用途与可用范围
Cloud Agents API	创建和管理云端 Agent；当前 v1 为 public beta，API 总览标记所有套餐可用
TypeScript / Python SDK	统一接入本地和云端运行时；面向所有用户
SDK Bridge	用其他语言实现 SDK 的开放协议与独立二进制
Admin / Analytics / AI Code Tracking	Enterprise 团队管理、用量和代码归因
Bugbot API	Enterprise 主动触发评审并读取评审分析
Origin API	仓库、提交、checks、PR 和 App 安装；early beta

接口可用性与具体运行能力的账号权限分别判断。不要因为能创建 key 就假定已获得全部 Enterprise 或 Cloud Agents 功能。

Cloud Agents 接入路径

• 认证与限流：选择 key、HTTP 认证和重试方式。
• 创建任务：仓库、模型、执行环境和可选能力。
• Runs 与状态：追加提示、判断完成和读取用量。
• SSE 流：实时输出、断线续接和过期处理。
• 产物与生命周期：下载、归档、恢复和删除。
• 环境 API：保存配置和查询 Build。
• 旧版与 Webhook：v0 兼容边界和通知校验。

自托管池的 claim、session token 和伸缩工作流见Worker Controller。

在应用中使用官方客户端，见Agent SDK。

Bugbot API可触发评审、读取 dry-run findings 和管理配置。

管理与分析接口

• Admin API与组管理。
• 用量对账与Analytics。
• AI Code Tracking：提交和采纳变更。

跨团队管理

• Organization API：成员集合同步与合同用量。
• 组织组 API：g_ 标识和组成员。
• 模型策略 API：custom policy、catalog 参数和批量部分成功。