用途:通过 Cursor Cloud Agents(原 Background Agents)REST API,在云端 GitHub 仓库上运行自主编程任务。适用于需要从自然语言提示启动 Cursor 智能体、列出并检查智能体状态、向活跃智能体发送后续提示、轮询或流式获取运行结果、列出可用模型与仓库,以及归档、取消归档或永久删除智能体的场景。
主要能力:所有请求发往 https://api.cursor.com,使用 Bearer 令牌认证:Authorization: Bearer $CURSOR_TOKEN。可检查 API Key(GET /v1/me)、列出模型(GET /v1/models)、列出可访问仓库(GET /v1/repositories)、创建智能体(POST /v1/agents,自动入队首次运行)、列出智能体(GET /v1/agents)、获取状态(GET /v1/agents/<agent-id>)、列出与查看运行(GET /v1/agents/<agent-id>/runs 及 /runs/<run-id>)、发送后续提示(POST /v1/agents/<agent-id>/runs)、取消运行(POST /v1/agents/<agent-id>/runs/<run-id>/cancel)、列出产物(GET /v1/agents/<agent-id>/artifacts),以及归档、取消归档、删除智能体。
使用方式:先在 app.vm0.ai/connectors 连接 Cursor 连接器,并在 Cursor Dashboard → API Keys 创建密钥。启动前先调用模型和仓库端点确认有效 ID。智能体异步运行,需轮询运行状态直到终态再读取结果。产物下载 URL 为预签名且约 15 分钟过期,应在下载前即时获取。
限制:每个请求都需 Bearer 认证;401 表示密钥缺失或无效,需重新连接连接器。故障排查可运行 zero doctor check-connector --env-name CURSOR_TOKEN 或 zero doctor check-connector --url https://api.cursor.com/v1/me --method GET。官方文档:https://cursor.com/docs/background-agent/api/overview。其余收费、价格、平台细节暂未提供。