案例 5：画布 Agent 协作

约 2475 字大约 8 分钟

本案例让 Agent 协助把一段剧情文本扩展为可审阅的画布结构。核心原则是：先分析、后计划、再确认；引用真实节点，不让 Agent 猜目标。

前置条件

已登录并打开一个画布项目。
画布中已有文本节点 雨夜追逐提示词 与角色节点 女主角色设定。
右侧 Agent 对话面板可用。
需要真实生成时，后台存在启用的 IMAGE_MODEL_CODE 与 VIDEO_MODEL_CODE。

生成前先选择模式

Agent 输入框的“添加”菜单提供五种明确的生成模式。先选择模式，再填写提示词，不要让 Agent 根据一句自然语言猜测输出类型：

模式	适用场景	结果	默认是否写入画布
生成图片	概念图、角色设定、场景参考	图片任务和对话附件	否
生成视频	文生视频、图生视频、镜头片段	视频任务和对话附件	否
生成音频	配乐、音效、旁白或声音草稿	音频任务和对话附件	否
生成 TXT 文档	角色小传、分镜表、提示词整理	`.txt` 文件附件	否
生成 Markdown 文档	技术说明、项目方案、结构化创作资料	`.md` 文件附件	否

选择后，模式条会显示对应的参数摘要。图片模式需要确认画质、清晰度、比例和数量；视频模式需要确认模型、比例、清晰度、时长、音频和数量；音频模式需要确认音频模型； TXT 和 Markdown 模式需要确认文本模型和对应输出文件名。关闭模式条会恢复普通对话，不会沿用上一次的生成类型。

生成图片

选择“生成图片”，输入：
雨夜街道，角色撑伞快速奔跑，电影级写实风格，16:9。

核对图片模型、画质、清晰度、比例和数量后提交。完成结果先作为对话附件展示，点击 “添加到画布”并选择新建节点或目标节点，才会进入画布写入确认流程。

生成视频

选择“生成视频”，输入：
角色从街道左侧跑向镜头，镜头跟随推进，时长 8 秒，16:9，720p。

核对视频模型、时长、比例、清晰度、音频和预计积分。生成任务与画布写入是两个动作，不会因为引用了节点或填写了目标节点就自动写回。

生成 TXT 文档

选择“生成 TXT 文档”，输入：
整理为一份角色小传，包含外形、性格、动机和人物弧光。
文件名：角色小传.txt

TXT 任务完成后提供文件附件。需要放入画布时，必须点击“添加到画布”并明确选择文本节点；没有明确写回要求时，服务端会移除 targetNodeId。

生成音频

选择“生成音频”，输入：
生成一段 30 秒、节奏逐渐增强的悬疑氛围配乐，不要人声。

确认音频模型和预计积分后提交。音频结果先作为对话附件返回，不会自动创建音频节点；需要进入画布时，再点击“添加到画布”并选择目标节点。

生成 Markdown 文档

选择“生成 Markdown 文档”，输入：
整理一份项目技术说明，包含架构、接口、部署步骤和验收清单。
文件名：项目技术说明.md

Markdown 模式使用文本模型，但输出文件名必须以 .md 结尾。完成后返回 Markdown 文件附件；只有用户明确点击“添加到画布”时，才进入文本节点写入审批流程。

模糊请求先澄清

下面这些说法信息不足，Agent 应返回选项而不是直接调用工具：

帮我处理一下这个
把它弄好
生成后放进去
优化一下
整理一下

标准澄清内容：

你希望我执行哪一种操作？

1. 只分析并给出建议
2. 创建新的画布节点
3. 修改当前选中节点
4. 生成内容并写回指定节点

选择第 4 项后仍需指定真实目标节点、生成类型和积分确认；不能按标题、位置或语义猜测。

阶段一：让 Agent 只读分析

先发送下面的请求。它不会修改画布，也不会产生生成积分。

检查当前画布的工作流结构，列出：
1. 没有输入来源的生成节点；
2. 没有输出去向的可复用结果；
3. 生成失败或待补充提示词的节点；
4. 我应该先处理的三项工作。
不要修改画布，也不要提交生成任务。

