错误码说明

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

错误码列表

错误码	HTTP 状态码	错误信息	处理建议
29000	400	缺少必需参数	请检查并提供所有必需的参数后重试。
29001	400	参数验证失败	请检查参数格式和取值范围是否符合要求，修正后重试。
29010	400	指定的聊天模型不支持	请参考模型可用列表，使用支持的模型名称。
29011	413	聊天上下文超出最大令牌限制	建议： ・ 减少上下文长度或令牌数 ・ 截断较早的历史记录
29012	429	聊天请求速率限制	建议： ・ 降低请求频率 ・ 实现指数退避策略 ・ 稍后重试
29014	403	当前用户访问此 Agent 受限	用户被限制使用该 Agent，请联系管理员解除限制。
29030	404	Agent 不存在	请检查 agentId 是否正确，或在调用前先创建 Agent。
29031	409	Agent 已存在	请使用其他 agentId，或更新现有的 Agent。
29032	400	Agent 未处于活跃状态	请先激活 Agent 或切换到一个活跃状态的 Agent。
29033	429	应用创建的 Agent 数量超出限制	建议： ・ 删除不再使用的 Agent ・ 提交工单申请更高配额
29034	400	提示模板不存在	请确保提示模板存在，或直接通过 prompt.instructions 提供指令。
29040	404	用户限制记录不存在	请检查用户和 Agent 是否正确，或先添加限制记录。
29041	409	用户限制记录已存在	该用户已被限制，无需重复添加。
29042	429	用户限制记录数量超出配额	建议： ・ 删除不再需要的限制记录 ・ 提交工单申请更高配额
29050	500	内部服务器错误	请稍后重试。如果问题持续存在，请提交工单联系技术支持。

提示

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

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