Құралдар каталогы

# /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` | Сөзді синтездеу (мәтіннен сөзге). | `AIHUMMER_TTS_URL` (TTS sidecar) | | `code_exec` | Кодты құмжәшікте орындау. | `AIHUMMER_CODE_EXEC` | > [!DANGER] > `code_exec` **ортақ хосттарда әдепкі бойынша өшірулі**. Оны тек өзіңіз > басқаратын және сенетін ортада ғана қосыңыз, өйткені ол модель жазған кодты > орындайды. Құмжәшіктелген болса да, оны артықшылықты мүмкіндік ретінде > қарастырыңыз. ## Интеграция құралдары Сәйкес қосылым бапталғанда, агент домендік құралдарды да алады: | Құрал | Не істейді | Қалай қосу керек | |---|---|---| | Bitrix24 CRM / тапсырма / күнтізбе құралдары | Bitrix24 CRM жазбаларын, тапсырмаларын және күнтізбесін оқу және әрекет ету. | Bitrix24 қосылымы бапталған | | 1C (БІТ.ФИНАНС OData) | 1C есеп деректерін БІТ.ФИНАНС OData интерфейсі арқылы сұрау. | 1C OData қосылымы бапталған | ## Мақұлдау қақпасы Кез келген құралды **адамның қатысуымен мақұлдау қақпасының** артына қоюға болады. Құрал атауларын `AIHUMMER_APPROVAL_TOOLS` ішінде тізіңіз; мұндай құрал орындалғанға дейін оператор шақыруды мақұлдауы керек. Қабылданбаған шақыру орындалмайды. ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_APPROVAL_TOOLS=mail,code_exec ``` ## Air-gapped режим Модельмен басқарылатын жария шығысты бұғаттау үшін `AIHUMMER_AIRGAPPED=1` орнатыңыз. Бұл режимде агент құралдар арқылы ашық интернетке жете алмайды, бұл егемен немесе оқшауланған орналастырулар үшін қолайлы. ```ini AIHUMMER_AIRGAPPED=1 ``` > [!NOTE] > Кіріктірілген каталогтан басқа, AiHummer кез келген OpenAPI 3.x спецификациясынан > құралдарды синтездей алады және кез келген MCP сервердің құралдарын ешқандай > интеграция кодынсыз ұсына алады. Құжаттаманың Маркетплейс және Плагиндер > бөлімін қараңыз. ## Әрі қарай қайда - Мұнда сілтенген айнымалылар толығымен: [Орта айнымалылары](/en/v1.0/reference/env-vars). - Жұмыс істеп тұрған дананы басқарыңыз: [CLI анықтамасы](/en/v1.0/reference/cli).