Каталог інструментаў

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

AIHUMMER_AIRGAPPED=1

Падчас ходу агент можа выклікаць **інструменты**. 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` | Выдаваць код спарвання прылады. | Уключаны па змаўчанні | | `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` | Адпраўляць і чытаць электронную пошту. | Уліковыя даныя 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`; перад тым як такі інструмент запусціцца, аператар павінен зацвердзіць выклік. Адхілены выклік **не** выконваецца. ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_APPROVAL_TOOLS=mail,code_exec ``` ## Рэжым ізаляцыі ад сеткі Усталюйце `AIHUMMER_AIRGAPPED=1`, каб заблакаваць кантраляваны мадэллю публічны выходны трафік. У гэтым рэжыме агент не можа дасягнуць адкрытага інтэрнэту праз інструменты, што падыходзіць для суверэнных або ізаляваных разгортванняў. ```ini AIHUMMER_AIRGAPPED=1 ``` > [!NOTE] > Акрамя ўбудаванага каталога, AiHummer можа сінтэзаваць інструменты з любой > спецыфікацыі OpenAPI 3.x і прадастаўляць інструменты любога MCP-сервера без кода > інтэграцыі. Глядзіце раздзел Marketplace & Plugins дакументацыі. ## Куды далей - Зменныя, на якія тут спасылаюцца, цалкам: [Зменныя асяроддзя](/en/v1.0/reference/env-vars). - Кіраванне запушчаным інстансам: [Даведнік CLI](/en/v1.0/reference/cli).