В этом материале
Tools предоставляют действия модели, Pipes появляются как модели, Filters преобразуют сообщения, Actions запускаются пользователем над сообщением.
Выбирайте расширение Open WebUI по добавляемой операции. Tool предоставляет вызываемое действие, Pipe появляется как модель, Filter преобразует сообщения, Action добавляет действие пользователя над сообщением. Это разные механизмы расширения, а не конкурирующие параметры модели.
Конкретная граница приложения
Документация отделяет Python Tools и Functions внутри процесса от внешних HTTP интеграций. Внутренний код работает вместе с Open WebUI и разделяет его ресурсы. Внешние OpenAPI или MCP сервисы имеют отдельных владельцев выполнения. Models, Prompts, Knowledge и Skills в Workspace являются конфигурационными блоками, а не произвольными расширениями платформы. Различие важно, когда нужны лишь повторные инструкции: может хватить оболочки модели без плагина. Обратная ситуация — описание API в системном запросе не создаёт работающий Tool. Сначала назовите недостающую операцию, затем выберите минимальный документированный механизм её выполнения. Так инструкция помощника не смешивается с исполняемым кодом, имеющим собственные последствия и ресурсы (Open WebUI Extensibility) (Open WebUI Workspace).
Практический маршрут
Для вызываемого моделью поиска изучите Tool и его фактический ввод и вывод. Для собственного пути генерации в списке моделей оцените Pipe Function. Кнопке действия над готовым сообщением соответствует Action Function. Систематическому преобразованию входа или выхода соответствует Filter. Если сервис уже имеет поддерживаемый HTTP интерфейс, настройте интеграцию вместо копирования реализации в приложение. До использования изучите импортируемый код: популярность записи сообщества не является проверкой качества или безопасности.
Разобранный пример
Пользователю нужны помощник заметок о выпуске и кнопка преобразования готового ответа в формат проекта. Помощник может быть оболочкой Workspace с инструкциями. Кнопка относится к Action, поскольку пользователь запускает её над сообщением. Если позднее понадобится актуальный поиск, отдельной возможности может потребоваться Tool. Одно название оболочки не реализует все эти операции и не определяет владельца внешнего выполнения.
| Проверка | Запись |
|---|---|
| Повторные инструкции | Конфигурация модели Workspace над существующей базовой моделью генерации. |
| Кнопка сообщения | Action Function, запускаемая пользователем над выбранным готовым сообщением. |
| Поиск модели | Tool либо поддерживаемое соединение сервиса с наблюдаемым результатом. |
Как правильно прочитать сбой
Pipe, выбранный как модель, не работает как отдельно прикреплённый Tool. Filter способен менять запросы без нажатия кнопки сообщения. У нативного транспорта MCP также есть документированные ограничения: не считайте все транспорты серверов взаимозаменяемыми. Сначала определите тип расширения, затем разбирайте инструкции модели. Иначе исправление промпта не меняет механизм, который фактически запускает действие (Open WebUI Models).
Что завершает проверку
Решение готово, когда операция сопоставлена владельцу выполнения и способу вызова. Конфигурационные изменения оставляйте отдельно от установки кода, чтобы повторно используемый запрос случайно не превратился в более широкую задачу расширения платформы.
Связанные материалы: vLLM served-model-name: почему API не находит загруженную модель, llama.cpp server: локальный API из GGUF-модели.