issue: Ollama’s OpenAI-compatible chat endpoint returns 400 “Field required” for an assistant tool-call turn without content

使用 Open WebUI 的 Ollama 兼容 OpenAI 接口 ( /ollama/v1/chat/completions ) 接外部 Agent 框架或 OpenAI SDK 做多轮工具调用时,第二轮请求里 assistant 消息只带 tool_calls 、不带 content ,被

快速结论:使用 Open WebUI 的 Ollama 兼容 OpenAI 接口 (/ollama/v1/chat/completions) 接外部 Agent 框架或 OpenAI SDK 做多轮工具调用时,第二轮请求里 assistant 消息只带 tool_calls、不带 content,被 Pydantic 校验拦下并返回 400。优先检查 OpenAIChatMessage 的 content 是否被设成了必填字段。

适用环境:Open WebUI v0.13.3(Commit b0e6098);Ubuntu 24.04;Ollama v0.40.16;Pip 安装方式;通过 API 调用。gpt-oss:20b 模型与 Camunda 8.10 AI Agent Connector(OpenAIClientImpl/Java)用于复现。

最快修复方案:暂无确认的一步修复方案。Issue 建议让 OpenAIChatMessage.content 变为可选并默认 None,但讨论同时指出只改入口校验可能不够。

注意事项:入口把 content 设为可选后,代理仍需把消息重新序列化给 Ollama 的 /v1/chat/completions,该上游 schema 有自己的要求。若不在此处做归一化,400 可能只是被推到下游。null 与空字符串是否被接受需以实际上游为准,Issue 未给出已验证结论。

问题场景

用户通过 Open WebUI 的 OpenAI 兼容 Ollama 代理接口 /ollama/v1/chat/completions,连接外部 Agent 框架或 OpenAI Java/Python SDK(如 Camunda 8.10 AI Agent Connector),并使用 gpt-oss:20b(Ollama v0.40.16)进行多轮工具调用。

第一轮工具调用完成后,客户端会把历史对话回传。按 OpenAI Chat Completions 规范,带 tool_calls 的 assistant 消息可以不写 content,但 Open WebUI 的代理在校验这种消息时直接报错,导致第二轮模型请求失败。

报错原文

400 Bad Request:
1 validation error for OpenAIChatCompletionForm
messages.2.content
  Field required [type=missing, input_value={'role': 'assistant', 'tool_calls': [...]}, input_type=dict]

原因分析

问题出在 @open_webui/routers/ollama.py 的 OpenAIChatMessage 模型定义。当前 content 为必填字段、没有默认值:

class OpenAIChatMessage(BaseModel):
    role: str
    content: Optional[Union[str, list[dict]]]
    model_config = ConfigDict(extra="allow")

而 OpenAI 规范中 assistant 消息的 content 是可选的,且客户端在工具调用回合经常省略或传 null。因此当请求历史里出现 {"role": "assistant", "tool_calls": [...]} 这种结构时,Pydantic 报 Field required,请求在进入 Ollama 之前就被拒绝。

讨论中的补充意见认为这只是半个原因:即使入口放宽校验,代理还要把消息重新序列化并转发给 Ollama 的 /v1/chat/completions,该上游接口对缺失 content 的处理是另一套 schema。若出口不做归一化(传空字符串或省略该键),错误可能继续出现在下一跳。另外,content 对 system/user 应为必填、对 assistant 为可选、tool 消息还需 tool_call_id 与对应 tool_calls 配对;用一个所有字段都可选的扁平模型会放过 OpenAI 本来会拒绝的对话。以上均属讨论中的分析,可优先尝试的方向不等于已验证的最终修复。

环境排查

  • 确认 Open WebUI 版本与提交:Issue 复现于 v0.13.3,Commit b0e6098,并在提交前的 dev 分支上复现。
  • 确认 Ollama 版本:v0.40.16。
  • 确认操作系统:Ubuntu 24.04,安装方式为 Pip。
  • 确认调用方:OpenAI 兼容客户端(Java/Python SDK 或 Camunda 8.10 AI Agent Connector),走 /ollama/v1/chat/completions 代理路径。
  • 确认模型:gpt-oss:20b。
  • 检查触发请求体的对话历史中,是否存在仅含 role 与 tool_calls、不含 content 的 assistant 消息。

解决步骤

  1. 在 @open_webui/routers/ollama.py 的 OpenAIChatMessage 中,将 content 改为可选并设默认 None,与 Issue 建议的入口修复一致:content: Optional[Union[str, list[dict]]] = None。
  2. 检查代理向 Ollama /v1/chat/completions 构造上游请求体的代码路径,对缺少 content 的 assistant 工具调用消息做归一化:可优先尝试替换为空字符串,或省略 content 键,具体取决于 Ollama 端点接受哪种形式。
  3. 用 gpt-oss:20b 分别验证 content: null 与 content: "" 两种变体在上游是否都能通过,因为两者语义不同。
  4. 如要更彻底地符合规范,可考虑按角色区分消息模型(role-discriminated union):system/user 的 content 必填,assistant 可选,tool 消息校验 tool_call_id,避免后续字段再次被误设为全角色必填。

验证方法

用同一套多轮工具调用客户端(Camunda 8.10 AI Agent Connector / OpenAI Java 客户端)再次请求 /ollama/v1/chat/completions:第二轮请求中 assistant 消息带 tool_calls 且不含 content 时,不再出现 1 validation error for OpenAIChatCompletionForm 与 messages.N.content Field required,请求能通过代理转发到 Ollama 并正常返回。content 默认值为 None 后,Issue 作者报告该消息形状可通过校验并转发到 Ollama 端点。

参考来源

open-webui/open-webui #34441

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 35340

发表回复

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