--- document_id: agent.errors schema_version: 2 parent_document_id: agent.guide section: errors --- # Errors & Recovery / 错误与恢复 Failed requests are not charged. Follow the error's documentation URL and recovery action. 失败请求不扣费。按照错误响应中的 documentation.url 和恢复动作处理。 ## `retry` - [billing_unavailable](https://docs.asklearai.com/zh/errors/billing_unavailable): The billing service is temporarily unavailable and the operation was not charged. / 计费服务暂时不可用，本次操作未扣费。 - [collection_failed](https://docs.asklearai.com/zh/errors/collection_failed): The collection task failed before a valid result was delivered. / 采集任务失败，未交付有效结果。 - [collection_idempotency_key_invalid](https://docs.asklearai.com/zh/errors/collection_idempotency_key_invalid): The collection start request has no valid idempotency key. / 采集启动请求没有有效幂等键。 - [collection_max_credits_invalid](https://docs.asklearai.com/zh/errors/collection_max_credits_invalid): The collection maximum is not a positive integer. / 采集费用上限不是正整数。 - [collection_max_credits_too_low](https://docs.asklearai.com/zh/errors/collection_max_credits_too_low): The supplied maximum is below the estimated collection upper bound. / 提供的费用上限低于采集估价上界。 - [collection_queue_expired](https://docs.asklearai.com/zh/errors/collection_queue_expired): The queued collection job passed its admission deadline. / 排队中的采集任务超过准入截止时间。 - [collection_queue_full](https://docs.asklearai.com/zh/errors/collection_queue_full): The bounded collection queue is temporarily full. / 有界采集队列暂时已满。 - [collection_quote_expired](https://docs.asklearai.com/zh/errors/collection_quote_expired): The collection estimate expired before the task was started. / 采集报价在任务启动前已过期。 - [collection_quote_invalid](https://docs.asklearai.com/zh/errors/collection_quote_invalid): The collection quote does not match the requested task input. / 采集报价与请求任务输入不匹配。 - [collection_reservation_expired](https://docs.asklearai.com/zh/errors/collection_reservation_expired): The Credits reservation expired before collection completed. / 采集完成前 Credits 预留已过期。 - [collection_reservation_unavailable](https://docs.asklearai.com/zh/errors/collection_reservation_unavailable): Credits could not be reserved for the collection task. / 无法为采集任务预留 Credits。 - [collection_timeout](https://docs.asklearai.com/zh/errors/collection_timeout): The collection task exceeded its execution deadline. / 采集任务超过执行截止时间。 - [concurrency_limited](https://docs.asklearai.com/zh/errors/concurrency_limited): Wait for an in-flight request to finish before retrying once. / 等待进行中的请求完成后再重试一次。 - [idempotency_failed](https://docs.asklearai.com/zh/errors/idempotency_failed): The earlier idempotent operation failed and has no downloadable result. / 此前的幂等操作失败，没有可下载结果。 - [idempotency_in_progress](https://docs.asklearai.com/zh/errors/idempotency_in_progress): An identical request with this idempotency key is still running. / 使用该幂等键的相同请求仍在执行。 - [pricing_snapshot_mismatch](https://docs.asklearai.com/zh/errors/pricing_snapshot_mismatch): The execution plan no longer matches its approved pricing snapshot. / 执行计划已不再匹配获批时的计价快照。 - [pricing_unavailable](https://docs.asklearai.com/zh/errors/pricing_unavailable): Pricing could not be finalized, so no result was delivered or charged. / 计价未能完成，因此没有交付结果，也没有扣费。 - [query_queue_full](https://docs.asklearai.com/zh/errors/query_queue_full): Wait for Retry-After and retry the same request once. / 等待 Retry-After 后对同一请求重试一次。 - [query_queue_timeout](https://docs.asklearai.com/zh/errors/query_queue_timeout): The request timed out while waiting for query capacity. / 请求在等待查询容量时超时。 - [rate_limited](https://docs.asklearai.com/zh/errors/rate_limited): Wait for Retry-After before retrying; never retry in a tight loop. / 等待 Retry-After 指定的时间后再重试，禁止紧密循环重试。 - [task_not_supported](https://docs.asklearai.com/zh/errors/task_not_supported): The requested recipe is unavailable; this does not mean the analytical query is unsupported. / 请求的 recipe 不存在，但不代表分析查询不受支持。 - [upstream_busy](https://docs.asklearai.com/zh/errors/upstream_busy): Retry once after the returned delay; then narrow the query or stop. / 按返回的等待时间重试一次；仍失败则缩小查询或停止。 ## `narrow_query` - [cap_exceeded](https://docs.asklearai.com/zh/errors/cap_exceeded): The approved or configured credit cap is below the current upper bound. / 已同意或已配置的 Credits 上限低于当前费用上界。 - [collection_input_invalid](https://docs.asklearai.com/zh/errors/collection_input_invalid): The collection input fails the task's declared contract. / 采集输入不符合任务声明的契约。 - [collection_task_not_found](https://docs.asklearai.com/zh/errors/collection_task_not_found): The requested task code is not registered. / 请求的 task_code 未注册。 - [data_range_unavailable](https://docs.asklearai.com/zh/errors/data_range_unavailable): The request includes dataset months that have not been published for serving. / 请求包含尚未发布到查询服务的数据月份。 - [invalid_query](https://docs.asklearai.com/zh/errors/invalid_query): Correct or narrow the request using the returned validation details. / 根据返回的校验信息修正或缩小请求。 - [query_too_broad](https://docs.asklearai.com/zh/errors/query_too_broad): The query exceeded the server's physical work hard limit. / 查询超过服务端物理工作硬上限。 - [unknown_field](https://docs.asklearai.com/zh/errors/unknown_field): Replace the guessed field with one returned by describe. / 将猜测字段改为 describe 返回的字段。 ## `ask_user` - [approval_stale](https://docs.asklearai.com/zh/errors/approval_stale): The approved query plan changed before execution and must be approved again. / 执行前查询计划已变化，需要重新确认。 - [dictionary_unavailable](https://docs.asklearai.com/zh/errors/dictionary_unavailable): Ask for an exact value or choose another searchable field; do not guess. / 请用户提供精确值或改用其他可搜索字段，不要猜测。 - [invalid_reference](https://docs.asklearai.com/zh/errors/invalid_reference): Ask for an exact supported entity reference. / 请用户提供受支持的精确实体引用。 - [max_credits_required](https://docs.asklearai.com/zh/errors/max_credits_required): The operation's safe upper bound exceeds the key's auto-run threshold; obtain explicit approval before executing. / 本次操作的安全费用上界超过密钥自动执行阈值；执行前需要用户明确同意。 ## `stop` - [collection_external_unknown](https://docs.asklearai.com/zh/errors/collection_external_unknown): The provider-side outcome is unknown after the request crossed the provider boundary. / 请求跨过供应商边界后，供应商侧结果未知。 - [collection_result_invalid](https://docs.asklearai.com/zh/errors/collection_result_invalid): The provider result did not satisfy the task contract. / 供应商结果不符合任务契约。 - [collection_task_unavailable](https://docs.asklearai.com/zh/errors/collection_task_unavailable): The requested collection task is not currently available. / 请求的采集任务当前不可用。 - [collection_task_version_unavailable](https://docs.asklearai.com/zh/errors/collection_task_version_unavailable): The requested task version is no longer available. / 请求的任务版本已不可用。 - [collection_unavailable](https://docs.asklearai.com/zh/errors/collection_unavailable): Collection is not enabled for this environment or key. / 当前环境或 Key 未启用采集。 - [download_cap_exceeded](https://docs.asklearai.com/zh/errors/download_cap_exceeded): Stop because the monthly download traffic cap has been reached. / 本月下载流量已达到上限时停止。 - [forbidden](https://docs.asklearai.com/zh/errors/forbidden): Stop and explain that the authenticated tenant lacks access. / 停止并说明当前租户没有访问权限。 - [idempotency_conflict](https://docs.asklearai.com/zh/errors/idempotency_conflict): The idempotency key was already used for a different payload. / 该幂等键已用于另一组请求参数。 - [idempotency_replay](https://docs.asklearai.com/zh/errors/idempotency_replay): This request already finished and was not executed or charged again. / 该请求已经完成，本次没有重复执行或扣费。 - [insufficient_credits](https://docs.asklearai.com/zh/errors/insufficient_credits): Stop before querying and explain that more credits are required. / 查询前停止，并说明需要更多 Credits。 - [not_found](https://docs.asklearai.com/zh/errors/not_found): Stop because the referenced public resource does not exist or is no longer available. / 引用的公共资源不存在或已不可用时停止。 - [pricing_unconfigured](https://docs.asklearai.com/zh/errors/pricing_unconfigured): Stop because the server cannot produce a valid price for this request. / 服务端无法为该请求生成有效价格时停止。 - [unauthorized](https://docs.asklearai.com/zh/errors/unauthorized): Stop because the MCP credential is missing, invalid, disabled, or revoked. / MCP 凭据缺失、无效、停用或已吊销时停止。 - [value_search_unsupported](https://docs.asklearai.com/zh/errors/value_search_unsupported): Do not guess or repeatedly search an unsupported field. / 不要猜测或循环搜索不支持的字段。