ViiVo / 开发者文档

画布操作流程

读取、编辑节点及管理已有运行,遵守版本与授权边界。

读取画布

从管理员或项目上下文取得 project_id、canvas_id,调用 get_canvas。layout 包含节点及 revision,node_states 是独立的运行状态。读取不会修改画布。

增改删节点

  1. 确认调用身份有当前画布的有效编辑授权。Agent 的编辑权来自服务端记录的画布聊天运行授权,不能只靠 Token 或伪造请求头取得。
  2. 读取画布,保存最新 layout.revision,用作 base_revision。
  3. 按需调用 新增节点、修改节点 或 删除节点。
  4. 修改使用 JSON Merge Patch,null 删除字段;不要把整份旧画布当补丁。删除会移除相连的边。
  5. 成功后重新读取;发生 409 时重新读取并核对编辑权,不自行递增 revision 重试。

只修改明确授权的目标节点。节点类型和业务字段使用当前画布支持的结构,不能凭名称创造类型。

查询、取消已有运行

从画布 UI 或已有调用上下文取得精确 run_id,调用 查询运行。需要停止时调用 取消运行,再继续查询。

cancel_requested 只表示取消意图已被接受,不证明本地或远端任务已经停止。节点运行 ID、聊天运行 ID 和技能运行 ID 不可混用。

查看技能目录

list_freezone_skills 返回技能及输入定义,适合能力发现。目录信息不等于开放独立执行;本文档目前只发布目录查询。

本页内容