ViiVo / 开发者文档
能力参考画布与节点

取消节点运行

对指定 run_id 提交取消意图;取消受理不等于远端已经停止。

cancel_canvas_node_run

对指定 run_id 提交取消意图;取消受理不等于远端已经停止。

参数与调用

cancel_canvas_node_run包含写入操作

此操作会实际修改数据或提交任务。生成任务可能产生费用;先读取目标 ID 和版本,同一次请求的重试复用幂等键。

调试台中选择 cancel_canvas_node_run/minimal 示例。文档中的 ID 均为占位值,请替换成服务端返回的真实值。

验证范围:已核对当前 Facade 路由和请求字段;MCP 转发及 Facade PostgreSQL 集成测试通过。 不包含真实付费生成的端到端验收。

调用前提

run_id 必须来自当前项目和画布的节点运行记录,可由画布 UI 或调用方上下文提供;不要使用聊天运行 ID 或技能运行 ID。取消请求返回 cancel_requested 仅表示已受理,需继续查询权威状态;不能据此认定远端执行已停止。

参数说明

以下字段放入工具的 arguments 对象内。“必填”指所在对象内必填;可选对象省略时无需填写其内部字段。空值与省略的含义以该字段 Schema 为准。

project_idstring必填

项目的规范 ID,由管理员或当前项目上下文提供;调用身份仍需具备项目权限。

minLength: 1 · maxLength: 255 · pattern: "^(?!\\.{1,2}$)[^/\\\\?#%\\x00-\\x20\\x7f]+$"
canvas_idstring必填

项目内的画布 ID,从画布列表或当前画布上下文获取。

pattern: "^[a-zA-Z0-9_-]{1,64}$"
run_idstring必填

提交操作返回的运行 ID;查询、取消必须沿用同一个 ID。

minLength: 1 · maxLength: 255 · pattern: "^(?!\\.{1,2}$)[^/\\\\?#%\\x00-\\x20\\x7f]+$"
完整输入 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.

本页内容