异步任务、错误与重试

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

处理异步任务

  1. 提交任务后保存返回的任务或工作流作业标识。

  2. 使用对应的任务或工作流作业对象读取最新状态和结果。

  3. 状态进入终态后停止轮询,并根据成功、失败或取消结果执行后续处理。

  4. 达到应用的等待上限时,向调用方返回任务标识;不要把本地超时当成平台已停止。

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

判断是否重试

情况

建议

身份认证、权限或输入错误

修正凭据、权限或输入后再提交,不自动重试。

资源不存在或作用域不匹配

检查工作区和资源 ID 的来源,不自动重试。

网络错误或本地超时

先使用已保存的标识查询原任务状态,再决定是否重试。

任务或工作流作业失败

查看任务或工作流作业结果,确认失败原因、已产生的数据影响和重试条件。

记录排查信息

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

相关页面

最后更新于