🧰 函数
🚀 什么是函数？
函数就像Open WebUI的插件。它们帮助您扩展其功能——无论是添加对新AI模型提供商（如Anthropic或Vertex AI）的支持、调整消息处理方式，还是 在界面中引入自定义按钮以提高可用性。
与可能需要复杂集成的外部工具不同，**函数内置并在Open WebUI环境中运行。**这意味着它们快速、模块化，不依赖外部依赖项。
将函数视为模块化构建块，让您能够增强WebUI的工作方式，完全按照您的需求定制。它们轻量级、高度可定制，用纯Python编写，因此您可以自由创建任何东西——从新的AI驱动工作流程到与您使用的任何工具（如Google搜索或Home Assistant）的集成。
🏗️ 函数类型
Open WebUI中有三种类型的函数，每种都有特定的用途。让我们分解它们并解释它们到底做什么：
1. 管道函数 – 创建自定义"代理/模型"
管道函数是您创建自定义代理/模型或集成的方式，然后它们在界面中显示为独立模型。
它做什么？
- 管道让您定义复杂的工作流程。例如，您可以创建一个管道，将数据发送到模型A和模型B，处理它们的输出，并将结果合并为一个最终答案。
- 管道甚至不必使用AI！它们可以是搜索API、天气数据或甚至像Home Assistant这样的系统的设置 。基本上，您想要交互的任何东西都可以成为Open WebUI的一部分。
用例示例： 想象一下您想直接从Open WebUI查询Google搜索。您可以创建一个管道函数：
- 将您的消息作为搜索查询。
- 将查询发送到Google搜索的API。
- 处理响应并在WebUI内像正常"模型"响应一样返回给您。
启用后，管道函数显示为它们自己的可选择模型。每当您需要在界面中像模型一样工作的自定义功能时，就使用管道。
详细指南请参阅管道函数。
2. 过滤器函数 – 修改输入和输出
过滤器函数就像在数据发送到AI之前或从AI返回之后调整数据的工具。
它做什么？ 过滤器充当工作流程中的"钩子"，有两个主要部分：
- 入口：调整发送到模型的输入。例如，添加额外的指令、关键词或格式调整。
- 出口：修改从模型接收的输出。例如，清理响应、调整语调或将数据格式化为特定样式。
用例示例： 假设您正在一个需要精确格式的项目上工作。您可以使用过滤器来确保：
- 您的输入总是转换为所需格式。
- 来自模型的输出在显示前被清理。
过滤器链接到特定模型或可以根据您的需求为所有模型全局启用。
查看完整指南获取更多示例和说明：过滤器函数。
3. 动作函数 – 添加自定义按钮
动作函数用于向聊天界面添加自定义按钮。
它做什么？ 动作允许您定义交互式快捷方式，直接从聊天中触发特定功能。这些按钮出现在单个聊天消息下方，为您定义的动作提供方便的一键访问。
用例示例： 假设您经常需要总结长消息或生成特定输出（如翻译）。您可以创建一个动作函数来：
- 在每条传入消息下添加"总结"按钮。
- 点击时，它触发您的自定义函数来处理该消息并返回摘要。
按钮为您定义的扩展功能提供干净且用户友好的交互方式。
在动作函数指南中了解如何设置它们。
🛠️ 如何使用函数
以下是在Open WebUI中使用函数的方法：
1. 安装函数
您可以通过Open WebUI界面安装函数或手动导入它们。您可以在Open WebUI社区网站上找到社区创建的函数。
⚠️ **要谨慎。**只从可信来源安装函数。运行未知代码存在安全风险。
2. 启用函数
函数必须在安装后显式启用：
- 当您启用管道函数时，它在界面中成为自己的模型。
- 对于过滤器和动作函数，仅启用它们是不够的——您还需要将它们分配给特定模型或为所有模型全局启用它们。
3. 将过滤器或动作分配给模型
- 导航到
工作空间 => 模型并在那里将您的过滤器或动作分配给相关模型。 - 或者，通过前往
工作空间 => 函数，选择"..."菜单，并切换全局开关，为所有模型全局启用函数。
快速总结
- 管道显示为您可以交互的独立模型。
- 过滤器修改输入/输出以实现更流畅的AI交互。
- 动作向单个聊天消息 添加可点击按钮。
一旦您遵循了设置过程，函数将无缝增强您的工作流程。
✅ 为什么使用函数？
函数为任何想要解锁Open WebUI新可能性的人而设计：
- 扩展：添加新模型或与非AI工具（如API、数据库或智能设备）集成。
- 优化：调整输入和输出以完美适应您的用例。
- 简化：添加按钮或快捷方式使界面直观高效。
无论您是为特定项目自定义工作流程、集成外部数据，还是只是让Open WebUI更易于使用，函数都是控制您实例的关键。
📝 最后说明：
通过利用函数，您将为您的Open WebUI设置带来全新的功能。今天就开始实验吧！🚀