მოძრაობის დროს აგენტი შეუძლია გამოაცხადოს ინსტრუმენტები. AiHummer მოდის ჩამონტაჟებული ინსტრუმენტების შესრულების დროით: ზოგი ინსტრუმენტი ჩართულია ნაგულისხმევად, ზოგი კი აქტივდება მხოლოდ მას შემდეგ, რაც თქვენ მიაწვდით საჭირო კონფიგურაციას. ინსტრუმენტები დაცულია SSRF-ისგან და იზოლირებულია იქ, სადაც ეს საჭიროა, ხოლო საშიში ინსტრუმენტების დაყენება შესაძლებელია კარებთან ადამიანის დამტკიცების.
ჩართულია ნაგულისხმევად
ეს ინსტრუმენტები მუშაობენ დაყენებისთანავე (ზოგი დაყვანილია კონფიგურირებული მოდელის ან ცოდნის ბაზის მიხედვით).
ინსტრუმენტი
ეს რას აკეთებს
როგორ ჩართვა
web_fetch
მიიღეთ URL-ის კონტენტი. დაცულია SSRF-გან.
ჩართულია ნაგულისხმევად
http_request
ჩაატარეთ საგამარჯვებო HTTP-დაკავშირება. დაცულია SSRF-იდან.
ფაქტის შენახვა გრძელვადიან მეხსიერებაში (აინშტაინი). ჩაწერის რეჟიმით 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
პოვნა ამ დოკუმენტაციის ოფლინ კოპია (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 პარამეტრირება (ადმინისტრატორის ვებ-ინტერფეისი: მართვა → პარამეტრები); ასეთი ინსტრუმენტის გაშვებამდე ოპერატორმა უნდა დაამტკიცოს ზარი. უარყოფილი ზარი არა გაწამლულია.
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` | ფაქტის შენახვა გრძელვადიან მეხსიერებაში (აინშტაინი). ჩაწერის რეჟიმით `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` | პოვნა **ამ დოკუმენტაციის ოფლინ კოპია** (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 სერვერის ინსტრუმენტის გახსნა ინტეგრაციის კოდის გარეშე. ნახეთ
> დოკუმენტაციაში სექცია „მარკეტფლეისი და პლაგინები“.
## სად შემდეგ?
- ცხრილები, რომლებზეც აქ მთლიანად მითითებულია: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars).
- მართეთ ვმუშაობთინი ინსთანცია: [CLI-ის სახელმძღვანელო](/ka/v1.0/reference/cli).
