Cursor

配置

启动代理

操作

启动代理

API 密钥*

••••••••

仓库 URL*

https://github.com/your-org/your-repo

分支/引用

main（可选）

提示词*

描述代理的任务...

模型

默认自动选择

分支名称

自定义分支名称（可选）

自动创建 PR

Disabled

作为 Cursor GitHub App 打开

Disabled

跳过审查者请求

Disabled

启动代理 (cursor_launch_agent)

启动一个新的云代理，按照给定的指令处理 GitHub 仓库。

输入

参数	类型	必填	说明
`apiKey`	string	是	Cursor API 密钥
`repository`	string	是	GitHub 仓库 URL (例如：https://github.com/your-org/your-repo)
`ref`	string	否	用于工作的分支、标签或提交 (默认为默认分支)
`promptText`	string	是	给智能体的指令文本
`promptImages`	string	否	包含 base64 数据和尺寸的图像对象的 JSON 数组
`model`	string	否	要使用的模型 (留空以自动选择)
`branchName`	string	否	智能体要使用的自定义分支名称
`autoCreatePr`	boolean	否	智能体完成后自动创建 PR
`openAsCursorGithubApp`	boolean	否	以 Cursor GitHub App 身份打开 PR
`skipReviewerRequest`	boolean	否	跳过在 PR 上请求审阅者

输出

参数	类型	说明
`content`	string	包含智能体详细信息的成功消息
`metadata`	object	启动结果元数据

添加跟进

操作

添加跟进

API 密钥*

••••••••

智能体 ID*

例如：bc_abc123

跟进提示*

给智能体的附加指令...

添加跟进（cursor_add_followup）

向现有云端代理添加一条跟进指令。

输入

参数	类型	必填	说明
`apiKey`	string	是	Cursor API 密钥
`agentId`	string	是	云端代理的唯一标识符 (例如 bc_abc123)
`followupPromptText`	string	是	发送给代理的跟进指令文本
`promptImages`	string	否	由图片对象组成的 JSON 数组，包含 base64 数据与尺寸 (最多 5 个)

输出

参数	类型	说明
`content`	string	成功消息
`metadata`	object	结果元数据

获取代理状态

操作

获取代理状态

API 密钥*

••••••••

代理 ID*

例如，bc_abc123

获取智能体状态(cursor_get_agent)

获取云智能体的当前状态和结果。

输入

参数	类型	必填	描述
`apiKey`	string	是	Cursor API 密钥
`agentId`	string	是	云智能体的唯一标识符 (例如，bc_abc123)

输出

参数	类型	描述
`content`	string	人类可读的智能体详情
`metadata`	object	智能体元数据

获取对话

操作

获取对话

API 密钥*

••••••••

智能体 ID*

例如，bc_abc123

获取对话(cursor_get_conversation)

获取云智能体的对话历史，包括所有用户提示和助手响应。

输入

参数	类型	必填	说明
`apiKey`	string	是	Cursor API 密钥
`agentId`	string	是	云智能体的唯一标识符（例如 bc_abc123）

输出

参数	类型	说明
`content`	string	人类可读的对话历史
`metadata`	object	对话元数据

列出智能体

操作

列出智能体

API 密钥*

••••••••

数量上限

20（默认，最大 100）

分页游标

上一次响应返回的游标

列出智能体（cursor_list_agents）

列出已认证用户的全部云智能体，支持可选分页。

输入

参数	类型	必填	说明
`apiKey`	string	是	Cursor API 密钥
`limit`	number	否	返回的智能体数量（默认：20，最大：100）
`cursor`	string	否	上一次响应返回的分页游标

输出

参数	类型	说明
`content`	string	人类可读的代理列表
`metadata`	object	代理列表元数据

停止代理

操作

停止代理

API 密钥*

••••••••

代理 ID*

例如 bc_abc123

停止代理（cursor_stop_agent）

停止正在运行的云代理。这会暂停代理，但不会将其删除。

输入

参数	类型	必填	说明
`apiKey`	string	是	Cursor API 密钥
`agentId`	string	是	云代理的唯一标识符 (例如 bc_abc123)

输出

参数	类型	说明
`content`	string	成功消息
`metadata`	object	结果元数据

删除智能体

操作

删除智能体

API 密钥*

••••••••

智能体 ID*

例如：bc_abc123

删除智能体(cursor_delete_agent)

永久删除云智能体。此操作无法撤销。

输入

参数	类型	必填	描述
`apiKey`	字符串	是	Cursor API 密钥
`agentId`	字符串	是	云智能体的唯一标识符 (例如：bc_abc123)

输出

参数	类型	描述
`content`	字符串	成功消息
`metadata`	对象	结果元数据

使用说明

通过 Cursor Cloud Agents API 启动可在您的 GitHub 仓库上工作的 AI 智能体。支持启动智能体、添加跟进指令、检查状态、查看对话以及管理智能体生命周期。

备注

类别：tools
类型：cursor

Cursor

On this page