Құралдар бұл агенттің әлемде қалай әрекет ететіні — бет алу, іздеу, хат жіберу, деректер қорынан сұрау жүргізу, құжат әзірлеу. AiHummer бай жеткізеді құрылғы ішіндегі каталог және бір Құралдың жұмыс уақыты бұл құралдарды олар бапталған кезде қосуға, қайта жүктеусіз іске қосуға, қауіптілерін адам рұқсатынсыз блоктауға және толық оқшауланған режимде шығуды мүлде құлптауға мүмкіндік береді.
Бұл бетте іске қосу ортасының қалай әрекет ететіні және кіріктірілген функциялар тізімі көрсетілген. Толық анықтама үшін мына қараңыз құралдар каталогы.
Құралдың орындау уақыты қалай әрекет етеді
Конфигурацияда қосу. Құрал тек оның алғышарты орындалған кезде ғана қол жетімді болады
конфигурация бар — әдетте қоршаған орта айнымалысы көрсетіп тұрады
қажетті қызмет. Конфигурация жоқ, құрал жоқ.
Ыстық қайта жүктеу. Құралды қосу қолданылады ыстық, қайта іске қоспай
шлюз, сондықтан сіз мүмкіндіктерді орындау уақытында қосып немесе өшіре аласыз.
Растау қақпасы. Тәуекелі құралдар адам араласқан жүйенің артында орналастырылуы мүмкін
бекіту қақпасы арқылы AIHUMMER_APPROVAL_TOOLS. Қабыл алынбаған қоңырау емес
атқарылған.
Ауа арқылы оқшауланған режим. Параметр AIHUMMER_AIRGAPPED=1 блоктар модель арқылы басқарылатын
қоғамдық шығу, тәуелсіз немесе оқшауланған орналастырулар үшін.
[!WARNING]
code_exec болып табылады әдепкі бойынша өшірілген ортақ хосттарда. Оны тек онда ғана қосыңыз
құмсарғыш және хост модель жазған кодты орындау үшін қабылданады, және қарастырыңыз
оны мақұлдау қақпасынан артқа қою.
Фактіні ұзақ мерзімді жадта сақтау; жинау режимі auto болғанда (әдепкі) ол бірден іздеуге қолжетімді, review/off кезінде мақұлдауды күтетін кандидат болады
әдепкіде қосулы
memory_search
Ұзақ мерзімді жадтан іздеу
әдепкіде қосулы
filesystem_read
Сервер дискісіндегі файлды оқу немесе каталог тізімін көру
әдепкі бойынша қосулы; AIHUMMER_FS_ROOT құм жәшігін тарылтады, бос = бүкіл сервер
db_query
Тек оқу режиміндегі дерекқор сұрауы
AIHUMMER_DB_QUERY_DSN
mail
Пошта жіберу/қабылдау (SMTP/IMAP)
пошта тіркелгі деректері (қор)
code_exec
Кодты құмқапта іске қосу (ортақ серверлерде әдепкі бойынша өшірілген)
AIHUMMER_CODE_EXEC
doc_generate
CSV/TSV/XLSX құжаттарын жасау
әдепкі бойынша қосулы
tts
Мәтінді дауға айналдыру
TTS сайдкар
image_generate / edit_image
Суреттерді жасау және өңдеу
конфигурацияланған кескін артқы жағы
github_get_file
GitHub-тен файл алу
әдепкі бойынша қосулы
generate_pairing_code
Құрылғыны жұптастыру кодыңызды шығарыңыз
әдепкі бойынша қосулы
search_knowledge / deep_research
Білімді алу және көпсатылы зерттеу
білім қоры
Bitrix24 CRM / тапсырма / күнтізбе
Bitrix24 CRM, тапсырма және күнтізбе әрекеттері
Bitrix24 плагині
1C (БИТ.ҚАРЖЫ OData)
1C БИТ.ФИНАНС OData арқылы қол жеткізу
1C OData конфигурациясы
[!NOTE]
web_fetch және http_request болады SSRF қорғалған — олар сұраныстарды орындаудан бас тартады
ішкі мекенжайлар мен басқа да қауіпті мақсаттар, сондықтан модель оларды пайдалана алмайды
жеке желіңізге қол жеткізу.
Ортақ дағдылар
А дағды агенттерге қосуға болатын қайта пайдалануға болатын нұсқаулық (куәлік фрагмент). Кітапхана әкімші UI-де орналасқан Ортақ дағдылар бет: біреуін жасау үшін, атауы мен мәтіні жеткілікті — идентификатор (slug) автоматты түрде шығарылады. Сатушы жеткізген дайын дағдылар қоса беріледі Қораптан шыққан күйде бейдж; олар өшірілуі мүмкін, бірақ тізімде қалады. Қосылған дағдылар агенттің жүйелік пәрменінің тұрақты префиксінде көрсетіледі.
Құралдарды қосу
Көптеген құралдар конфигурациясын бергенде іске қосылады. Жалпы қосқыштар:
AIHUMMER_FS_ROOT=/srv/agent-files # filesystem_read құм жәшігін ТАРЫЛТАДЫ (бос = бүкіл сервер)AIHUMMER_DB_QUERY_DSN=postgres://... # db_query (read-only)AIHUMMER_CODE_EXEC=1 # code_exec (sandboxed)AIHUMMER_APPROVAL_TOOLS=mail,code_exec # require approval for these toolsAIHUMMER_AIRGAPPED=1 # block model-controlled public egress
[!TIP]
Пайдалану AIHUMMER_APPROVAL_TOOLS қосымшаға қатысты нәрсенің барлығы үшін рұқсат талап ету
әсер — почта жіберу, кодты іске қосу — тек оқу үшін арналған құралдарды жабық қалдырған кезде.
Келесі қайда
Әр құралға арналған толық сілтемені мына жерде қараңыз
құралдар каталогы.
Құжаттарыңыздағы сұрақтарға құралдың жауаптарын негіздеңіз
Білім / RAG.
**Құралдар** бұл агенттің әлемде қалай әрекет ететіні — бет алу, іздеу, хат жіберу, деректер қорынан сұрау жүргізу, құжат әзірлеу. AiHummer бай жеткізеді **құрылғы ішіндегі каталог** және бір **Құралдың жұмыс уақыты** бұл құралдарды олар бапталған кезде қосуға, қайта жүктеусіз іске қосуға, қауіптілерін адам рұқсатынсыз блоктауға және толық оқшауланған режимде шығуды мүлде құлптауға мүмкіндік береді.
Бұл бетте іске қосу ортасының қалай әрекет ететіні және кіріктірілген функциялар тізімі көрсетілген. Толық анықтама үшін мына қараңыз [құралдар каталогы](/kk/v1.0/reference/tools-catalog).
## Құралдың орындау уақыты қалай әрекет етеді
- **Конфигурацияда қосу.** Құрал тек оның алғышарты орындалған кезде ғана қол жетімді болады
конфигурация бар — әдетте қоршаған орта айнымалысы көрсетіп тұрады
қажетті қызмет. Конфигурация жоқ, құрал жоқ.
- **Ыстық қайта жүктеу.** Құралды қосу қолданылады **ыстық**, қайта іске қоспай
шлюз, сондықтан сіз мүмкіндіктерді орындау уақытында қосып немесе өшіре аласыз.
- **Растау қақпасы.** Тәуекелі құралдар адам араласқан жүйенің артында орналастырылуы мүмкін
бекіту қақпасы арқылы `AIHUMMER_APPROVAL_TOOLS`. Қабыл алынбаған қоңырау **емес**
атқарылған.
- **Ауа арқылы оқшауланған режим.** Параметр `AIHUMMER_AIRGAPPED=1` блоктар модель арқылы басқарылатын
қоғамдық шығу, тәуелсіз немесе оқшауланған орналастырулар үшін.
> [!WARNING]
> `code_exec` болып табылады **әдепкі бойынша өшірілген** ортақ хосттарда. Оны тек онда ғана қосыңыз
> құмсарғыш және хост модель жазған кодты орындау үшін қабылданады, және қарастырыңыз
> оны мақұлдау қақпасынан артқа қою.
## Құрылғы ішіндегі құралдар
| Құрал | Не істейді | Қосу арқылы |
|---|---|---|
| `web_fetch` | URL алу (SSRF-ке қарсы қорғалған) | әдепкі бойынша қосулы |
| `http_request` | HTTP сұрауын жасаңыз (SSRF-дан қорғалған) | әдепкі бойынша қосулы |
| `web_search` | Кіріктірілген SearXNG арқылы веб іздеу | әдепкіде қосулы; орнатқыштың `--no-search` жалаушасымен өшіріледі |
| `browser` | CDP арқылы нақты шолғышты жүргізу | әдепкіде қосулы; орнатқыштың `--no-browser` жалаушасымен өшіріледі |
| `computer` | CDP арқылы компьютерді пайдалану | әдепкіде қосулы; орнатқыштың `--no-browser` жалаушасымен өшіріледі |
| `memory_store` | Фактіні ұзақ мерзімді жадта сақтау; жинау режимі `auto` болғанда (әдепкі) ол бірден іздеуге қолжетімді, `review`/`off` кезінде мақұлдауды күтетін кандидат болады | әдепкіде қосулы |
| `memory_search` | Ұзақ мерзімді жадтан іздеу | әдепкіде қосулы |
| `filesystem_read` | Сервер дискісіндегі файлды оқу немесе каталог тізімін көру | әдепкі бойынша қосулы; `AIHUMMER_FS_ROOT` құм жәшігін **тарылтады**, бос = бүкіл сервер |
| `db_query` | Тек оқу режиміндегі дерекқор сұрауы | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Пошта жіберу/қабылдау (SMTP/IMAP) | пошта тіркелгі деректері (қор) |
| `code_exec` | Кодты құмқапта іске қосу (ортақ серверлерде әдепкі бойынша өшірілген) | `AIHUMMER_CODE_EXEC` |
| `doc_generate` | CSV/TSV/XLSX құжаттарын жасау | әдепкі бойынша қосулы |
| `tts` | Мәтінді дауға айналдыру | TTS сайдкар |
| `image_generate` / `edit_image` | Суреттерді жасау және өңдеу | конфигурацияланған кескін артқы жағы |
| `github_get_file` | GitHub-тен файл алу | әдепкі бойынша қосулы |
| `generate_pairing_code` | Құрылғыны жұптастыру кодыңызды шығарыңыз | әдепкі бойынша қосулы |
| `search_knowledge` / `deep_research` | Білімді алу және көпсатылы зерттеу | білім қоры |
| Bitrix24 CRM / тапсырма / күнтізбе | Bitrix24 CRM, тапсырма және күнтізбе әрекеттері | Bitrix24 плагині |
| 1C (БИТ.ҚАРЖЫ OData) | 1C БИТ.ФИНАНС OData арқылы қол жеткізу | 1C OData конфигурациясы |
> [!NOTE]
> `web_fetch` және `http_request` болады **SSRF қорғалған** — олар сұраныстарды орындаудан бас тартады
> ішкі мекенжайлар мен басқа да қауіпті мақсаттар, сондықтан модель оларды пайдалана алмайды
> жеке желіңізге қол жеткізу.
## Ортақ дағдылар
А **дағды** агенттерге қосуға болатын қайта пайдалануға болатын нұсқаулық (куәлік фрагмент). Кітапхана әкімші UI-де орналасқан **Ортақ дағдылар** бет: біреуін жасау үшін, атауы мен мәтіні жеткілікті — идентификатор (slug) автоматты түрде шығарылады. Сатушы жеткізген дайын дағдылар қоса беріледі **Қораптан шыққан күйде** бейдж; олар өшірілуі мүмкін, бірақ тізімде қалады. Қосылған дағдылар агенттің жүйелік пәрменінің тұрақты префиксінде көрсетіледі.
## Құралдарды қосу
Көптеген құралдар конфигурациясын бергенде іске қосылады. Жалпы қосқыштар:
```bash
AIHUMMER_FS_ROOT=/srv/agent-files # filesystem_read құм жәшігін ТАРЫЛТАДЫ (бос = бүкіл сервер)
AIHUMMER_DB_QUERY_DSN=postgres://... # db_query (read-only)
AIHUMMER_CODE_EXEC=1 # code_exec (sandboxed)
AIHUMMER_APPROVAL_TOOLS=mail,code_exec # require approval for these tools
AIHUMMER_AIRGAPPED=1 # block model-controlled public egress
```
> [!TIP]
> Пайдалану `AIHUMMER_APPROVAL_TOOLS` қосымшаға қатысты нәрсенің барлығы үшін рұқсат талап ету
> әсер — почта жіберу, кодты іске қосу — тек оқу үшін арналған құралдарды жабық қалдырған кезде.
## Келесі қайда
- Әр құралға арналған толық сілтемені мына жерде қараңыз
[құралдар каталогы](/kk/v1.0/reference/tools-catalog).
- Осыларды шақыратын циклді түсініп алыңыз
[Оркестрлеу және қосалқы агенттер](/kk/v1.0/concepts/orchestration-subagents).
- Құжаттарыңыздағы сұрақтарға құралдың жауаптарын негіздеңіз
[Білім / RAG](/kk/v1.0/concepts/knowledge-rag).