🔗 URL 参数

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

URL 参数概览

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

参数	描述	示例
models	指定要使用的模型，使用逗号分隔的列表。	/?models=model1,model2
model	指定聊天会话要使用的单一模型。	/?model=model1
youtube	指定一个要在聊天中转录的 YouTube 视频 ID。	/?youtube=VIDEO_ID
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

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. 网络搜索

• 描述: 启用 web-search 后，聊天会话可以访问 网络搜索 功能。
• 设置方式: 将此参数设置为 true 以启用网络搜索。
• 示例: /?web-search=true
• 行为: 如果启用，聊天可以在响应中检索网络搜索结果。

4. 工具选择

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

5. 通话覆盖界面

• 描述: call 参数在聊天界面中启用一个视频或通话覆盖界面。
• 设置方式: 将参数设置为 true 以启用通话覆盖界面。
• 示例: /?call=true
• 行为: 激活一个通话界面覆盖，支持诸如实时转录和视频输入等功能。

6. 初始查询提示

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

7. 临时聊天会话

• 描述: temporary-chat 参数将聊天标记为临时会话。这可能会限制诸如保存聊天记录或应用持久设置的功能。
• 设置方式: 将此参数设置为 true，以启动临时聊天会话。
• 示例: /?temporary-chat=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”。
• 标记此聊天为临时聊天，不保存任何历史记录。