SuperAPI AI 工具集

cursor-runs

智能体与模型

查看项目

更新于 10-16 05:51

技能介绍

用途:cursor-runs 是 Cursor SDK 中围绕 Run 的技能文档。Agent.create 之后的所有操作都通过 Run 进行,本技能说明如何下发工作、流式接收事件、等待结果、取消运行以及检查对话历史。

主要能力:发送任务方面,agent.send(message, options) 与 SendOptions 支持每次运行的模型覆盖、MCP 覆盖、回调与 force;支持在同一 agent 上进行多轮 follow-up 对话。Run 对象提供 id、status、result、git、model、durationMs,可通过 await run.wait() 获取 RunResult,通过 run.cancel() 取消,通过 onDidChangeStatus 监听状态变化,并用 run.supports(op) 与 unsupportedReason 判断操作支持情况。

流式与对话:可用 for await 遍历 run.stream(),SDKMessage 类型联合包含 system、user、assistant、thinking、tool_use、status、task、request;onDelta 更新覆盖文本、思考、工具调用、token、步骤、摘要与 shell,onStep 提供步骤级回调。run.conversation() 返回 ConversationTurn[],区分 agentConversationTurn 与 shellConversationTurn 及步骤类型。

适用场景:消费流式 SDKMessage 事件、实现同一 agent 的后续轮次、取消或重新接入长时间运行的云端运行、解析工具调用、思考块或助手文本。

限制与延伸:资料未提供具体代码示例、安装命令、收费与平台信息。生命周期与创建见 cursor-sdk 技能,云端运行特性(PR、产物)见 cursor-cloud,错误分类见 cursor-errors。