Agent Zero 模型配置：最常见的 4 个卡点，逐个拆到跑通-平芜编程栈

Agent Zero 模型配置：最常见的 4 个卡点，逐个拆到跑通

【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero

装好 Agent Zero 之后，最容易卡住的一般就是模型配置：密钥在哪填？端点地址写什么？本地模型为什么总说找不到模型？这篇不按设置页逐项走流程，直接按你最可能撞上的 4 个卡点来讲，读完配置基本就齐了。

卡点一：设置页选项卡太多，从哪下嘴

Web UI 侧边栏里找到带齿轮图标的 Settings，点进去。里面是一排选项卡，和模型配置直接相关的是 Chat Model（主聊天模型）、API Keys（各家提供商密钥）和 Authentication（登录凭证）。Utility model、Embedding Model 这些可以先放一放，等主模型跑起来再回头收拾。

卡点二：Agent Zero Chat Model 端点连不上，Docker 经典病例

设置页打开了，但第一个翻车点通常不在页面，而在端点。关键背景：Agent Zero 本身跑在 Docker 容器里，容器内的 localhost 指向容器自己，不是跑着 Ollama 的宿主机。所以端点一栏要写成 http://host.docker.internal:11434，11434 是 Ollama 的默认端口。Agent Zero 本地模型接入，说白了就是绕对这一个域名。

端点填错的两种典型表现：一是请求超时，模型名没错、服务也没停，就是容器摸不到宿主机；二是连接被拒，端口写对了，但 Ollama 压根没启动。先查服务在不在，再查端口对不对，最后核对有没有把 host.docker.internal 写全。

卡点三：Ollama 模型名对不上，报"找不到"

端点通了算过半场，另一半是模型名。打开 Chat Model 卡，provider 下拉里挑提供商（比如 Ollama），模型名一栏要和服务端的名字逐字一致，例如 llama3.2 或 qwen2.5:7b，错一个字符都会报找不到。

名字下面两个参数也值得看一眼：上下文长度是单次请求的 token 上限，示例值 8192；上下文窗口比例决定聊天历史能占窗口多大份额，示例是 0.65，剩下的留给系统提示、RAG 和回复。历史长就调高一点，历史短就别浪费。

Agent Zero 本地模型的名字，先查再抄

本地模型别靠记忆。在宿主机终端跑ollama list列出已下载的模型，ollama pull <模型名>下载新模型。列表里出现了，再把它抄进设置页。端点和名字都落位，Agent Zero 接入 Ollama 就算完工。

字段	位置	写什么
Provider	Chat Model 卡	模型来源，如 Ollama
模型名	Chat Model 卡	与提供商侧完全一致，如 qwen2.5:7b
端点 URL	Chat Model 卡	容器内用 http://host.docker.internal:11434
上下文长度	Chat Model 卡	单次请求 token 上限，如 8192
上下文窗口比例	Chat Model 卡	历史占用份额，如 0.65
温度	Chat Model 卡	0 偏稳定，1 偏随机

小模型只解释工具、不真正调用工具的话，那是另一件事，看 Local Model Tool Use 里的 Tiny Local profile。

卡点四：Agent Zero API 密钥设置与 OAuth 流程

本地路线走完，换云端模型。打开 API Keys 卡，把在用的提供商逐个填上密钥。如果你的提供商走账号体系——GitHub Copilot、Codex 这类——不需要贴密钥，系统会引导你走 OAuth 登录流程，在浏览器里确认即可。

[!TIP] 🔑 密钥就当家门钥匙加门禁卡：端点是门牌号，密钥是刷卡凭证，卡只发给你一张。别提交进仓库、别贴进截图、别甩给聊天软件。泄露了就去提供商后台吊销重发。

门还开着：Web UI 账号与 Docker root 密码

模型接好了、密钥存好了，可大门还敞着。打开 Authentication 卡：UI Login 设 Web UI 用户名，UI Password 设登录密码，root Password 改 Docker 容器内 Linux root 密码（可用来 SSH 进容器，安装时随机生成）。Agent Zero 要是挂在局域网甚至公网上，这三项就是最后一道门。