> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acturehub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 任务状态与轮询

> 正确处理 BP-Agent 异步任务状态和终态。

通过 `GET /api/open/runs/{run_id}` 查询任务详情。

| 状态             | 是否终态 | 建议行为              |
| -------------- | ---- | ----------------- |
| `INITIALIZING` | 否    | 等待后重试             |
| `QUEUED`       | 否    | 等待后重试             |
| `RUNNING`      | 否    | 等待后重试             |
| `REVIEWING`    | 否    | 等待人工审核完成          |
| `SUCCEEDED`    | 是    | 读取 `output_files` |
| `FAILED`       | 是    | 检查结构化失败信息，不要盲目重试  |
| `CANCELED`     | 是    | 按业务需要创建新任务        |

## 轮询建议

* 使用固定间隔或指数退避，避免高频请求。
* 收到 `429` 时根据退避策略重试。
* 到达终态后停止轮询。
* `REVIEWING` 可能持续较长时间，不应判定为失败。
* 网络错误不代表任务失败，应继续查询原 `run_id`。

<Warning>
  不要通过重复 `POST /api/open/runs` 代替状态查询，否则可能重复消耗配额或产生多条任务记录。
</Warning>