跳到主要内容

Open Responses

概览

Open WebUI 对 Open Responses 提供实验性支持。它是一套面向多提供商、可互操作的开放 LLM 接口规范。本指南将带你为某个连接启用 Open Responses API。

实验性功能

该功能目前仍处于实验阶段,未必能在所有提供商上按预期工作。


什么是 Open Responses?

Open Responses 是一个开源规范,用于统一不同提供商之间 LLM 请求与响应的结构。它带来的好处包括:

  • 一套规范,多家提供商:一次描述输入/输出,就能运行在 OpenAI、Anthropic、Gemini 或本地模型上。
  • 可组合的 Agent 循环:统一流式输出、工具调用与消息编排。
  • 更容易做评估与路由:在共享 schema 下比较不同提供商、路由请求并记录结果。

Open Responses 基于 OpenAI Responses API 格式,但目标是面向任何实现该规范的提供商。


第 1 步:新增或编辑连接

  1. 进入 ⚙️ Admin Settings
  2. 打开 Connections > OpenAI > Manage(查找扳手图标)。
  3. 点击 ➕ Add New Connection,或编辑现有连接。

第 2 步:选择 API 类型

在连接弹窗中,找到 API Type 设置:

  • 聊天补全(默认):使用标准 OpenAI 聊天补全 API 格式
  • Responses(实验性):使用 Open Responses API 格式

点击切换到 Responses。你会看到 “实验性” 标记,表示该功能仍在开发中。

API Type 切换


第 3 步:配置你的提供商

填写支持 Open Responses 格式的提供商连接信息:

  • URL:提供商 API 端点
  • API Key:认证凭据
  • Model IDs:(可选)指定你要使用的特定模型

支持的提供商

Open Responses 是一项较新的规范,因此提供商支持仍在持续增长。请查看 Open Responses 官网 以获取最新的兼容提供商与实现列表。


故障排查

聊天补全可用,但 Responses 不可用

并非所有提供商都已经支持 Open Responses 格式。你可以尝试:

  1. 切回聊天补全
  2. 确认你的提供商是否明确声明支持 Open Responses
  3. 使用可以转换到 Open Responses 格式的中间代理

流式输出或工具调用行为异常

对于 Responses API 连接,工具调用、重新调用与流式输出都受支持。Open WebUI 会在聊天补全与 Responses API 格式之间透明转换,包括工具调用参数、函数调用输出以及多轮工具使用。如果你仍然遇到问题:

  1. Open WebUI Discord 查看已知问题
  2. GitHub 报告 bug

有状态会话

默认情况下,Open WebUI 会把 Responses API 连接当作无状态连接处理——它会在本地管理对话历史,并在每次请求时发送完整上下文。如果你的上游提供商支持有状态会话(例如支持 previous_response_id 锚定的服务端响应存储,如直接 OpenAI 连接),你可以启用 ENABLE_RESPONSES_API_STATEFUL=true,让提供商自己管理会话状态。

注意

大多数代理和第三方 Responses API 端点都是无状态的,启用有状态模式后会直接出问题。只有在提供商明确支持有状态 Responses API 会话时才应开启。


了解更多

本内容仅供参考,不构成任何保证、担保或合同承诺。Open WebUI 按“现状”提供。请参阅您的许可协议 以了解适用条款。