# 性能与长任务

> 正确等待长时间 Agent、图片、视频、音频和浏览器任务，避免重复提交并确认最终产物。

- 原文: https://www.getbeav.com/docs/troubleshooting/long-running-tasks

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

## 先判断状态

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

## 不要重复提交

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

## 缩小任务输入

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

## 完成后核对

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

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

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