Инструменты — AiHummer Документация

Инструменты — это то, как агент действует в мире: получает страницу, ищет, отправляет почту, запрашивает базу данных, генерирует документ. AiHummer поставляет богатый встроенный каталог и Tool Runtime, который включает инструменты, когда они сконфигурированы, перезагружает их без перезапуска, держит рискованные за одобрением человека и может полностью заблокировать исходящий трафик в air-gapped режиме.

На этой странице — как ведёт себя рантайм и перечень встроенных инструментов. Полный справочник — в каталоге инструментов.

Как ведёт себя Tool Runtime

Включение по конфигу. Инструмент становится доступен только при наличии необходимой конфигурации — обычно переменной окружения, указывающей на нужный сервис. Нет конфига — нет инструмента.
Горячая перезагрузка. Включение инструментов применяется на лету, без перезапуска gateway, так что возможности можно включать и выключать в рантайме.
Гейт одобрения. Рискованные инструменты можно поставить за гейт одобрения с участием человека через AIHUMMER_APPROVAL_TOOLS. Отклонённый вызов не выполняется.
Air-gapped режим. Установка AIHUMMER_AIRGAPPED=1 блокирует управляемый моделью публичный исходящий трафик — для суверенных или изолированных развёртываний.

[!WARNING] code_exec выключен по умолчанию на общих хостах. Включайте его только там, где песочница и хост приемлемы для выполнения кода, написанного моделью, и рассмотрите вариант поставить его за гейт одобрения.

Встроенные инструменты

Инструмент	Что делает	Включение
`web_fetch`	Получить URL (с защитой от SSRF)	включён по умолчанию
`http_request`	Выполнить HTTP-запрос (с защитой от SSRF)	включён по умолчанию
`web_search`	Веб-поиск через SearXNG	`SEARXNG_URL`
`browser`	Управление реальным браузером по CDP	`CLOAKBROWSER_CDP_URL`
`computer`	Computer-use по CDP	`CLOAKBROWSER_CDP_URL`
`filesystem_read`	Чтение файлов в песочнице	`AIHUMMER_FS_ROOT`
`db_query`	Запрос к БД только на чтение	`AIHUMMER_DB_QUERY_DSN`
`mail`	Отправка/приём почты (SMTP/IMAP)	учётные данные почты (vault)
`code_exec`	Выполнение кода в песочнице (по умолчанию выкл. на общих хостах)	`AIHUMMER_CODE_EXEC`
`doc_generate`	Генерация документов CSV/TSV/XLSX	включён по умолчанию
`tts`	Синтез речи	сайдкар TTS
`image_generate` / `edit_image`	Генерация и редактирование изображений	настроенный бэкенд изображений
`github_get_file`	Получить файл с GitHub	включён по умолчанию
`generate_pairing_code`	Выдать код сопряжения устройства	включён по умолчанию
`search_knowledge` / `deep_research`	Извлечение знаний и многошаговое исследование	база знаний
Bitrix24 CRM / задачи / календарь	Действия в CRM, задачах и календаре Bitrix24	плагин Bitrix24
1C (БИТ.ФИНАНС OData)	Доступ к 1C БИТ.ФИНАНС по OData	конфиг 1C OData

[!NOTE] web_fetch и http_request защищены от SSRF — они отклоняют запросы к внутренним адресам и другим небезопасным целям, так что модель не сможет использовать их для доступа к вашей внутренней сети.

Включение инструментов

Большинство инструментов включается, когда вы предоставляете их конфигурацию. Частые переключатели:

SEARXNG_URL=http://localhost:8888          # web_search
CLOAKBROWSER_CDP_URL=http://localhost:9222 # browser + computer
AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read (песочница)
AIHUMMER_DB_QUERY_DSN=postgres://...        # db_query (только чтение)
AIHUMMER_CODE_EXEC=1                         # code_exec (песочница)
AIHUMMER_APPROVAL_TOOLS=mail,code_exec       # требовать одобрение для этих инструментов
AIHUMMER_AIRGAPPED=1                          # блокировать публичный исходящий трафик от модели

[!TIP] Используйте AIHUMMER_APPROVAL_TOOLS, чтобы требовать одобрение для всего, что имеет побочный эффект — отправка почты, выполнение кода — оставляя инструменты только на чтение без гейта.

Куда дальше

Полный справочник по каждому инструменту — в каталоге инструментов.
Цикл, который вызывает эти инструменты — в разделе Оркестрация и суб-агенты.
Обоснование ответов инструментов вашими документами — в разделе Знания / RAG.