性能与长任务

图片、视频、音频、长文分析和多步骤 Agent 任务都可能需要较长时间。等待期间应观察状态和事件，而不是用重复提交判断系统是否工作。

先判断状态

• queued：任务已经接收，等待执行。
• running：任务正在执行。
• awaiting_approval：需要用户处理审批。
• completed：执行完成，继续核对产物。
• failed：读取具体错误后再决定是否重试。
• cancelled 或 expired：任务不再继续，需要重新确认输入后创建新任务。

不要重复提交

同一提示词重复提交可能产生重复费用、重复媒体和多个难以区分的会话。外部 Agent 应轮询原 run 的事件，并通过 cursor 读取新增记录。

缩小任务输入

• 只传当前任务需要的素材引用。
• 先确定脚本和分镜，再开始视频生成。
• 先确定选中的参考图，再生成批量媒体。
• 大文件保存在 Beav，Agent 使用引用而不是内联内容。

完成后核对

任务显示 completed 后，继续检查：

1. 需要的 artifact 是否存在。
2. 文件或稿件是否能在 Beav 中打开。
3. 结果是否关联到正确工作空间和项目。
4. 后续会话是否保存了 session ID。

状态完成但产物不可读时，不应报告成功。先读取 artifact 错误或任务事件，再决定恢复方式。