Каталог инструментов

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

aihummer settings set AIHUMMER_AIRGAPPED 1

В ходе 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` | Проводит многошаговое исследование и выдаёт отчёт со ссылками. | Включён по умолчанию | | `docs_search` | Ищет по **офлайн-копии этой документации** (снимок docs.aihummer.ru поставляется в релизе, `share/docs`, ru/en) — агент отвечает на вопросы о продукте без интернета. | При наличии снимка документации (стандартная установка) | | `docs_read` | Читает целиком страницу документации, найденную через `docs_search`. | При наличии снимка документации (стандартная установка) | ## Включаются по конфигурации Эти инструменты выключены, пока вы не укажете нужный им ресурс. Все ключи включения (`SEARXNG_URL`, `CLOAKBROWSER_CDP_URL`, `AIHUMMER_FS_ROOT`, `AIHUMMER_DB_QUERY_DSN`, `AIHUMMER_CODE_EXEC` и т. д.) — параметры **Каталога настроек**: задавайте их в веб-админке (**Управление → Настройки**, есть поиск) или командой `aihummer settings set <KEY> <VALUE>`. Запись в `gateway.env` **не даёт эффекта** — окружение для этих ключей игнорируется. | Инструмент | Что делает | Как включить | |---|---|---| | `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` (в веб-админке: Управление → Настройки); перед запуском такого инструмента оператор должен одобрить вызов. Отклонённый вызов **не** выполняется. ```bash aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec ``` ## Air-gapped режим Установите настройку `AIHUMMER_AIRGAPPED` в `1`, чтобы блокировать управляемый моделью публичный egress. В этом режиме агент не может выйти в открытый интернет через инструменты, что подходит для суверенных или изолированных развёртываний. ```bash aihummer settings set AIHUMMER_AIRGAPPED 1 ``` > [!NOTE] > Помимо встроенного каталога, AiHummer может синтезировать инструменты из любой > спецификации OpenAPI 3.x и предоставлять инструменты любого MCP-сервера без > интеграционного кода. См. раздел документации «Маркетплейс и плагины». ## Куда дальше - Переменные, упомянутые здесь, целиком: [Переменные окружения](/v1.0/reference/env-vars). - Управление работающим инстансом: [Справочник CLI](/v1.0/reference/cli).