跳到主内容

🧰 功能

🚀 什么是功能?

功能就像 Open WebUI 的插件。它们帮助您扩展其功能——无论是添加对新的 AI 模型提供商(如 Anthropic 或 Vertex AI)的支持,调整消息的处理方式,还是在界面中引入自定义按钮以提高可用性。

与可能需要复杂集成的外部工具不同,功能是内置的,并在 Open WebUI 环境中运行。这意味着它们快速、模块化,并且不依赖于外部依赖项。

将功能视为模块化构建块,它们允许您根据您的确切需求增强 WebUI 的工作方式。它们轻量、高度可定制,并且使用纯 Python 编写,因此您可以自由创建任何东西——从新的 AI 驱动工作流到与您使用的任何事物(如 Google Search 或 Home Assistant)的集成。


🏗️ 功能类型

Open WebUI 中有三种类型的功能,每种都有特定的用途。让我们分解它们并准确解释它们的功能。


1. 管道功能 – 创建自定义“代理/模型”

管道功能是您创建自定义代理/模型或集成的方式,它们会出现在界面中,就像是独立的模型一样。

它的作用是什么?

  • 管道允许您定义复杂的工作流。例如,您可以创建一个将数据发送到 模型 A模型 B,处理它们的输出,并将结果合并为一个最终答案的管道。
  • 管道甚至不需要使用 AI!它们可以用于设置搜索 API天气数据,甚至像 Home Assistant 这样的系统。基本上,任何您想要交互的事物都可以成为 Open WebUI 的一部分。

用例示例
假设您想直接从 Open WebUI 查询 Google Search。您可以创建一个管道功能,它会:

  1. 将您的消息作为搜索查询。
  2. 将查询发送到 Google Search 的 API。
  3. 处理响应并将其作为正常的“模型”响应返回到 WebUI 中给您。

启用后,管道功能会显示为自己的可选模型。当您需要自定义功能并在界面中像模型一样工作时,请使用管道。

有关详细指南,请参阅 管道功能


2. 过滤功能 – 修改输入和输出

过滤功能就像一个工具,用于在数据发送到 AI 之前从 AI 返回之后对其进行调整。

它的作用是什么?
过滤器在工作流中充当“钩子”,主要有两个部分:

  • 入口 (Inlet):调整发送到模型的输入。例如,添加额外的指令、关键词或格式调整。
  • 出口 (Outlet):修改您从模型接收到的输出。例如,清理响应、调整语气或将数据格式化为特定样式。

用例示例
假设您正在进行一个需要精确格式的项目。您可以使用过滤器来确保:

  1. 您的输入总是被转换为所需的格式。
  2. 模型输出在显示前得到清理。

过滤器链接到特定的模型,或者可以根据您的需要全局为所有模型启用。

查看完整指南以获取更多示例和说明:过滤功能


3. 动作功能 – 添加自定义按钮

动作功能用于在聊天界面中添加自定义按钮

它的作用是什么?
动作允许您定义交互式快捷方式,可以直接从聊天中触发特定功能。这些按钮会出现在单个聊天消息下方,为您提供方便的一键访问您定义的动作。

用例示例
假设您经常需要总结长消息或生成特定输出,如翻译。您可以创建一个动作功能来:

  1. 在每条接收到的消息下方添加一个“总结”按钮。
  2. 点击时,它会触发您的自定义功能来处理该消息并返回总结。

按钮提供了一种简洁且用户友好的方式来与您定义的扩展功能进行交互。

动作功能指南 中了解如何设置它们。


🛠️ 如何使用功能

以下是如何在 Open WebUI 中使用功能:

1. 安装功能

您可以通过 Open WebUI 界面或手动导入来安装功能。您可以在 Open WebUI 社区网站 上找到社区创建的功能。

⚠️ 请务必小心。仅安装来自可信源的功能。运行未知代码存在安全风险。


2. 启用功能

功能在安装后必须明确启用:

  • 当您启用管道功能时,它会在界面中作为其自己的模型可用。
  • 对于过滤动作功能,仅启用它们是不够的——您还需要将它们分配给特定的模型,或者为所有模型全局启用它们。

3. 将过滤或动作分配给模型

  • 导航到 工作区 => 模型,然后将您的过滤或动作分配给那里的相关模型。
  • 或者,通过转到 工作区 => 功能,选择“...”菜单,并切换全局开关,为所有模型全局启用功能。

快速总结

  • 管道显示为您可交互的独立模型。
  • 过滤修改输入/输出,以实现更顺畅的 AI 交互。
  • 动作向单个聊天消息添加可点击按钮。

完成设置过程后,功能将无缝增强您的工作流。


✅ 为什么使用功能?

功能专为希望通过 Open WebUI 解锁新可能性的任何人设计:

  • 扩展:添加新的模型或与非 AI 工具集成,如 API、数据库或智能设备。
  • 优化:调整输入和输出,使其完全适合您的用例。
  • 简化:添加按钮或快捷方式,使界面直观高效。

无论您是为特定项目定制工作流,集成外部数据,还是仅仅让 Open WebUI 更易于使用,功能都是掌控您的实例的关键。


📝 最后说明:

  1. 始终可信源安装功能。
  2. 确保您理解管道、过滤和动作功能之间的区别,以便有效使用它们。
  3. 查阅官方指南:

通过利用功能,您将为您的 Open WebUI 设置带来全新的能力。立即开始尝试吧!🚀