# 异步任务、错误与重试

导入、导出、工作流运行和智能体调用等操作可能在请求提交后继续运行。SDK 返回的创建结果、工作流作业 ID（`execution_id`）或任务 ID 用于后续查询；它们不是任务已完成的信号。

## 处理异步任务

1. 提交任务后保存返回的任务或工作流作业标识。
2. 使用对应的任务或工作流作业对象读取最新状态和结果。
3. 状态进入终态后停止轮询，并根据成功、失败或取消结果执行后续处理。
4. 达到应用的等待上限时，向调用方返回任务标识；不要把本地超时当成平台已停止。

轮询间隔、截止时间和重试预算由应用决定。避免在未确认原任务状态时重复提交可能产生副作用的操作。

## 判断是否重试

| 情况 | 建议 |
| --- | --- |
| 身份认证、权限或输入错误 | 修正凭据、权限或输入后再提交，不自动重试。 |
| 资源不存在或作用域不匹配 | 检查工作区和资源 ID 的来源，不自动重试。 |
| 网络错误或本地超时 | 先使用已保存的标识查询原任务状态，再决定是否重试。 |
| 任务或工作流作业失败 | 查看任务或工作流作业结果，确认失败原因、已产生的数据影响和重试条件。 |

## 记录排查信息

记录任务或工作流作业 ID、资源 ID、状态和安全的错误摘要。不要记录个人访问令牌、连接器密钥、文件内容或完整业务负载。需要协助时，使用已保存的标识关联对应的任务或请求。

## 相关页面

- [连接器、导入与导出任务](guides/connectors-import-export)
- [工作流、WorkItem 与数据血缘](guides/workflows-workitems-lineage)
- [智能体调用和任务查询](guides/agents-a2a)