AI 视频 Agent 工作流：规划并执行多步骤画布

当交付物存在依赖关系时，AI 视频 Agent 工作流尤其有用：创意简报指导关键画面，关键画面成为视频输入，输出审核通过后才继续后续镜头。NamiFusion 画布以文本、图片、视频与素材节点表示工作，并用显式连线表达依赖。Agent 可通过 Workflow MCP 读取和修改同一份已保存画布，执行选定目标并读取完成输出。画布不会代替编辑判断，它只是让输入、来源链与重跑更清楚；素材权利、事实审核、费用和发布决定仍由你负责。

执行前先设计节点图

先写镜头表，再调用模型。每个镜头记录用途、目标时长、画幅、源素材、提示词、必须保留的细节和通过条件。把画布拆成阶段：文本简报节点、存放审核参考的持久素材节点、关键帧图片节点、运动视频节点，以及审核备注文本节点。只连接真实依赖；如果审核备注不会作为输入，就不应强行连到渲染节点。实验分支与审核主路径分开，避免重跑时悄悄替换可信素材。

在让 Agent 修改节点图之前，先把本地媒体准备为持久工作流素材。通过交互式画布上传每个文件，确认对应素材节点已保存，再向 Agent 提供工作流与素材背景。Agent 随后可调用 workflow_get_canvas，读取已有素材节点及其 ID，并把这些节点连接到图片或视频步骤。这样文件传输使用受支持的画布界面，Workflow MCP 则负责已保存的拓扑、执行与运行状态查询。

Agent 执行顺序

1. 通过交互式画布上传所需本地文件，并确认素材节点已保存。
2. 在 API Keys 页面创建密钥，并配置 Workflow MCP 端点 https://www.namifusion.com/api/v1/workflow/mcp/，密钥放在环境变量或密钥存储中。
3. 调用 workflow_list 并选择目标工作流。
4. 调用 workflow_get_canvas 获取节点、连线、已有素材节点 ID 和当前 revision。
5. 用 workflow_upsert_node 每次新增或更新一个节点，并始终传最新 revision。
6. 每次修改后重新读取画布，过期 revision 会按设计失败。
7. 用 workflow_patch_topology 连接已有素材节点或修改其他明确连线。
8. 调用 workflow_execute，只传本轮需要的 target_node_ids；仅对明确需要再生成的节点使用 rerun_node_ids。
9. 保存 run_id，并调用 workflow_wait_run 或 workflow_get_run 直到终态。
10. 审核完成节点的输出，再执行依赖它们的编辑分支。

1. workflow_list()
2. workflow_get_canvas(workflow_id)
3. workflow_upsert_node(workflow_id, revision, data, node_type, ...)
4. workflow_get_canvas(workflow_id)  # refresh revision
5. workflow_patch_topology(workflow_id, revision, add_edges=[...])
6. workflow_execute(workflow_id, target_node_ids=[...])
7. workflow_wait_run(run_id, timeout_seconds=30, poll_interval_seconds=2)

给 Agent 明确的编辑契约

有效的 Agent 指令应说明交付物、允许使用的素材、目标节点、受保护细节、停止条件和审批边界。例如：“在 WORKFLOW_ID 中读取当前画布。新增一条六秒横版商品展示的文本简报，把现有审核通过的瓶子素材连接到新视频节点，只完成准备，不执行。保持标签文字与瓶身结构。不要删除节点或改动审核主分支。返回新节点 ID、最新 revision 和简要输入摘要。”这项练习特意在付费执行前停止。允许执行时，应明确哪些目标节点可以运行、哪些允许重跑。

Inspect workflow WORKFLOW_ID and its current revision.
Add a brief for a six-second landscape product reveal.
Connect the existing approved bottle asset to a new video node.
Preserve label text and bottle geometry.
Do not execute, delete nodes, or change the approved branch.
Return the new node ID, latest revision, and input summary.

审核运行并安全恢复

每个完成节点都要与输入和通过条件对照。图片检查身份、布局、文字与瑕疵；视频检查首帧保真、随时间的结构、运动、剪接和音频。下游执行前先在画布记录审核结论。revision 过期表示其他写入者已改动画布，应重新读取、核对差异，再用新 token 重试预期修改。如果 workflow_execute 出现不明确的传输失败，应先查询画布和运行状态，因为任务可能已经启动，盲目重试可能重复付费。workflow_wait_run 超时时保留 run_id，之后继续查询；客户端等待超时不代表生成失败。

限制与成本控制

Workflow MCP 调用负责组织画布，但付费生成仍遵循正常工作流执行与积分规则。模型可用性、输入支持、时长、输出质量和耗时会因模型而变。密钥过期或非零月额度耗尽时会被拒绝。HTTP 接口也有限流，遇到 429 应按 Retry-After 等待，不要高频轮询。只执行所需目标，避免重跑已通过的上游节点，并记录 run_id、目标 ID、提示词版本、素材 ID 与审核结果。新节点图应先验证一条短分支，再启动全部镜头。