---
document_id: agent.paths.agent.recovery
schema_version: 2
parent_document_id: agent.paths.agent
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Errors and task recovery / 错误与任务恢复

## Recover the original task and results / 先找回原任务与结果

有原任务或结果 ID 时先读取；未收到响应不代表未执行。

Read an existing task or result first; a missing response does not prove the request never executed.

批量中断后按已保存的对象 ID、页码或游标继续缺失范围，不从头遍历。遵守响应中的等待时间与终态，用户要求停止时按当前合同取消未开始的工作。

Resume missing bulk scope from saved object IDs, pages or cursors instead of restarting. Follow waiting hints and terminal states; when asked to stop, cancel unstarted work according to the current contract.

| Existing identifier / 已有标识 | Read with / 读取方式 |
| --- | --- |
| Task reference returned by remote Task / 远程 Task 返回的任务引用 | task; use the parameter name in its current schema. / task；参数名以当前工具 schema 为准。 |
| Collection job_id / 采集 job_id | get_collection_job. / get_collection_job。 |
| Query query_id / 查询 query_id | results. / results。 |

## Choose the next action from the error / 根据错误修正下一步

输入或契约错误先修正；对象有实质歧义时向用户确认；授权、预算或余额问题按响应提示处理。临时错误只在允许重试时按等待提示继续，保留原请求身份。

Correct input or contract errors, clarify material ambiguity, and follow authorization, budget or balance instructions. Retry transient errors only when permitted, following waiting hints and preserving the original request identity.

需要具体 code 的含义时读取[错误参考](https://docs.asklear.cn/errors)或错误返回的 documentation 链接。MCP 未连接才回到[连接与验证](https://docs.asklear.cn/agent/getting-started)，不要把所有取数失败都当连接故障。

For a specific code, read the [error reference](https://docs.asklear.cn/en/errors) or the returned documentation link. Return to [setup](https://docs.asklear.cn/en/agent/getting-started) only for connection failures, rather than treating every data error as a broken connection.

## Common recovery decisions / 常见恢复判断

429 按 Retry-After 等待；范围或字段错误先修正。query_too_broad 若来自 search_values，缩短关键词通常不能降低扫描量，应按工具参考改用分组或代表商品定位。 [配额规则](https://docs.asklear.cn/agent/reference#request_limits)。

For 429, follow Retry-After. Correct range or field errors before retrying. If query_too_broad comes from search_values, shortening keywords usually does not reduce scanned data; use grouping or representative products as described in the tool reference. [Quota reference](https://docs.asklear.cn/en/agent/reference#request_limits).

bundle 可能部分成功，只处理明确失败项。结果未知的付费调用不自动重放；collection_external_unknown 时停止，先读已知 job_id，没有标识时在新尝试前确认。 [恢复规则](https://docs.asklear.cn/agent/reference#cost_and_recovery)。

Bundles can partially succeed; handle only known failures. Do not automatically replay a paid call with an unknown outcome. For collection_external_unknown, stop and read a known job_id, or confirm before a new attempt if no identifier exists. [Recovery rules](https://docs.asklear.cn/en/agent/reference#cost_and_recovery).

审批结果不是业务数据。按返回提示保留原 operation、input 和幂等键恢复；费用批准字段放工具 schema 指定的位置。详见[工具参考](https://docs.asklear.cn/agent/reference)。

Approval controls are not business data. Follow returned instructions with the original operation, input and idempotency key; put approval fields where the tool schema requires. See the [tool reference](https://docs.asklear.cn/en/agent/reference).
