Каталог инструментов
Во время обработки запроса агент может вызывать инструменты. AiHummer поставляет встроенную среду выполнения инструментов: одни включены по умолчанию, другие активируются только когда вы предоставите нужную конфигурацию. Инструменты защищены от SSRF и работают в песочнице там, где это уместно, а для рискованных можно потребовать одобрение человека перед запуском.
Включены по умолчанию
Эти инструменты работают «из коробки» (некоторые зависят от настроенной модели или базы знаний).
| Инструмент | Что делает | Как включить |
|---|---|---|
web_fetch |
Получает содержимое URL. Защита от SSRF. | Включён по умолчанию |
http_request |
Делает исходящий HTTP-запрос. Защита от SSRF. | Включён по умолчанию |
web_search |
Поиск в интернете через встроенный SearXNG. | Включён по умолчанию (вшит в установочный комплект); отключается флагом установщика --no-search |
browser / computer |
Управляет реальным браузером через Chrome DevTools Protocol. | Включён по умолчанию (вшит в установочный комплект); отключается флагом установщика --no-browser |
memory_store |
Сохраняет факт в долговременную память (Einstein). При режиме захвата auto (умолчание) факт сразу доступен поиску; при review/off — становится кандидатом на одобрение. Результат содержит поле searchable_now. |
Включён по умолчанию |
memory_search |
Ищет по долговременной памяти (Einstein). | Включён по умолчанию |
doc_generate |
Создать документ CSV / TSV / XLSX или HTML. | Включён по умолчанию |
image_generate / edit_image |
Генерирует или редактирует изображения. | Требуется настроенный исполнитель изображений; для редактирования он также должен поддерживать эту операцию. |
github_get_file |
Получает один файл из проекта на GitHub. | Включён по умолчанию |
generate_pairing_code |
Выпускает код привязки для устройства. | Включён по умолчанию |
search_knowledge |
Ищет в базе знаний (RAG) и обосновывает ответы ссылками. | При настроенной базе знаний |
deep_research |
Проводит многошаговое исследование и выдаёт отчёт со ссылками. | Включён по умолчанию |
docs_search |
Ищет по офлайн-копии этой документации (снимок docs.aihummer.ru поставляется в релизе, share/docs, ru/en) — агент отвечает на вопросы о продукте без интернета. |
При наличии снимка документации (стандартная установка) |
docs_read |
Читает целиком страницу документации, найденную через docs_search. |
При наличии снимка документации (стандартная установка) |
filesystem_read |
Читает файл или показывает содержимое каталога на диске сервера. | По умолчанию — собственная рабочая папка агента; доступ к хосту требует явного выбора владельцем режима изоляции для этого агента. Недоступен в управляемом облаке и демо. |
[!NOTE]
AIHUMMER_FS_ROOTдополнительно сужает разрешённый корень; пустое значение не открывает весь сервер. Настройки установки, её данные подключения к базе и ключи шифрования, а также окружение процессов недоступны для чтения. Подтверждение не расширяет разрешённую область файлов.
Включаются по конфигурации
Эти инструменты выключены, пока вы не укажете нужный им ресурс. Все ключи
включения (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC и т. д.) — параметры Каталога
настроек: задавайте их в веб-интерфейсе (Управление → Настройки, есть поиск)
или командой aihummer settings set <KEY> <VALUE>. Запись в gateway.env
не даёт эффекта — окружение для этих ключей игнорируется.
| Инструмент | Что делает | Как включить |
|---|---|---|
db_query |
Выполняет SQL-запросы только на чтение. | AIHUMMER_DB_QUERY_DSN |
mail |
Отправляет и читает почту. | Учётные данные SMTP / IMAP |
tts |
Синтезирует речь (text-to-speech). | AIHUMMER_TTS_URL (сервис TTS) |
code_exec |
Выполняет код в песочнице. | AIHUMMER_CODE_EXEC |
Опасные инструменты: риск и рекомендации
| Инструмент | Уровень риска | Доступ по умолчанию | Сетевые ограничения | Рекомендуемое одобрение |
|---|---|---|---|---|
code_exec |
Высокий — выполняет код, написанный моделью | Выключен по умолчанию | Зависит от песочницы хоста | Обязательно требовать одобрение |
mail |
Высокий — внешне видимые письма | Выключен без учётных данных | Только настроенный SMTP/IMAP | Рекомендуется требовать одобрение |
http_request |
Средний — может менять внешние системы | Включён | Защита от SSRF + список разрешённых адресов | Рекомендуется для изменяющих запросов |
browser / computer |
Средний — управляет реальным браузером | Включён по умолчанию (встроенный браузер); отключается --no-browser |
Исходящие через браузер; проверьте в изолированном режиме | По ситуации |
db_query |
Средний — доступ к данным БД | Выключен без DSN | Только указанный DSN (только чтение) | По ситуации |
filesystem_read |
Зависит от разрешённой области файлов | Рабочая папка агента; доступ к хосту — только по явному выбору владельца | Локальные файлы в текущей разрешённой области | По политике; подтверждение не расширяет область |
[!DANGER] Что произойдёт: модель сможет выполнить произвольный код. При каком условии: если
code_execвключён в среде, которую вы не контролируете, — он выполняет код, написанный моделью. Как исправить: держите его выключенным по умолчанию, а при включении требуйте одобрение перед запуском и относитесь к нему как к привилегированной возможности даже в песочнице.
Интеграционные инструменты
При настроенном соответствующем подключении агент получает доменные инструменты:
| Инструмент | Что делает | Как включить |
|---|---|---|
| Инструменты Bitrix24 CRM / задачи / календарь | Читает и действует над записями CRM, задачами и календарём Bitrix24. | Настроено подключение Bitrix24 |
| 1C (БИТ.ФИНАНС OData) | Запрашивает данные учёта 1C через интерфейс БИТ.ФИНАНС OData. | Настроено подключение 1C OData |
Обязательное одобрение
Для любого инструмента можно потребовать одобрение человека перед запуском.
Перечислите имена инструментов в настройке AIHUMMER_APPROVAL_TOOLS (в
веб-интерфейсе: Управление → Настройки); перед запуском такого инструмента
оператор должен одобрить вызов. Отклонённый вызов не выполняется.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Изолированный (air-gapped) режим
Установите настройку AIHUMMER_AIRGAPPED в 1, чтобы блокировать управляемые
моделью исходящие подключения в публичный интернет. В этом режиме агент не
может выйти в открытый интернет через инструменты, что подходит для суверенных
или изолированных развёртываний.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE] Помимо встроенного каталога, AiHummer может синтезировать инструменты из совместимой спецификации OpenAPI 3.x и предоставлять инструменты MCP-сервера без интеграционного кода. См. раздел документации «Маркетплейс и плагины».
Куда дальше
- Переменные, упомянутые здесь, целиком: Переменные окружения.
- Управление работающим инстансом: Справочник CLI.
HTML-документы
Чтобы создать HTML-вложение, агент использует doc_generate с format: "html". Поддерживается до 4 МиБ текста UTF-8 с CSS и JavaScript. Совместимое обновлённое приложение открывает сохранённый файл в изолированном просмотре после проверки источника и целостности. Данные доступа приложения туда не передаются; смена файла, источника или текущей учётной записи прекращает просмотр.