快速结论:使用 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 消息。
解决步骤
- 在
@open_webui/routers/ollama.py的OpenAIChatMessage中,将content改为可选并设默认None,与 Issue 建议的入口修复一致:content: Optional[Union[str, list[dict]]] = None。 - 检查代理向 Ollama
/v1/chat/completions构造上游请求体的代码路径,对缺少content的 assistant 工具调用消息做归一化:可优先尝试替换为空字符串,或省略content键,具体取决于 Ollama 端点接受哪种形式。 - 用
gpt-oss:20b分别验证content: null与content: ""两种变体在上游是否都能通过,因为两者语义不同。 - 如要更彻底地符合规范,可考虑按角色区分消息模型(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 端点。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

![issue: [regression] [dev] a folder icon picked on the folder page does not show in the sidebar until a reload](https://www.chat-gpts.plus/wp-content/uploads/2026/11/34374-752736eb-768x403.jpg)
