取消节点运行
对指定 run_id 提交取消意图;取消受理不等于远端已经停止。
cancel_canvas_node_run
对指定 run_id 提交取消意图;取消受理不等于远端已经停止。
参数与调用
此操作会实际修改数据或提交任务。生成任务可能产生费用;先读取目标 ID 和版本,同一次请求的重试复用幂等键。
调试台中选择 cancel_canvas_node_run/minimal 示例。文档中的 ID 均为占位值,请替换成服务端返回的真实值。
验证范围:已核对当前 Facade 路由和请求字段;MCP 转发及 Facade PostgreSQL 集成测试通过。 不包含真实付费生成的端到端验收。
run_id 必须来自当前项目和画布的节点运行记录,可由画布 UI 或调用方上下文提供;不要使用聊天运行 ID 或技能运行 ID。取消请求返回 cancel_requested 仅表示已受理,需继续查询权威状态;不能据此认定远端执行已停止。
参数说明
以下字段放入工具的 arguments 对象内。“必填”指所在对象内必填;可选对象省略时无需填写其内部字段。空值与省略的含义以该字段 Schema 为准。
project_idstring必填项目的规范 ID,由管理员或当前项目上下文提供;调用身份仍需具备项目权限。
canvas_idstring必填项目内的画布 ID,从画布列表或当前画布上下文获取。
run_idstring必填提交操作返回的运行 ID;查询、取消必须沿用同一个 ID。
完整输入 JSON Schema(包含组合条件、枚举与引用)
{
"properties": {
"project_id": {
"type": "string",
"minLength": 1,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%\\x00-\\x20\\x7f]+$",
"maxLength": 255,
"description": "项目的规范 ID,由管理员或当前项目上下文提供;调用身份仍需具备项目权限。"
},
"canvas_id": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,64}$",
"description": "项目内的画布 ID,从画布列表或当前画布上下文获取。"
},
"run_id": {
"type": "string",
"minLength": 1,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%\\x00-\\x20\\x7f]+$",
"maxLength": 255,
"description": "提交操作返回的运行 ID;查询、取消必须沿用同一个 ID。"
}
},
"required": [
"project_id",
"canvas_id",
"run_id"
],
"title": "cancel_canvas_node_runArguments",
"type": "object",
"additionalProperties": false
}完整调用示例
cancel_canvas_node_run / minimal
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "cancel_canvas_node_run",
"arguments": {
"project_id": "01EXAMPLEPROJECT00000000000",
"canvas_id": "default",
"run_id": "01EXAMPLERUN000000000000000"
}
}
}将示例保存为 request.json 后发送:
curl https://mcp.viivo.djagon.com/mcp/ \
-H "Authorization: Bearer $MCP_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-06-18" \
--data-binary @request.json如何读取结果
先检查 HTTP 状态,再检查 JSON-RPC 的 error 与 result.isError。工具返回内容位于 result.content;如有结构化结果则同时查看 result.structuredContent。HTTP 200 不代表业务成功。
工具声明的输出 Schema
{
"additionalProperties": true,
"title": "cancel_canvas_node_runDictOutput",
"type": "object"
}具体处理见 结果与错误处理。
原始工具契约说明
Request cancellation of an active canvas node run.