Каталог инструментов — AiHummer Документация

В ходе turn агент может вызывать инструменты. AiHummer поставляет встроенный рантайм инструментов: одни включены по умолчанию, другие активируются только когда вы предоставите нужную конфигурацию. Инструменты защищены от SSRF и работают в песочнице там, где это уместно, а рискованные можно поставить за гейт одобрения человеком.

Включены по умолчанию

Эти инструменты работают «из коробки» (некоторые зависят от настроенной модели или базы знаний).

Инструмент	Что делает	Как включить
`web_fetch`	Получает содержимое URL. Защита от SSRF.	Включён по умолчанию
`http_request`	Делает исходящий HTTP-запрос. Защита от SSRF.	Включён по умолчанию
`doc_generate`	Генерирует документы (CSV / TSV / XLSX).	Включён по умолчанию
`image_generate` / `edit_image`	Генерирует или редактирует изображения.	Включён по умолчанию
`github_get_file`	Получает один файл из проекта на GitHub.	Включён по умолчанию
`generate_pairing_code`	Выпускает код pairing для устройства.	Включён по умолчанию
`search_knowledge`	Ищет в базе знаний (RAG) и обосновывает ответы ссылками.	При настроенной базе знаний
`deep_research`	Проводит многошаговое исследование и выдаёт отчёт со ссылками.	Включён по умолчанию

Включаются по конфигурации

Эти инструменты выключены, пока вы не укажете нужный им ресурс.

Инструмент	Что делает	Как включить
`web_search`	Поиск в интернете.	`SEARXNG_URL` (инстанс SearXNG)
`browser` / `computer`	Управляет реальным браузером через Chrome DevTools Protocol.	`CLOAKBROWSER_CDP_URL` (CDP, порт по умолчанию `:9222`)
`filesystem_read`	Читает файлы в песочнице под корневым каталогом.	`AIHUMMER_FS_ROOT`
`db_query`	Выполняет SQL-запросы только на чтение.	`AIHUMMER_DB_QUERY_DSN`
`mail`	Отправляет и читает email.	Учётные данные SMTP / IMAP
`tts`	Синтезирует речь (text-to-speech).	`AIHUMMER_TTS_URL` (сайдкар TTS)
`code_exec`	Выполняет код в песочнице.	`AIHUMMER_CODE_EXEC`

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

Интеграционные инструменты

При настроенном соответствующем подключении агент получает доменные инструменты:

Инструмент	Что делает	Как включить
Инструменты Bitrix24 CRM / задачи / календарь	Читает и действует над записями CRM, задачами и календарём Bitrix24.	Настроено подключение Bitrix24
1C (БИТ.ФИНАНС OData)	Запрашивает данные учёта 1C через интерфейс БИТ.ФИНАНС OData.	Настроено подключение 1C OData

Гейт одобрения

Любой инструмент можно поставить за гейт одобрения с участием человека. Перечислите имена инструментов в AIHUMMER_APPROVAL_TOOLS; перед запуском такого инструмента оператор должен одобрить вызов. Отклонённый вызов не выполняется.

# /home/.aihummer/etc/gateway.env
AIHUMMER_APPROVAL_TOOLS=mail,code_exec

Air-gapped режим

Установите AIHUMMER_AIRGAPPED=1, чтобы блокировать управляемый моделью публичный egress. В этом режиме агент не может выйти в открытый интернет через инструменты, что подходит для суверенных или изолированных развёртываний.

AIHUMMER_AIRGAPPED=1

[!NOTE] Помимо встроенного каталога, AiHummer может синтезировать инструменты из любой спецификации OpenAPI 3.x и предоставлять инструменты любого MCP-сервера без интеграционного кода. См. раздел документации «Маркетплейс и плагины».

Куда дальше

Переменные, упомянутые здесь, целиком: Переменные окружения.
Управление работающим инстансом: Справочник CLI.