Turn-ի ընթացքում ագենտը կարող է կանչել գործիքներ։ AiHummer-ը մատակարարում է ներկառուցված գործիքների
runtime. որոշ գործիքներ լռելյայն միացված են, մյուսներն ակտիվանում են միայն, երբ դուք տրամադրում եք
պահանջվող կարգավորումը։ Գործիքները SSRF-պաշտպանված և sandbox-ված են, որտեղ տեղին է, և
ռիսկային գործիքները կարող են դրվել մարդկային հաստատման gate-ի հետևում։
Լռելյայն միացված
Այս գործիքներն աշխատում են անմիջապես (որոշները կախված են կարգավորված մոդելից կամ գիտելիքների
բազայից)։
Գործիք
Ինչ է անում
Ինչպես միացնել
web_fetch
Բերել URL-ի բովանդակությունը։ SSRF-պաշտպանված։
Լռելյայն միացված
http_request
Կատարել ելքային HTTP հարցում։ SSRF-պաշտպանված։
Լռելյայն միացված
doc_generate
Գեներացնել փաստաթղթեր (CSV / TSV / XLSX)։
Լռելյայն միացված
image_generate / edit_image
Գեներացնել կամ խմբագրել պատկերներ։
Լռելյայն միացված
github_get_file
Բերել մեկ ֆայլ GitHub repository-ից։
Լռելյայն միացված
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
Կարդալ ֆայլեր, sandbox-ված արմատային գրացուցակի ներքո։
AIHUMMER_FS_ROOT
db_query
Գործարկել միայն-ընթերցում SQL հարցումներ։
AIHUMMER_DB_QUERY_DSN
mail
Ուղարկել և կարդալ էլ. փոստ։
SMTP / IMAP հավատարմագրեր
tts
Սինթեզել խոսք (text-to-speech)։
AIHUMMER_TTS_URL (TTS sidecar)
code_exec
Կատարել կոդ sandbox-ում։
AIHUMMER_CODE_EXEC
[!DANGER]
code_exec-ը լռելյայն անջատված է ընդհանուր host-երի վրա։ Միացրեք այն միայն ձեր
վերահսկողության և վստահության տակ գտնվող միջավայրում, քանի որ այն գործարկում է մոդելի կողմից գրված կոդ։ Նույնիսկ
sandbox-ված, վերաբերվեք դրան որպես արտոնյալ հնարավորության։
Ինտեգրացիոն գործիքներ
Երբ համապատասխան կապը կարգավորված է, ագենտը նաև ստանում է տիրույթային գործիքներ.
Գործիք
Ինչ է անում
Ինչպես միացնել
Bitrix24 CRM / task / calendar գործիքներ
Կարդալ և գործել Bitrix24 CRM գրառումների, առաջադրանքների և օրացույցի վրա։
Bitrix24 կապը կարգավորված
1C (БИТ.ФИНАНС OData)
Հարցում անել 1C հաշվապահական տվյալներին БИТ.ФИНАНС OData ինտերֆեյսի միջոցով։
1C OData կապը կարգավորված
Հաստատման gate
Ցանկացած գործիք կարող է դրվել մարդկային հաստատման gate-ի հետևում։ Թվարկեք գործիքների
անունները AIHUMMER_APPROVAL_TOOLS-ում; նախքան այդպիսի գործիքի գործարկումը, օպերատորը պետք է
հաստատի կանչը։ Մերժված կանչը չի կատարվում։
Սահմանեք AIHUMMER_AIRGAPPED=1 մոդելի կողմից վերահսկվող հանրային ելքը արգելափակելու համար։ Այս ռեժիմում
ագենտը չի կարող հասնել բաց համացանցին գործիքների միջոցով, ինչը տեղին է
ինքնիշխան կամ մեկուսացված տեղակայումների համար։
AIHUMMER_AIRGAPPED=1
[!NOTE]
Բացի ներկառուցված կատալոգից, AiHummer-ը կարող է սինթեզել գործիքներ ցանկացած OpenAPI 3.x
spec-ից և բացել ցանկացած MCP սերվերի գործիքները՝ առանց ինտեգրացիոն կոդի։ Տես
փաստաթղթերի Marketplace և Plugins բաժինը։
Turn-ի ընթացքում ագենտը կարող է կանչել **գործիքներ**։ AiHummer-ը մատակարարում է ներկառուցված գործիքների
runtime. որոշ գործիքներ լռելյայն միացված են, մյուսներն ակտիվանում են միայն, երբ դուք տրամադրում եք
պահանջվող կարգավորումը։ Գործիքները SSRF-պաշտպանված և sandbox-ված են, որտեղ տեղին է, և
ռիսկային գործիքները կարող են դրվել մարդկային հաստատման gate-ի հետևում։
## Լռելյայն միացված
Այս գործիքներն աշխատում են անմիջապես (որոշները կախված են կարգավորված մոդելից կամ գիտելիքների
բազայից)։
| Գործիք | Ինչ է անում | Ինչպես միացնել |
|---|---|---|
| `web_fetch` | Բերել URL-ի բովանդակությունը։ SSRF-պաշտպանված։ | Լռելյայն միացված |
| `http_request` | Կատարել ելքային HTTP հարցում։ SSRF-պաշտպանված։ | Լռելյայն միացված |
| `doc_generate` | Գեներացնել փաստաթղթեր (CSV / TSV / XLSX)։ | Լռելյայն միացված |
| `image_generate` / `edit_image` | Գեներացնել կամ խմբագրել պատկերներ։ | Լռելյայն միացված |
| `github_get_file` | Բերել մեկ ֆայլ GitHub repository-ից։ | Լռելյայն միացված |
| `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` | Կարդալ ֆայլեր, sandbox-ված արմատային գրացուցակի ներքո։ | `AIHUMMER_FS_ROOT` |
| `db_query` | Գործարկել միայն-ընթերցում SQL հարցումներ։ | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Ուղարկել և կարդալ էլ. փոստ։ | SMTP / IMAP հավատարմագրեր |
| `tts` | Սինթեզել խոսք (text-to-speech)։ | `AIHUMMER_TTS_URL` (TTS sidecar) |
| `code_exec` | Կատարել կոդ sandbox-ում։ | `AIHUMMER_CODE_EXEC` |
> [!DANGER]
> `code_exec`-ը **լռելյայն անջատված է ընդհանուր host-երի վրա**։ Միացրեք այն միայն ձեր
> վերահսկողության և վստահության տակ գտնվող միջավայրում, քանի որ այն գործարկում է մոդելի կողմից գրված կոդ։ Նույնիսկ
> sandbox-ված, վերաբերվեք դրան որպես արտոնյալ հնարավորության։
## Ինտեգրացիոն գործիքներ
Երբ համապատասխան կապը կարգավորված է, ագենտը նաև ստանում է տիրույթային գործիքներ.
| Գործիք | Ինչ է անում | Ինչպես միացնել |
|---|---|---|
| Bitrix24 CRM / task / calendar գործիքներ | Կարդալ և գործել Bitrix24 CRM գրառումների, առաջադրանքների և օրացույցի վրա։ | Bitrix24 կապը կարգավորված |
| 1C (БИТ.ФИНАНС OData) | Հարցում անել 1C հաշվապահական տվյալներին БИТ.ФИНАНС OData ինտերֆեյսի միջոցով։ | 1C OData կապը կարգավորված |
## Հաստատման gate
Ցանկացած գործիք կարող է դրվել **մարդկային հաստատման gate**-ի հետևում։ Թվարկեք գործիքների
անունները `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
> spec-ից և բացել ցանկացած MCP սերվերի գործիքները՝ առանց ինտեգրացիոն կոդի։ Տես
> փաստաթղթերի Marketplace և Plugins բաժինը։
## Ուր հաջորդը
- Այստեղ հղվող փոփոխականներն ամբողջությամբ՝ [Միջավայրի փոփոխականներ](/hy/v1.0/reference/env-vars)։
- Կառավարեք աշխատող ինստանսը՝ [CLI տեղեկատու](/hy/v1.0/reference/cli)։