Open WebUI Tool Search: как искать инструмент и проверить совместимость
На странице · 3 разделов
Tool Search помогает не передавать все подробные описания инструментов модели сразу: она сначала запрашивает нужное через search_tools. Функция экспериментальная и требует совместимого подключения модели. На сервере llama.cpp отложенные инструменты недоступны модели; оставьте нужные инструменты постоянно загруженными или отключите поиск.
Когда к чату Open WebUI подключено много инструментов, их описания занимают место в запросе к модели. Tool Search оставляет краткий перечень и позволяет модели запросить подробности только нужного инструмента через search_tools. Это не отдельный поиск в интернете и не способ подключить отсутствующий инструмент. Функция появилась в релизе v0.12.0 как экспериментальная. s1 s2
Инструкция по авторской документации, сверенной 14 октября 2026 года. Понадобятся права администратора и работающий Open WebUI. В нём должен быть включён Native Mode — режим, где модель сама вызывает инструменты, — и выбрана модель с такой возможностью и совместимым подключением. Редакция не запускала интерфейс и модель; ниже — тестовый сценарий, а не протокол успешного запуска. Это инженерная настройка, не домашний рецепт установки модели. Не используйте реальные документы или изменяющие инструменты для первого теста. s1
Когда включать Tool Search?
Включайте его на тестовой установке, когда длинные описания многих уже разрешённых инструментов перегружают запрос. Если вы администратор, откройте Settings → Admin → Interface → Chat и включите Tool Search. Он выключен по умолчанию, работает в Native Mode и действует для всех моделей и пользователей установки; поэтому не меняйте рабочую конфигурацию без согласования. Настройка Deferral Threshold (characters) определяет, насколько длинным должно быть описание, чтобы его отложить; стандартное значение — 400 символов. Для ограниченного теста можно временно поставить 0, чтобы отложить все инструменты, и затем вернуть прежнее значение. s1
Defer Built-in Tools по умолчанию включён; Always Loaded Tools позволяет сохранить выбранные инструменты в полном списке. Оставьте настройки приложения без других изменений. Отложенный инструмент сначала показывается модели кратко, а search_tools по имени или ключевым словам раскрывает его описание. Сам поиск ещё не выполняет найденный инструмент. s1
Как проверить два отдельных действия?
Откройте новый тестовый чат с моделью в Native Mode. Включите для неё категорию Knowledge Base, но не прикрепляйте базу знаний к модели, папке или чату: в этом случае документация перечисляет безопасный инструмент чтения list_knowledge_bases. Попросите: «Найди инструмент, который перечисляет доступные мне базы знаний. Затем вызови именно его; ничего не изменяй». s1
Откройте цепочку вызовов в чате. Критерий успеха: в ней виден вызов search_tools с запросом о базах знаний, а после него вызов list_knowledge_bases и его фактический ответ — список или пустой список, если баз нет. Это ожидаемый критерий для вашей проверки, не результат, полученный Modelium. Если виден только готовый текстовый ответ, это не доказательство двух вызовов: проверьте, что инструмент доступен в этом чате и что модель умеет вызывать инструменты. s1
Если включены экспериментальные Tool Permissions → Ask for approval, поиск и сам вызов могут запросить два отдельных разрешения. Это не универсальная защита: по документации запланированные автоматизации и ответы в каналах выполняются с полным доступом независимо от этих настроек. Для проверок прав используйте только собственный учебный чат и безопасный инструмент чтения. s1
Что делать при несовместимой локальной модели?
По авторской документации сервер модели (бэкенд) должен принимать вызов отложенного инструмента, которого нет в исходном полном списке. llama.cpp server этого не допускает; OpenAI API (Chat Completions и Responses) также ограничивает такие вызовы. Для прочих локальных подключений, включая Ollama, не считайте совместимость доказанной без реальной трассы двух вызовов. Если она не получается, впишите нужное имя инструмента в Always Loaded Tools или отключите Tool Search; тогда описание нужного инструмента передаётся сразу, без поиска. s1
Имена инструментов MCP (протокола подключения внешних инструментов) в списке для модели получают префикс ID сервера: шаблон вроде github_* удерживает все инструменты соответствующего сервера, но может вернуть большой объём описаний. Предпочтите один разрешённый тестовый инструмент и не расширяйте доступ модели ради самой функции поиска. Для нового инструмента сперва подключите MCP в Open WebUI, затем повторите трассировку. s1
Источники
- Open WebUI Docs — Tools, Tool Search and Backend Requirement — revision f9ec4be3aec34d910c6bdd41252f0ec2443f7b4e; Tool Search и Knowledge Tool Availability; commit 12.10.2026.. Получено 14.10.2026.
- Open WebUI v0.12.0 — release notes — revision 15818d88fd7bde1b73de33590f50d15d21e8d7c1; Релиз опубликован 10.10.2026; анонс экспериментального Tool Search.. Получено 14.10.2026.