审阅 Agent 输出时，重点确认它描述的节点与你实际看到的画布一致。若它提到同名但不确定的节点，不要直接要求修改，改用 @ 精确引用。

阶段二：用 `@` 引用创建待生成节点

在输入框中输入 @，从候选列表选择 女主角色设定，然后发送：

基于 @女主角色设定 创建一个图片节点“女主三视图参考”，并将角色设定连接到新图片节点。
新节点保持待生成状态，暂不提交图片生成任务。

执行前应看到计划卡，其中至少包含：

新图片节点的标题与类型。
从角色文本到新节点的真实连线。
受影响节点/连线数量。
“暂不提交任务”的边界。

确认无误后再批准。执行完成时，使用“查看画布变更”定位受影响节点；定位是显式操作，不会在后台自动改变你当前的缩放和视图。

阶段三：补充节点内容，但保留原稿

选择原提示词节点并发送：

把 @雨夜追逐提示词 改成电影级写实风格：强化湿地反光、手持跟拍、雨滴、霓虹和紧张追逐节奏；保留原有剧情动作、现有角色信息和所有参考条件。
先展示文本差异，等待我确认后再修改。

确认卡应明确显示目标是一个文本节点，而不是整个画布。如果计划内有额外删除、生成或无关节点变更，拒绝该计划并改写请求。

阶段四：把文本扩展为预设工作流

把 @雨夜追逐提示词 做成文生视频工作流。
只创建工作流容器、视频输入/输出节点、默认参数和必要连线；暂不提交视频生成任务。

当前预设支持文生视频、图片反推提示词、文字生音乐、音频生视频、首尾帧生成视频等。预设创建是原子画布变更：节点、默认参数和连线应一起出现；计划不完整时不要批准。

阶段五：提交明确的生成请求

生成会产生积分，必须写清楚引用、模型、目标节点、时长、比例和写回位置：

基于 @女主三视图参考 和 @雨夜追逐提示词 创建视频节点“女主雨夜追逐”。
将两个节点连接到新视频节点；使用模型：VIDEO_MODEL_CODE；时长：8 秒；比例：16:9；分辨率：1080p；确认后提交生成，完成后写回该视频节点。

在确认卡核对五件事：

两个引用是否是期望节点。
VIDEO_MODEL_CODE 是否为当前已启用的真实代码。
8 秒、16:9、1080p 是否在该模型支持范围内。
预计积分是否可接受。
结果目标是否为新建的“女主雨夜追逐”，而不是已有通过版本。

阶段六：查询、重试和回滚

查询任务

检查当前会话中所有生成任务的状态、进度、失败原因和实际积分。只列出失败项的下一步操作，不重复提交已完成任务。

失败项应通过执行卡提供的“重试失败项”处理；这样会按原计划只恢复失败任务，不影响已完成结果。

撤销结构操作

撤销刚才创建“女主资产”分组的 Agent 操作，恢复分组前的节点结构和位置；不要取消已经完成的图片或视频生成任务。

画布结构操作可回滚；已完成的付费媒体任务与结果不应被当作普通节点变更静默删除。

常用请求模版

【只读】分析 @节点A 的上游输入、下游用途和缺失信息；不要修改。

【结构】将 @节点A 连接到 @节点B；不改正文与模型配置。

【创建】基于 @节点A 创建【类型】节点“【标题】”，暂不提交生成任务。

【生成】基于 @节点A 和 @节点B 创建【类型】节点“【标题】”；模型：MODEL_CODE；参数：...；确认后生成并写回目标节点。

【整理】按【列或分组逻辑】整理当前画布；保留所有连线和内容，不生成。

避免的写法

不明确的请求	可执行的改写
“生成一段视频”	“基于 @提示词创建视频节点‘名称’，使用 VIDEO_MODEL_CODE、5 秒、16:9，确认后生成。”
“把它们连起来”	“将 @文本节点连接到 @视频节点。”
“继续刚才的内容”	点击历史消息“引用”，或引用具体 `@节点`。
“用视频模型”	指定已启用的 `VIDEO_MODEL_CODE`。
“取消任务”	在对应执行卡点击“取消任务”，避免 Agent 猜测并行任务。