能力参考画布与节点
查询节点运行
用执行返回的 run_id 查询该次运行的权威状态和结果。
get_canvas_node_run
用执行返回的 run_id 查询该次运行的权威状态和结果。
参数与调用
get_canvas_node_run读取数据
调试台中选择 get_canvas_node_run/minimal 示例。文档中的 ID 均为占位值，请替换成服务端返回的真实值。
验证范围：已核对当前 Facade 路由和请求字段；MCP 转发及 Facade PostgreSQL 集成测试通过。 不包含真实付费生成的端到端验收。
调用前提
run_id 必须来自当前项目和画布的节点运行记录，可由画布 UI 或调用方上下文提供；不要使用聊天运行 ID 或技能运行 ID。
参数说明
以下字段放入工具的 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": "get_canvas_node_runArguments",
"type": "object",
"additionalProperties": false
}完整调用示例
get_canvas_node_run / minimal
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_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": "get_canvas_node_runDictOutput",
"type": "object"
}具体处理见 结果与错误处理。
原始工具契约说明
Get the authoritative state and result of a canvas node run.