跳到主要内容

错误码说明（Agent）

本文列出了 Agent 相关接口可能返回的错误码，并提供错误含义和处理建议。

错误码列表​

错误码HTTP 状态码错误信息处理建议
29000400缺少必需参数请检查并提供所有必需的参数后重试。
29001400参数验证失败请检查参数格式和取值范围是否符合要求，修正后重试。
29010400指定的聊天模型不支持请参考模型可用列表，使用支持的模型名称。
29011413聊天上下文超出最大令牌限制建议：
1. 减少上下文长度或令牌数
2. 截断较早的历史记录
29012429聊天请求速率限制建议：
1. 降低请求频率
2. 实现指数退避策略
3. 稍后重试
29030404Agent 不存在请检查 agentId 是否正确，或在调用前先创建 Agent。
29031409Agent 已存在请使用其他 agentId，或更新现有的 Agent。
29032400Agent 未处于活跃状态请先激活 Agent 或切换到一个活跃状态的 Agent。
29033429应用创建的 Agent 数量超出限制建议：
1. 删除不再使用的 Agent
2. 提交工单申请更高配额
29034400提示模板不存在请确保提示模板存在，或直接通过 prompt.instructions 提供指令。
29050500内部服务器错误请稍后重试。如果问题持续存在，请提交工单联系技术支持。
提示

如遇到错误码 29012（速率限制），建议实现以下重试策略：

  1. 首次重试等待 1 秒
  2. 之后每次重试等待时间翻倍（2秒、4秒、8秒...）
  3. 设置最大重试次数（如 5 次）和最大等待时间（如 32 秒）
最后于 更新