Խաղի ընթացքում գործակալի հերթին նա կարող է կանչել գործիքներ. AiHummer գալիս է ներառված գործիքների գործարկման ժամանակով՝ որոշ գործիքներ ներդրված են ըստ լռելյայն, իսկ մյուսները ակտիվանում են միայն այն ժամանակ, երբ դուք մատուցում եք անհրաժեշտ կազմաձևը: Գործիքները պաշտպանված են SSRF-ից և մեկուսացված այնտեղ, որտեղ դա նպատակահարմար է, իսկ վտանգավոր գործիքները հնարավոր է տեղադրել մարդու հավանության դարպասների մոտ։
Միացված է ըստ կանխորոշման
Այս գործիքները աշխատում են անմիջապես տեղադրման հետո (քիչերը կախված են կարգավորված մոդելից կամ գիտելիքի բազայից):
Գործիք
Ի՞նչ է սա անում
Ինչպես միացնել
web_fetch
Ստացեք URL-ի զանգվածը։ Պաշտպանված է SSRF-ից։
Միացված է ըստ կանխորոշման
http_request
Կատարեք ելքային HTTP-հարցում։ Պաշտպանված է SSRF-ից։
Միացված է ըստ կանխորոշման
web_search
Որոնել ինտերնետում ներկառուցված SearXNG-ի միջոցով։
Միացված է ըստ կանխորոշման (ներառված է տեղադրիչի հետ). անջատեք --no-search-ով
browser / computer
Կառավարեք իրական բրաուզերը Chrome DevTools պրոտոկոլով։
Միացված է ըստ կանխորոշման (ներառված է տեղադրիչի հետ). անջատեք --no-browser-ով
memory_store
Պահեք փաստը երկարաժամկետ հիշողությունում (Einstein): auto հավաքման ռեժիմով (լռելյայն) փաստը անմիջապես որոնելի է. review/off-ով դառնում է հաստատման սպասող թեկնածու: Արդյունքը կրում է searchable_now դաշտ:
Միացված է ըստ կանխորոշման
memory_search
Որոնում երկարաժամկետ հիշողությունում (Einstein):
Միացված է ըստ կանխորոշման
doc_generate
Ստեղծեք փաստաթղթեր (CSV / TSV / XLSX):
Միացված է ըստ կանխորոշման
image_generate / edit_image
Ստեղծել կամ խմբագրել պատկերներ։
Միացված է ըստ կանխորոշման
github_get_file
Ստանալ մեկ ֆայլ GitHub պահոցից։
Միացված է ըստ կանխորոշման
generate_pairing_code
Հանձնել սարքի զուգակցման կոդը։
Միացված է ըստ կանխորոշման
search_knowledge
Փնտրեք գիտելիքների բազայում (RAG) և հիմնավորեք պատասխանները հղումներով։
Կարգավորված գիտելիքների պահոցով
deep_research
Կատարեք բազմակի հետազոտություն և կազմեք զեկույց հղումներով։
Միացված է ըստ կանխորոշման
docs_search
Գտնել այս փաստաթղթի օֆլայն պատճեն (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, …) են Կարգավորումներ-կատալոգ հղումներ․ զանգվածացրեք դրանք ադմանիստրատորի վեբ-ինտերֆեյսում (Կառավարում → Ներմուծումներ, սա ունի որոնում) կամ զ aihummer settings set <KEY> <VALUE>. Դրանք դասավորելով gateway.env ունի ոչ մի ազդեցություն — այս բանալիների համար միջավայրը անտեսվում է:
Գործիք
Ի՞նչ է սա անում
Ինչպես միացնել
db_query
Կատարեք SQL հարցումներ միայն կարդալու համար:
AIHUMMER_DB_QUERY_DSN
mail
Էլեկտրոնային փոստ ուղարկել և կարդալ։
SMTP / IMAP վավերական տվյալներ
tts
Բառաձևը տալ խոսքի (տեքստը խոսքի վերածել)։
AIHUMMER_TTS_URL (TTS կողմնակից)
code_exec
Կատարել կոդը ավազանոցում։
AIHUMMER_CODE_EXEC
[!DANGER]
code_exec է նախնական կարգով անջատված է ընդհանուր հոստինգներում. Ապահովեք դրա ընդգրկումը միայն
մանրէմը, որի վրա դուք կառավարում եք և վստահում եք, քանի որ այն կատարում է մոդելով գրված կոդը։ Թեև
վերցրեք այն որպես նախապատվության իրավունք ունեցող հնարավորություն։
Միավորվածության գործիքներ
Երբ կազմվում է համապատասխան զանգվածված կապը, գործակալը նաև ստանում է տիրույթի գործիքներ՝
Կարդալ և գործել Bitrix24 CRM գրառումներով, առաջադրանքներով և օրացույցով։
Bitrix24-ի միացումը կարգավորված է
1C (ԲԻԹ․ՖԻՆԱՆՍ OData)
Հետազնինե՛լ 1C հաշվապահական տվյալները ԲԻՏ.ՖԻՆԱՆՍ OData ինտերֆեյսի միջոցով։
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 սերվերի ցանկացած գործիքի բնութագիրը և բացահայտումը առանց ինտեգրման կոդի: Տես։
Փաստաթղթում «Մարկետփլեյս և հավելումներ» բաժինը։
Խաղի ընթացքում գործակալի հերթին նա կարող է կանչել **գործիքներ**. AiHummer գալիս է ներառված գործիքների գործարկման ժամանակով՝ որոշ գործիքներ ներդրված են ըստ լռելյայն, իսկ մյուսները ակտիվանում են միայն այն ժամանակ, երբ դուք մատուցում եք անհրաժեշտ կազմաձևը: Գործիքները պաշտպանված են SSRF-ից և մեկուսացված այնտեղ, որտեղ դա նպատակահարմար է, իսկ վտանգավոր գործիքները հնարավոր է տեղադրել մարդու հավանության դարպասների մոտ։
## Միացված է ըստ կանխորոշման
Այս գործիքները աշխատում են անմիջապես տեղադրման հետո (քիչերը կախված են կարգավորված մոդելից կամ գիտելիքի բազայից):
| Գործիք | Ի՞նչ է սա անում | Ինչպես միացնել |
|---|---|---|
| `web_fetch` | Ստացեք URL-ի զանգվածը։ Պաշտպանված է SSRF-ից։ | Միացված է ըստ կանխորոշման |
| `http_request` | Կատարեք ելքային HTTP-հարցում։ Պաշտպանված է SSRF-ից։ | Միացված է ըստ կանխորոշման |
| `web_search` | Որոնել ինտերնետում ներկառուցված SearXNG-ի միջոցով։ | Միացված է ըստ կանխորոշման (ներառված է տեղադրիչի հետ). անջատեք `--no-search`-ով |
| `browser` / `computer` | Կառավարեք իրական բրաուզերը Chrome DevTools պրոտոկոլով։ | Միացված է ըստ կանխորոշման (ներառված է տեղադրիչի հետ). անջատեք `--no-browser`-ով |
| `memory_store` | Պահեք փաստը երկարաժամկետ հիշողությունում (Einstein): `auto` հավաքման ռեժիմով (լռելյայն) փաստը անմիջապես որոնելի է. `review`/`off`-ով դառնում է հաստատման սպասող թեկնածու: Արդյունքը կրում է `searchable_now` դաշտ: | Միացված է ըստ կանխորոշման |
| `memory_search` | Որոնում երկարաժամկետ հիշողությունում (Einstein): | Միացված է ըստ կանխորոշման |
| `doc_generate` | Ստեղծեք փաստաթղթեր (CSV / TSV / XLSX): | Միացված է ըստ կանխորոշման |
| `image_generate` / `edit_image` | Ստեղծել կամ խմբագրել պատկերներ։ | Միացված է ըստ կանխորոշման |
| `github_get_file` | Ստանալ մեկ ֆայլ GitHub պահոցից։ | Միացված է ըստ կանխորոշման |
| `generate_pairing_code` | Հանձնել սարքի զուգակցման կոդը։ | Միացված է ըստ կանխորոշման |
| `search_knowledge` | Փնտրեք գիտելիքների բազայում (RAG) և հիմնավորեք պատասխանները հղումներով։ | Կարգավորված գիտելիքների պահոցով |
| `deep_research` | Կատարեք բազմակի հետազոտություն և կազմեք զեկույց հղումներով։ | Միացված է ըստ կանխորոշման |
| `docs_search` | Գտնել **այս փաստաթղթի օֆլայն պատճեն** (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`, …) են **Կարգավորումներ-կատալոգ** հղումներ․ զանգվածացրեք դրանք ադմանիստրատորի վեբ-ինտերֆեյսում (**Կառավարում → Ներմուծումներ**, սա ունի որոնում) կամ զ `aihummer settings set <KEY> <VALUE>`. Դրանք դասավորելով `gateway.env` ունի **ոչ մի ազդեցություն** — այս բանալիների համար միջավայրը անտեսվում է:
| Գործիք | Ի՞նչ է սա անում | Ինչպես միացնել |
|---|---|---|
| `db_query` | Կատարեք SQL հարցումներ միայն կարդալու համար: | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Էլեկտրոնային փոստ ուղարկել և կարդալ։ | SMTP / IMAP վավերական տվյալներ |
| `tts` | Բառաձևը տալ խոսքի (տեքստը խոսքի վերածել)։ | `AIHUMMER_TTS_URL` (TTS կողմնակից) |
| `code_exec` | Կատարել կոդը ավազանոցում։ | `AIHUMMER_CODE_EXEC` |
> [!DANGER]
> `code_exec` է **նախնական կարգով անջատված է ընդհանուր հոստինգներում**. Ապահովեք դրա ընդգրկումը միայն
> մանրէմը, որի վրա դուք կառավարում եք և վստահում եք, քանի որ այն կատարում է մոդելով գրված կոդը։ Թեև
> վերցրեք այն որպես նախապատվության իրավունք ունեցող հնարավորություն։
## Միավորվածության գործիքներ
Երբ կազմվում է համապատասխան զանգվածված կապը, գործակալը նաև ստանում է տիրույթի գործիքներ՝
| Գործիք | Ի՞նչ է սա անում | Ինչպես միացնել |
|---|---|---|
| Bitrix24 CRM-ի / առաջադրանքների / օրացույցի գործիքներ | Կարդալ և գործել Bitrix24 CRM գրառումներով, առաջադրանքներով և օրացույցով։ | Bitrix24-ի միացումը կարգավորված է |
| 1C (ԲԻԹ․ՖԻՆԱՆՍ OData) | Հետազնինե՛լ 1C հաշվապահական տվյալները ԲԻՏ.ՖԻՆԱՆՍ OData ինտերֆեյսի միջոցով։ | 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 սերվերի ցանկացած գործիքի բնութագիրը և բացահայտումը առանց ինտեգրման կոդի: Տես։
> Փաստաթղթում «Մարկետփլեյս և հավելումներ» բաժինը։
## Որտեղից հետո
- Չափանիշները, որոնցը այստեղ ամբողջությամբ հղում են անում: [Շրջակա միջավայրի փոփոխականներ](/hy/v1.0/reference/env-vars).
- Կառավարեք գործող դեպքը՝ [CLI-ի ուղեցույց](/hy/v1.0/reference/cli).