Typo in gemma4:12b-it-qat metadata / Modelfile (incorrectly set to ‘toos’ instead of ‘tools’)

这不是 Ollama 或模型元数据的真实缺陷。用户在检查 gemma4:12b-it-qat 的 Modelfile / metadata 时,把 tools 读成了 toos ,实际排查中并未复现该拼写错误,属于输出读取方式的误判。

快速结论:这不是 Ollama 或模型元数据的真实缺陷。用户在检查 gemma4:12b-it-qat 的 Modelfile / metadata 时,把 tools 读成了 toos,实际排查中并未复现该拼写错误,属于输出读取方式的误判。

适用环境:Ollama 0.40.15;模型 gemma4:12b-it-qat(quantization Q4_0,requires 0.30.5)。Issue 未提供操作系统、GPU、Python、CUDA 或 PyTorch 信息。

最快修复方案:暂无确认的一步修复方案,因为代码侧无需修复。可优先改用 curl 调用 /api/show 后用 jq '.capabilities' 解析输出,确认能力列表中为 tools 而不是 toos。

注意事项:同一终端中 grep -i tool 曾显示 "toos",而 grep -i toos 却无输出,说明问题可能与终端/管道输出呈现或读取方式有关,而非元数据实际错误(具体成因 Issue 未确认)。若你能稳定复现 toos,建议保留原始 JSON 响应并另开 Issue 补充证据。

问题场景

在 Ollama 0.40.15 下拉取官方库模型 gemma4:12b-it-qat,然后通过 ollama show gemma4:12b-it-qat --modelfile 或本地 API /api/show 检查元数据,怀疑工具调用能力字段被写成 toos,导致 function calling / tool calling 无法正常初始化。

报错原文

Typo in gemma4:12b-it-qat metadata / Modelfile (incorrectly set to 'toos' instead of 'tools')

原因分析

Issue 标题与描述认为 Modelfile / metadata 中把 tools 错写为 toos。但排查过程中出现矛盾:grep -i toos 没有找到匹配行,而 ollama show 的能力列表显示 tools,用 jq '.capabilities' 解析 API 响应同样得到 ["completion","vision","audio","tools","thinking"]。因此可能原因是用户对原始输出或 grep 结果的误读,而不是模型元数据真实拼写错误;报告者最终也确认是自身读取方式导致的误判。

环境排查

  • 确认 Ollama 版本:ollama -v(Issue 中为 0.40.15)。
  • 确认模型已拉取且文件完整:ollama list gemma4:12b-it-qat。
  • 确认模型能力列表:ollama show gemma4:12b-it-qat,观察 Capabilities 中是否为 tools。
  • 确认 API 返回的能力字段:调用 /api/show 后用 jq '.capabilities' 查看,避免仅依赖终端中 grep 的显示结果。
  • 如需排查终端或管道输出问题,可同时尝试 grep -i tool 和 grep -i toos,对比两者结果是否一致。

解决步骤

  1. 先确认版本与模型:运行 ollama -v 和 ollama list gemma4:12b-it-qat,确认版本为 0.40.15 且模型已存在。
  2. 查看模型信息中的能力列表:运行 ollama show gemma4:12b-it-qat,检查 Capabilities 下是否为 tools。
  3. 改用结构化方式读取 API 输出:执行 curl -s http://127.0.0.1:11434/api/show -d '{"name":"gemma4:12b-it-qat"}' | jq '.capabilities',确认结果包含 "tools"。
  4. 若仍怀疑存在拼写错误,直接检索 toos:运行 curl http://127.0.0.1:11434/api/show -d '{"name":"gemma4:12b-it-qat"}' | grep -i toos,观察是否有实际匹配。Issue 中此命令未匹配到内容。
  5. 若上述结果均显示 tools,则无需修改 Modelfile;继续按工具调用场景测试模型即可。

验证方法

用 jq '.capabilities' 解析 /api/show 的响应,输出中应包含 "tools" 且不包含 "toos";同时 ollama show gemma4:12b-it-qat 的 Capabilities 也应为 tools。若两者一致,说明元数据正常,工具调用初始化问题应转向其他方向排查。

参考来源

ollama/ollama #19596

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 33492

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注