3 步配好 Agent Zero 模型配置：Ollama 本地模型与 API 密钥一次接通
【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero
Agent Zero 模型配置只需要看一个页面。Agent Zero 是一款能统一接入和管理多种大语言模型的 AI 框架。跟着本文三步——挑模型、填凭证、调端点与上下文——即可配好 Agent Zero Ollama 配置与云端模型。
动手前，先确认三件事
✅ 本地模型：确认 Ollama 已安装并在运行，模型已下载。用ollama list查看可用模型；缺哪个就用ollama pull <模型名>拉取。
云端模型：确认对应厂商的 API 密钥已在手。
如果你用 Docker 跑 Agent Zero，要填的端点指向宿主机，而不是localhost。
[!NOTE] 本地模型的名字要和
ollama list里的显示一字不差，tag 和大小写都算数。差一个字符就找不到。
第一步：选定提供商与模型
点击 Web UI 侧边栏的齿轮图标 Settings，进入设置页。页面里有代理配置、聊天模型、工具模型、嵌入模型等选项卡。
点击 “Chat Model” 选项卡，从下拉菜单里选提供商（本文以 Ollama 为例），再在模型字段填入模型名。Agent Zero 本地模型示例：llama3.2、qwen2.5:7b。
第二步：填入 API 密钥与登录凭证
切到 “API Keys” 选项卡，依次完成：
- 填入对应厂商的 API 密钥。Agent Zero API 密钥都集中在这个标签页。
- 设置 Web UI 登录用户名和密码。
- 需要 SSH 进容器的话，再填 Docker 容器的 root 密码。
- 点击 “Save”。
GitHub Copilot 这类 OAuth 服务不用手填密钥，系统会拉起认证引导流程，跟着提示完成授权即可。
[!CAUTION] API 密钥和两组密码都是敏感信息，别外传，也别提交进任何代码仓库。
第三步：端点 11434 与上下文参数
回到 “Chat Model” 选项卡，填写 API 端点。Agent Zero 端点 11434：Ollama 跑在宿主机、Agent Zero 跑在 Docker 里时，填http://host.docker.internal:11434。
再调整上下文长度和上下文窗口分配比例（窗口留给系统提示与历史的比例）。参数填完，点击 “Save” 生效。
保存后验证：不响就按顺序查
回到主界面，新开一个聊天，发一条测试消息。代理正常应答，配置就算完成。
⚠️ 不响应或报错，按这个顺序排查：
- 模型名：和
ollama list的输出逐字比对。 - 端点：Ollama 是否在运行；端点里是不是还写着
localhost（Docker 环境要换成host.docker.internal）。 - 认证：Copilot 这类 OAuth 服务是否未授权，重新走一遍认证流程。
[!TIP] 连不上多半栽在模型名不一致或端点主机写错这两处，先查它们，能解决大多数问题。
从 Ollama 到云端模型，Agent Zero 模型配置就是这几件事：挑模型、填凭证、调端点与上下文，保存后验证。模型预设、多提供商管理等进阶内容，看 docs/guides/model-presets.md；想查提供商怎么加载，翻 helpers/providers.py。
【免费下载链接】agent-zeroAgent Zero AI framework项目地址: https://gitcode.com/GitHub_Trending/ag/agent-zero
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
