画布操作流程
读取、编辑节点及管理已有运行,遵守版本与授权边界。
读取画布
从管理员或项目上下文取得 project_id、canvas_id,调用 get_canvas。layout 包含节点及 revision,node_states 是独立的运行状态。读取不会修改画布。
增改删节点
- 确认调用身份有当前画布的有效编辑授权。Agent 的编辑权来自服务端记录的画布聊天运行授权,不能只靠 Token 或伪造请求头取得。
- 读取画布,保存最新
layout.revision,用作base_revision。 - 按需调用 新增节点、修改节点 或 删除节点。
- 修改使用 JSON Merge Patch,
null删除字段;不要把整份旧画布当补丁。删除会移除相连的边。 - 成功后重新读取;发生 409 时重新读取并核对编辑权,不自行递增 revision 重试。
只修改明确授权的目标节点。节点类型和业务字段使用当前画布支持的结构,不能凭名称创造类型。
查询、取消已有运行
从画布 UI 或已有调用上下文取得精确 run_id,调用 查询运行。需要停止时调用 取消运行,再继续查询。
cancel_requested 只表示取消意图已被接受,不证明本地或远端任务已经停止。节点运行 ID、聊天运行 ID 和技能运行 ID 不可混用。
查看技能目录
list_freezone_skills 返回技能及输入定义,适合能力发现。目录信息不等于开放独立执行;本文档目前只发布目录查询。