---
document_id: agent.error.idempotency_failed
schema_version: 1
---

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

# idempotency_failed

Recovery / 恢复动作: `retry`
Billing / 计费: `not_charged`

- Cause / 原因: A historical failed reservation still owns the supplied idempotency key. / 历史失败预留仍占用当前幂等键。
- Agent: Do not open the returned query_id as a result; retry once with a new idempotency key. / 不要把返回的 query_id 当作结果打开；使用新的幂等键重试一次。
- User / 用户: Retry the operation with a new key, or contact support if it repeats. / 使用新幂等键重试；若重复发生，请联系支持。