Agent Zero 报 Invalid model ID 错误怎么排查【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero在 Agent Zero 的 Settings 里填好 Provider 和 Model Name、点完 Save 之后发消息却收到 Invalid model ID 报错——这是 排查指南 中明确列出的常见问题。官方文档给出的方向只有一个模型命名格式是按 Provider 区分的对某一个 Provider 正确的写法换到另一个 Provider 可能就是错的。排查顺序是先确认你选的 Provider再核对模型名的格式改对后保存并重试。错误从哪里来Provider 与模型名不匹配故障排查 FAQ 对 Invalid model ID 的说明是Verify theproviderandmodel naming. For example,openai/gpt-5.3is correct for OpenRouter, butincorrectfor the native OpenAI provider, which goes without prefix.也就是说同一个模型在不同 Provider 下的写法可能完全不同。文档给了另一组对照Anthropic Provider 下用claude-sonnet-4-5OpenRouter 下用anthropic/claude-sonnet-4-5。在 Web UI 中打开侧边栏齿轮图标的Settings页面检查Main Model、Utility Model、Embedding Model各区块的Provider下拉和Model Name输入框。你要核对的就是这两个值的组合Model Name 是否符合所选 Provider 要求的格式。改完必须点Save才会生效。对照各 Provider 的命名格式安装指南 中 “Model Naming by Provider” 一节的官方对照表Provider模型名格式文档示例OpenAI仅模型名不带前缀claude-sonnet-4-5OpenRouter大多需要 Provider 前缀anthropic/claude-sonnet-4-5Ollama仅模型名gpt-oss:20boMLX/v1/models中 API 可见的模型名Qwen3-0.6B-4bitllama.cpp/v1/models中 API 可见的模型名或--alias指定的别名local-ggufvLLMHugging Face 模型 ID 或服务别名Qwen/Qwen2.5-1.5B-Instruct注意表中对 OpenRouter 的表述是 “Provider prefix mostly required”大多需要前缀而不是绝对规则所以即使前缀格式看起来正确仍要回 Provider 官方站点核实。文档对云端 Provider 的通用建议是去 Provider 官网确认命名格式或直接搜索 “name-of-ai-model model naming”用你的模型名替换尖括号部分。本地模型服务以/v1/models返回的模型 ID 为准本地模型最容易踩坑的是“凭记忆写模型名”。文档的做法是先确认服务实际提供了哪个模型再把同一个名字填进 SettingsOllama模型按 Ollama 期望的模型名引用形如llama3.2或qwen2.5:7b。在宿主机上用以下命令列出已下载的模型ollama list确认目标模型在其中再到 Settings 的 Chat model、Utility model 或 Embedding model 区块选择Ollama作为 Provider写入模型名点 Save。llama.cpp启动时可以用--alias指定一个短而稳定的名字llama-server -m ~/models/model.gguf --port 8080 --alias local-gguf文档给出的验证步骤是确认http://localhost:8080/v1/models返回你的模型然后在 Settings 中选择llama.cpp作为 Provider填入/v1/models显示的模型 ID或者--alias传的别名如local-gguf点 Save。vLLM先确认http://localhost:8000/v1/models返回被服务的模型然后在 Settings 中选择vLLM作为 Provider填入模型列表端点返回的模型 ID。文档同时提示vLLM 默认一次只服务一个模型Chat 和 Utility 槽位要用生成模型如果需要 vLLM 提供 embeddings要另起一个支持 embedding 的 vLLM 服务。oMLX在 oMLX 的模型列表或 dashboard 里能看到模型名直接把这个 API 可见的模型名填入 SettingsProvider 选oMLX。相邻问题容器里连不到宿主机的模型服务如果你用的是 Docker 部署、模型服务跑在宿主机上需要区分一个相邻但不同的故障API base URL 中的localhost和127.0.0.1指向的是 Agent Zero 容器本身不是宿主机。文档给出的处理方式是优先使用http://host.docker.internal:端口macOS 的 Docker Desktop 自动提供该主机名随附的 Docker Compose 文件在 Linux 上也做了映射或默认 Linux 网桥下的宿主机网关地址如http://172.17.0.1:端口如果模型服务只监听宿主机 loopback127.0.0.1:端口经网关仍然不可达需要把服务改为监听0.0.0.0这类容器可达的地址并把端口限制给受信客户端。这一项文档放在模型服务配置一节内但它描述的是“连不上服务”的连通性问题不等同于模型名格式错误当模型名已按上表核对无误时再检查这里。完成判断按文档给出的方式收束排查云端 Provider模型名已与 Provider 官网要求的格式核对一致Settings 已点 Save本地 Provider/v1/models或 Ollama 的ollama list返回的模型 ID 与 Settings 中填写的名字逐字一致模型服务可达性确认本地服务从 Agent Zero 所在环境能访问到正确的地址。条件满足后重新发送消息验证如果仍报同样的错误文档给出的下一步动作是回到 Provider 官网再核一次该模型的命名格式而不是继续改 Agent Zero 侧的其他配置。参考文档故障排查与 FAQInvalid model ID 条目安装指南Model Naming by Provider 与本地模型配置【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Agent Zero 报 “Invalid model ID“ 错误怎么排查？
Agent Zero 报 Invalid model ID 错误怎么排查【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero在 Agent Zero 的 Settings 里填好 Provider 和 Model Name、点完 Save 之后发消息却收到 Invalid model ID 报错——这是 排查指南 中明确列出的常见问题。官方文档给出的方向只有一个模型命名格式是按 Provider 区分的对某一个 Provider 正确的写法换到另一个 Provider 可能就是错的。排查顺序是先确认你选的 Provider再核对模型名的格式改对后保存并重试。错误从哪里来Provider 与模型名不匹配故障排查 FAQ 对 Invalid model ID 的说明是Verify theproviderandmodel naming. For example,openai/gpt-5.3is correct for OpenRouter, butincorrectfor the native OpenAI provider, which goes without prefix.也就是说同一个模型在不同 Provider 下的写法可能完全不同。文档给了另一组对照Anthropic Provider 下用claude-sonnet-4-5OpenRouter 下用anthropic/claude-sonnet-4-5。在 Web UI 中打开侧边栏齿轮图标的Settings页面检查Main Model、Utility Model、Embedding Model各区块的Provider下拉和Model Name输入框。你要核对的就是这两个值的组合Model Name 是否符合所选 Provider 要求的格式。改完必须点Save才会生效。对照各 Provider 的命名格式安装指南 中 “Model Naming by Provider” 一节的官方对照表Provider模型名格式文档示例OpenAI仅模型名不带前缀claude-sonnet-4-5OpenRouter大多需要 Provider 前缀anthropic/claude-sonnet-4-5Ollama仅模型名gpt-oss:20boMLX/v1/models中 API 可见的模型名Qwen3-0.6B-4bitllama.cpp/v1/models中 API 可见的模型名或--alias指定的别名local-ggufvLLMHugging Face 模型 ID 或服务别名Qwen/Qwen2.5-1.5B-Instruct注意表中对 OpenRouter 的表述是 “Provider prefix mostly required”大多需要前缀而不是绝对规则所以即使前缀格式看起来正确仍要回 Provider 官方站点核实。文档对云端 Provider 的通用建议是去 Provider 官网确认命名格式或直接搜索 “name-of-ai-model model naming”用你的模型名替换尖括号部分。本地模型服务以/v1/models返回的模型 ID 为准本地模型最容易踩坑的是“凭记忆写模型名”。文档的做法是先确认服务实际提供了哪个模型再把同一个名字填进 SettingsOllama模型按 Ollama 期望的模型名引用形如llama3.2或qwen2.5:7b。在宿主机上用以下命令列出已下载的模型ollama list确认目标模型在其中再到 Settings 的 Chat model、Utility model 或 Embedding model 区块选择Ollama作为 Provider写入模型名点 Save。llama.cpp启动时可以用--alias指定一个短而稳定的名字llama-server -m ~/models/model.gguf --port 8080 --alias local-gguf文档给出的验证步骤是确认http://localhost:8080/v1/models返回你的模型然后在 Settings 中选择llama.cpp作为 Provider填入/v1/models显示的模型 ID或者--alias传的别名如local-gguf点 Save。vLLM先确认http://localhost:8000/v1/models返回被服务的模型然后在 Settings 中选择vLLM作为 Provider填入模型列表端点返回的模型 ID。文档同时提示vLLM 默认一次只服务一个模型Chat 和 Utility 槽位要用生成模型如果需要 vLLM 提供 embeddings要另起一个支持 embedding 的 vLLM 服务。oMLX在 oMLX 的模型列表或 dashboard 里能看到模型名直接把这个 API 可见的模型名填入 SettingsProvider 选oMLX。相邻问题容器里连不到宿主机的模型服务如果你用的是 Docker 部署、模型服务跑在宿主机上需要区分一个相邻但不同的故障API base URL 中的localhost和127.0.0.1指向的是 Agent Zero 容器本身不是宿主机。文档给出的处理方式是优先使用http://host.docker.internal:端口macOS 的 Docker Desktop 自动提供该主机名随附的 Docker Compose 文件在 Linux 上也做了映射或默认 Linux 网桥下的宿主机网关地址如http://172.17.0.1:端口如果模型服务只监听宿主机 loopback127.0.0.1:端口经网关仍然不可达需要把服务改为监听0.0.0.0这类容器可达的地址并把端口限制给受信客户端。这一项文档放在模型服务配置一节内但它描述的是“连不上服务”的连通性问题不等同于模型名格式错误当模型名已按上表核对无误时再检查这里。完成判断按文档给出的方式收束排查云端 Provider模型名已与 Provider 官网要求的格式核对一致Settings 已点 Save本地 Provider/v1/models或 Ollama 的ollama list返回的模型 ID 与 Settings 中填写的名字逐字一致模型服务可达性确认本地服务从 Agent Zero 所在环境能访问到正确的地址。条件满足后重新发送消息验证如果仍报同样的错误文档给出的下一步动作是回到 Provider 官网再核一次该模型的命名格式而不是继续改 Agent Zero 侧的其他配置。参考文档故障排查与 FAQInvalid model ID 条目安装指南Model Naming by Provider 与本地模型配置【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考