Агент ауысу кезінде қоңырау шала алады құралдар. AiHummer құрамында кіріктірілген құралдар жұмыс уақыты бар: кейбір құралдар әдепкі бойынша қосулы болады, басқалары тек қажетті конфигурацияны берген кезде іске қосылады. Құралдар SSRF-тен қорғалған және тиісті болған жағдайда оқшауланған, ал қауіпті құралдарды адам рұқсаты арқылы басқаруға болады.
Әдепкі бойынша қосылған
Бұл құралдар қораптан шыққан сәттен бастап жұмыс істейді (кейбіреулері бапталған модельге немесе білім базасына тәуелді).
Құрал
Не істейді
Қалай қосуға болады
web_fetch
URL мазмұнын алу. SSRF қорғалған.
Әдепкі бойынша қосулы
http_request
Шеткі HTTP сұранысын жасаңыз. SSRF-дан қорғалған.
Әдепкі бойынша қосулы
web_search
Кіріктірілген SearXNG арқылы интернетте іздеңіз.
Әдепкі бойынша қосулы (орнатқышпен бірге жеткізіледі); --no-search арқылы өшіріледі
browser / computer
Нағыз шолғышты Chrome DevTools протоколы арқылы басқарыңыз.
Әдепкі бойынша қосулы (орнатқышпен бірге жеткізіледі); --no-browser арқылы өшіріледі
memory_store
Фактіні ұзақ мерзімді жадта (Эйнштейн) сақтаңыз. Жинау режимі auto болғанда (әдепкі) факт бірден іздеуге қолжетімді; review/off кезінде мақұлдауды күтетін кандидат болады. Нәтижеде searchable_now өрісі бар.
Әдепкі бойынша қосулы
memory_search
Ұзақ мерзімді жадтан (Эйнштейн) іздеңіз.
Әдепкі бойынша қосулы
doc_generate
Құжаттарды жасау (CSV / TSV / XLSX).
Әдепкі бойынша қосулы
image_generate / edit_image
Суреттерді жасау немесе өңдеу.
Әдепкі бойынша қосулы
github_get_file
GitHub репозиторийінен бір файлды алыңыз.
Әдепкі бойынша қосулы
generate_pairing_code
Құрылғыны жұптастыру кодын шығарыңыз.
Әдепкі бойынша қосулы
search_knowledge
Білім базасын (RAG) іздеп, жауаптарды дәйексөздермен негіздеңіз.
Білім базасы бапталған
deep_research
Көпсатылы зерттеу жүргізіп, сілтемелері бар есеп беріңіз.
Әдепкі бойынша қосулы
docs_search
Іздеу осы құжаттаманың офлайн нұсқасы (a docs.aihummer.ru скриншоты шығарылымда жіберіледі, share/docs, ru/en) — агент интернетсіз өнімге қатысты сұрақтарға жауап бере алады.
Құжаттардың снэпшоты бар кезде (стандартты орнату)
docs_read
Толық құжаттама бетін осы жерден оқыңыз docs_search.
Құжаттардың снэпшоты бар кезде (стандартты орнату)
filesystem_read
Сервер дискісіндегі файлды оқиды немесе каталог мазмұнын көрсетеді.
Әрқашан қосулы.AIHUMMER_FS_ROOT оны қоспайды, тек құм жәшігін тарылтады: мән бос болғанша, түбір бүкіл сервер (/) болып қалады.
[!DANGER]
Не болады: агент шлюз қызметінің пайдаланушысы оқи алатын кез келген файлды
оқиды — дерекқорға қосылу параметрлері бар файлды және құпиялар қоймасын
шифрлайтын кілтті қоса.
Қандай жағдайда:AIHUMMER_FS_ROOT параметрі бос болғанша. Бұл — өз
серверіңізге орнатқаннан кейінгі әдепкі күй.
Қалай түзету керек:Басқару → Параметрлер бөлімін ашып,
AIHUMMER_FS_ROOT кілтін тауып, агентке шынымен қажет каталогты көрсетіңіз
(мысалы /srv/agent-files) және сақтаңыз. Мән дерекқорда сақталады — бұл кілт
үшін gateway.env жолы еленбейді. Сонымен қатар filesystem_read атауын
AIHUMMER_APPROVAL_TOOLS тізіміне енгізіңіз, сонда әр шақыру сіздің
растауыңызды күтеді.
AiHummer басқарылатын бұлтында бұл құрал агентке мүлдем берілмейді — түбірді
тек өз орнатуыңызда тарылту қажет.
Конфигурацияда қосу
Бұл құралдар қажет ресурсты көрсеткенге дейін өшіп тұрады. Барлық қосу тұтқалары (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) болып табылады Параметрлер каталогы кілттер: оларды веб әкімші UI-де орнатыңыз (Басқару → Баптаулар, бұл іздеу) немесе бірге aihummer settings set <KEY> <VALUE>. Оларды қою gateway.env бар әсер етпейді — бұл кілттер үшін орта ескерілмейді.
Құрал
Не істейді
Қалай қосуға болады
db_query
Тек оқу режимінде SQL сұрауларын орындау.
AIHUMMER_DB_QUERY_DSN
mail
Электрондық поштаны жіберу және оқу.
SMTP / IMAP тіркелгі деректері
tts
Дыбысты синтездеу (мәтінді дыбысқа айналдыру).
AIHUMMER_TTS_URL (TTS қосалқы файлы)
code_exec
Кодты sandbox-та орындау.
AIHUMMER_CODE_EXEC
[!DANGER]
code_exec болып табылады ортақ хосттарда әдепкі бойынша өшірілген. Оны тек қосу үшін
сіз басқаратын және сенетін орта, өйткені ол модель авторланған кодты іске қосады. Тіпті
құпиялы түрде қорғаўлы, оны артықшылықты мүмкіндік ретінде қарастыру.
Интеграция құралдары
Сәйкестендірілген қосылым орнатылған кезде, агент сонымен қатар домен құралдарын алады:
Құрал
Не істейді
Қалай қосуға болады
Bitrix24 CRM / тапсырма / күнтізбе құралдары
Bitrix24 CRM жазбаларын, тапсырмаларын және күнтізбесін оқып, әрекет жасаңыз.
Bitrix24 қосылымы бапталды
1C (БИТ.ҚАРЖЫ OData)
БИТ.ФИНАНС OData интерфейсі арқылы 1C есеп деректерін сұрау.
1C OData қосылғаны конфигурацияланды
Бекіту қақпасы
Кез келген құралдың артына қоюға болады адам араласатын бекіту қақпасы. Құралдардың аттарын тізімде AIHUMMER_APPROVAL_TOOLS параметр (веб әкімші интерфейсі: Басқару → Параметрлер); мұндай құрал іске қосылғанға дейін оператор қоңырауды мақұлдауы керек. Бас тартылған қоңырау емес атқарылған.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Ауа тесігі жоқ режим
Орнату AIHUMMER_AIRGAPPED орнату 1 модельді басқарылатын қоғамдық шығуды блоктау үшін. Осы режимде агент құралдар арқылы ашық интернетке жете алмайды, бұл тәуелсіз немесе оқшауланған орналастырулар үшін қолайлы.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE]
Құрылғыға кіріктірілген каталогтан тыс, AiHummer кез келген OpenAPI 3.x-тен құралдарды синтездей алады
кез келген MCP серверінің құралдарын спецификациялап, біріктіру кодысыз ашыңыз. Көру
Құжаттардың Marketplace және плагиндер бөлімі.
Агент ауысу кезінде қоңырау шала алады **құралдар**. AiHummer құрамында кіріктірілген құралдар жұмыс уақыты бар: кейбір құралдар әдепкі бойынша қосулы болады, басқалары тек қажетті конфигурацияны берген кезде іске қосылады. Құралдар SSRF-тен қорғалған және тиісті болған жағдайда оқшауланған, ал қауіпті құралдарды адам рұқсаты арқылы басқаруға болады.
## Әдепкі бойынша қосылған
Бұл құралдар қораптан шыққан сәттен бастап жұмыс істейді (кейбіреулері бапталған модельге немесе білім базасына тәуелді).
| Құрал | Не істейді | Қалай қосуға болады |
|---|---|---|
| `web_fetch` | URL мазмұнын алу. SSRF қорғалған. | Әдепкі бойынша қосулы |
| `http_request` | Шеткі HTTP сұранысын жасаңыз. SSRF-дан қорғалған. | Әдепкі бойынша қосулы |
| `web_search` | Кіріктірілген SearXNG арқылы интернетте іздеңіз. | Әдепкі бойынша қосулы (орнатқышпен бірге жеткізіледі); `--no-search` арқылы өшіріледі |
| `browser` / `computer` | Нағыз шолғышты Chrome DevTools протоколы арқылы басқарыңыз. | Әдепкі бойынша қосулы (орнатқышпен бірге жеткізіледі); `--no-browser` арқылы өшіріледі |
| `memory_store` | Фактіні ұзақ мерзімді жадта (Эйнштейн) сақтаңыз. Жинау режимі `auto` болғанда (әдепкі) факт бірден іздеуге қолжетімді; `review`/`off` кезінде мақұлдауды күтетін кандидат болады. Нәтижеде `searchable_now` өрісі бар. | Әдепкі бойынша қосулы |
| `memory_search` | Ұзақ мерзімді жадтан (Эйнштейн) іздеңіз. | Әдепкі бойынша қосулы |
| `doc_generate` | Құжаттарды жасау (CSV / TSV / XLSX). | Әдепкі бойынша қосулы |
| `image_generate` / `edit_image` | Суреттерді жасау немесе өңдеу. | Әдепкі бойынша қосулы |
| `github_get_file` | GitHub репозиторийінен бір файлды алыңыз. | Әдепкі бойынша қосулы |
| `generate_pairing_code` | Құрылғыны жұптастыру кодын шығарыңыз. | Әдепкі бойынша қосулы |
| `search_knowledge` | Білім базасын (RAG) іздеп, жауаптарды дәйексөздермен негіздеңіз. | Білім базасы бапталған |
| `deep_research` | Көпсатылы зерттеу жүргізіп, сілтемелері бар есеп беріңіз. | Әдепкі бойынша қосулы |
| `docs_search` | Іздеу **осы құжаттаманың офлайн нұсқасы** (a docs.aihummer.ru скриншоты шығарылымда жіберіледі, `share/docs`, ru/en) — агент интернетсіз өнімге қатысты сұрақтарға жауап бере алады. | Құжаттардың снэпшоты бар кезде (стандартты орнату) |
| `docs_read` | Толық құжаттама бетін осы жерден оқыңыз `docs_search`. | Құжаттардың снэпшоты бар кезде (стандартты орнату) |
| `filesystem_read` | Сервер дискісіндегі файлды оқиды немесе каталог мазмұнын көрсетеді. | **Әрқашан қосулы.** `AIHUMMER_FS_ROOT` оны қоспайды, тек құм жәшігін **тарылтады**: мән бос болғанша, түбір бүкіл сервер (`/`) болып қалады. |
> [!DANGER]
> **Не болады:** агент шлюз қызметінің пайдаланушысы оқи алатын кез келген файлды
> оқиды — дерекқорға қосылу параметрлері бар файлды және құпиялар қоймасын
> шифрлайтын кілтті қоса.
> **Қандай жағдайда:** `AIHUMMER_FS_ROOT` параметрі бос болғанша. Бұл — өз
> серверіңізге орнатқаннан кейінгі әдепкі күй.
> **Қалай түзету керек:** **Басқару → Параметрлер** бөлімін ашып,
> `AIHUMMER_FS_ROOT` кілтін тауып, агентке шынымен қажет каталогты көрсетіңіз
> (мысалы `/srv/agent-files`) және сақтаңыз. Мән дерекқорда сақталады — бұл кілт
> үшін `gateway.env` жолы еленбейді. Сонымен қатар `filesystem_read` атауын
> `AIHUMMER_APPROVAL_TOOLS` тізіміне енгізіңіз, сонда әр шақыру сіздің
> растауыңызды күтеді.
>
> AiHummer басқарылатын бұлтында бұл құрал агентке мүлдем берілмейді — түбірді
> тек өз орнатуыңызда тарылту қажет.
## Конфигурацияда қосу
Бұл құралдар қажет ресурсты көрсеткенге дейін өшіп тұрады. Барлық қосу тұтқалары (`AIHUMMER_DB_QUERY_DSN`, `AIHUMMER_CODE_EXEC`, …) болып табылады **Параметрлер каталогы** кілттер: оларды веб әкімші UI-де орнатыңыз (**Басқару → Баптаулар**, бұл іздеу) немесе бірге `aihummer settings set <KEY> <VALUE>`. Оларды қою `gateway.env` бар **әсер етпейді** — бұл кілттер үшін орта ескерілмейді.
| Құрал | Не істейді | Қалай қосуға болады |
|---|---|---|
| `db_query` | Тек оқу режимінде SQL сұрауларын орындау. | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Электрондық поштаны жіберу және оқу. | SMTP / IMAP тіркелгі деректері |
| `tts` | Дыбысты синтездеу (мәтінді дыбысқа айналдыру). | `AIHUMMER_TTS_URL` (TTS қосалқы файлы) |
| `code_exec` | Кодты sandbox-та орындау. | `AIHUMMER_CODE_EXEC` |
> [!DANGER]
> `code_exec` болып табылады **ортақ хосттарда әдепкі бойынша өшірілген**. Оны тек қосу үшін
> сіз басқаратын және сенетін орта, өйткені ол модель авторланған кодты іске қосады. Тіпті
> құпиялы түрде қорғаўлы, оны артықшылықты мүмкіндік ретінде қарастыру.
## Интеграция құралдары
Сәйкестендірілген қосылым орнатылған кезде, агент сонымен қатар домен құралдарын алады:
| Құрал | Не істейді | Қалай қосуға болады |
|---|---|---|
| Bitrix24 CRM / тапсырма / күнтізбе құралдары | Bitrix24 CRM жазбаларын, тапсырмаларын және күнтізбесін оқып, әрекет жасаңыз. | Bitrix24 қосылымы бапталды |
| 1C (БИТ.ҚАРЖЫ OData) | БИТ.ФИНАНС OData интерфейсі арқылы 1C есеп деректерін сұрау. | 1C OData қосылғаны конфигурацияланды |
## Бекіту қақпасы
Кез келген құралдың артына қоюға болады **адам араласатын бекіту қақпасы**. Құралдардың аттарын тізімде `AIHUMMER_APPROVAL_TOOLS` параметр (веб әкімші интерфейсі: Басқару → Параметрлер); мұндай құрал іске қосылғанға дейін оператор қоңырауды мақұлдауы керек. Бас тартылған қоңырау **емес** атқарылған.
```bash
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
```
## Ауа тесігі жоқ режим
Орнату `AIHUMMER_AIRGAPPED` орнату `1` модельді басқарылатын қоғамдық шығуды блоктау үшін. Осы режимде агент құралдар арқылы ашық интернетке жете алмайды, бұл тәуелсіз немесе оқшауланған орналастырулар үшін қолайлы.
```bash
aihummer settings set AIHUMMER_AIRGAPPED 1
```
> [!NOTE]
> Құрылғыға кіріктірілген каталогтан тыс, AiHummer кез келген OpenAPI 3.x-тен құралдарды синтездей алады
> кез келген MCP серверінің құралдарын спецификациялап, біріктіру кодысыз ашыңыз. Көру
> Құжаттардың Marketplace және плагиндер бөлімі.
## Келесі қайда
- Мұнда сілтемеленген айнымалылар толық нұсқада: [Қоршаған орта айнымалылары](/kk/v1.0/reference/env-vars).
- Жұмыс істеп тұрған дананы басқару: [CLI сілтемесі](/kk/v1.0/reference/cli).
