跳到主要内容

🔗 URL 参数

在 Open WebUI 中，聊天会话可以通过各种 URL 参数进行自定义。这些参数允许您按每个聊天会话设置特定配置、启用功能以及定义模型设置。这种方法可以直接从 URL 提供对单个聊天会话的灵活性和控制。

URL 参数概览​

下表列出了可用的 URL 参数、它们的功能和使用示例。

参数描述示例
models指定要使用的模型，以逗号分隔列表。/?models=model1,model2
model指定聊天会话要使用的单个模型。/?model=model1
youtube指定要在聊天中转录的 YouTube 视频 ID。/?youtube=VIDEO_ID
load-url指定一个网站 URL，以便在聊天中抓取并作为文档上传。/?load-url=https://google.com
web-search如果设置为 true，则启用网页搜索功能。/?web-search=true
tools 或 tool-ids指定要在聊天中激活的工具 ID 的逗号分隔列表。/?tools=tool1,tool2
call如果设置为 true，则启用通话叠加层。/?call=true
q为聊天设置初始查询或提示。/?q=Hello%20there
temporary-chat如果设置为 true，则将聊天标记为临时会话，用于一次性会话。/?temporary-chat=true
code-interpreter如果设置为 true，则启用代码解释器功能。/?code-interpreter=true
image-generation如果设置为 true，则启用图像生成功能。/?image-generation=true

1. 模型和模型选择​

  • 描述：models 和 model 参数允许您指定特定聊天会话应使用的语言模型。
  • 如何设置：您可以对多个模型使用 models，或对单个模型使用 model。
  • 示例:
    • /?models=model1,model2 – 这会用 model1 和 model2 初始化聊天。
    • /?model=model1 – 这会将 model1 设置为聊天的唯一模型。

2. YouTube 转录​

  • 描述：youtube 参数接受 YouTube 视频 ID，使聊天能够转录指定的视频。
  • 如何设置：使用 YouTube 视频 ID 作为此参数的值。
  • 示例：/?youtube=VIDEO_ID
  • 行为：这会在聊天中触发所提供 YouTube 视频的转录功能。

3. 网站内容插入​

  • 描述：load-url 参数会下载指定的网站并提取内容，然后将其作为文档上传到聊天中。
  • 如何设置：使用完整的网站 URL 作为此参数的值。
  • 示例：/?load-url=https://google.com
  • 行为：这会触发指定网站 URL 的插入。
  • 描述：启用 web-search 允许聊天会话访问网页搜索功能。
  • 如何设置：将此参数设置为 true 以启用网页搜索。
  • 示例：/?web-search=true
  • 行为：如果启用，聊天可以检索网页搜索结果作为其回复的一部分。

5. 工具选择​

  • 描述：tools 或 tool-ids 参数指定要在聊天中激活的工具。
  • 如何设置：提供逗号分隔的工具 ID 列表作为参数值。
  • 示例：/?tools=tool1,tool2 或 /?tool-ids=tool1,tool2
  • 行为：每个工具 ID 都在会话中匹配并激活，以供用户交互。

6. 通话叠加层​

  • 描述：call 参数在聊天界面中启用视频或通话叠加层。
  • 如何设置：将参数设置为 true 以启用通话叠加层。
  • 示例：/?call=true
  • 行为：激活通话界面叠加层，允许实时转录和视频输入等功能。

7. 初始查询提示​

  • 描述：q 参数允许为聊天设置初始查询或提示。
  • 如何设置：将查询或提示文本指定为参数值。
  • 示例：/?q=Hello%20there
  • 行为：聊天会以指定的提示开始，并自动将其作为第一条消息提交。

8. 临时聊天会话​

  • 描述：temporary-chat 参数将聊天标记为临时会话。这可能会限制保存聊天历史记录或应用持久设置等功能。
  • 如何设置：将此参数设置为 true 以进行临时聊天会话。
  • 示例：/?temporary-chat=true
  • 行为：这会启动一个一次性聊天会话，不保存历史记录或应用高级配置。

9. 代码解释器​

  • 描述：code-interpreter 参数启用代码解释器功能。
  • 如何设置：将此参数设置为 true，以在此新的聊天会话中启用代码解释器功能。
  • 示例：/?code-interpreter=true
  • 行为：激活代码解释器按钮，以在发送给 LLM 的下一个提示中使用代码解释器。

10. 图像生成​

  • 描述：image-generation 参数为提供的提示启用图像生成。
  • 如何设置：将此参数设置为 true，以在聊天中启用图像生成。
  • 示例：/?image-generation=true
  • 行为：激活图像生成按钮以生成图像。
用例示例
临时聊天会话

假设用户想要启动一个不保存历史记录的快速聊天会话。他们可以通过在 URL 中设置 temporary-chat=true 来实现。这提供了一个一次性聊天环境，非常适合一次性交互。

同时使用多个参数​

这些 URL 参数可以组合使用，以创建高度自定义的聊天会话。例如：

/?models=model1,model2&youtube=VIDEO_ID&web-search=true&tools=tool1,tool2&call=true&q=Hello%20there&temporary-chat=true

此 URL 将：

  • 使用 model1 和 model2 初始化聊天。
  • 启用 YouTube 转录、网页搜索和指定的工具。
  • 显示通话叠加层。
  • 设置初始提示为“Hello there.”
  • 将聊天标记为临时会话，避免保存任何历史记录。