常见问题
1、Windows 系统报错configuration failed
出现这个报错时, 可以右键选择“以管理员权限打开”。

2、每次更新版本后建议『重置提供商和模型』
因为可能会有部分模型版本的更新。

3、如果有需要AgentBox执行代码的任务,可以提前下载Python环境(否则对话中遇到此类任务会回复无法执行,请下载Python环境)
下载地址:https://pythonlang.cn/downloads/

4、网络原因报错
- 报错:503 Servic Unavalilable
Ran into this error: Server error:Server error(503 Servic Unavalilable):.Please retryifyouthink this isatransient or recoverable error.
👉网络问题,请切换网络后重试
- 报错:error sending request for url
Ran into this error: Request failed:error sending request for url ( [https://llm-provider.xm-opt.com/v1/chat/completions](https://llm-provider.xm-opt.com/v1/chat/completions) )(failed to connect to IIm-provider.xm-opt.com).
Please retry if you think this is a transient or recoverable error.
👉访问模型服务时,遇到了网络问题,无法连接,可以刷新重试;最常见的是vpn问题,请切换网络后重试。
5、报错:Budget has been exceeded
Ran into this error: Request failed: Bad request (400): Budget has been exceeded! Current cost: 5.033578474869, Max budget: 5.0.
Please retry if you think this is a transient or recoverable error.
👉超过当日限额,请第二天后重试
6、报错:Failed to Load Session
- Stream error
Failed to Load Session
Stream error: Failed to read session:data did not match any variantof untagged enum ResultFormat at line 1 column 222
👉若遇到该问题,请删除当前对话,重新尝试新对话。但之后仍有可能遇到😭,只有不断重试,或更换提问。后续版本将更新
- missing provider

👉 问题说明:
这种情况通常出现在苹果 Mac 电脑上,是因为你的用户文件夹没有"写入"权限,导致程序无法正常保存配置文件。
👉 解决办法:
- 先检查权限:打开终端,输入下面这行命令并回车:
ls -ln ~/.config
- 看结果:你会看到类似这样的一串字符:
drwxr-xr-x@ 19 501 20 608 4月 17 16:10 .config
重点关注最前面字符的第 3 个(从左往右数,第 1 个是 d,第 3 个是 w 或 -):
如果是w,说明有写入权限,问题不在这里 如果是 -,说明缺少写入权限,需要执行下一步
- 授权修复:在终端输入以下命令并回车:
chmod u+w ~/.config
这个命令的意思是:"给当前用户添加对这个文件夹的写入权限"。
- 再试一次:授权完成后,重启agentbox,应该就能正常使用了。
7、报错:Bad request
Ran into this error: Request failed: Bad request (400): litellm.BadRequestError: Vertex_ai_betaException BadRequestError - b'‹\n "error": In "code": 400, \n "message": "Invali‹
JSON payload received. Unexpected token. \n49, 294.57, 288.97, NaN, 301.02, 389.08, \n ^", \n "status": "INVALID_ARGUMENT"\n J\n}\n'.
Please retry if you think this is a transient or recoverable error.
👉可尝试以下任意一种处理方式
- 主动纠正模型推理过程。 发送“数据中有NaN, 请注意做数据清洗或异常处理” 。
- 切换模型重发消息。
- 新开对话, 且切换模型后重发消息。
8、API问题:User ID not found for APl key
Ran into this error: Authentication error: Authentication failed.Status: 401 Unauthorized. Response: C"detail:"User ID not found for APl key')
Please retry if you think this is a transient or recoverable error.
👉API填写错误,请检查是否误输空格,确认无误后重试