ობიექტების კატალოგი
მოძრაობის დროს აგენტი შეუძლია გამოაცხადოს ინსტრუმენტები. 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 ან HTML დოკუმენტის შექმნა. | ჩართულია ნაგულისხმევად |
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 |
კითხულობს ფაილს ან აჩვენებს კატალოგის შიგთავსს სერვერის დისკზე. | ნაგულისხმევად — აგენტის საკუთარი სამუშაო საქაღალდე; ჰოსტზე წვდომა მოითხოვს მფლობელის მიერ სწორედ ამ აგენტის იზოლაციის რეჟიმის ცალსახა არჩევას. მართულ ღრუბელში და დემოში მიუწვდომელია. |
[!NOTE]
AIHUMMER_FS_ROOTდამატებით ზღუდავს ნებადართულ ფესვს; ცარიელი მნიშვნელობა მთელ სერვერზე წვდომას არ იძლევა. ინსტალაციის პარამეტრები, მონაცემთა ბაზის წვდომის მონაცემები და დაშიფვრის გასაღებები, აგრეთვე პროცესების გარემო წასაკითხად დახურულია. დადასტურება ფაილებზე ნებადართულ წვდომას არ აფართოებს.
ჩართე კონფიგურაციაში
ეს ინსტრუმენტები დარჩებიან გამორთულ მდგომარეობაში, სანამ თქვენ მათ საჭირო რესურსზე არ მიმართავთ. ყველა მართვის ღილაკი (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 სერვერის ინსტრუმენტის გახსნა ინტეგრაციის კოდის გარეშე. ნახეთ დოკუმენტაციაში სექცია „მარკეტფლეისი და პლაგინები“.
სად შემდეგ?
- ცხრილები, რომლებზეც აქ მთლიანად მითითებულია: გარემოს ცვლადები.
- მართეთ ვმუშაობთინი ინსთანცია: CLI-ის სახელმძღვანელო.
HTML დოკუმენტები
აგენტი doc_generate-ით და format: "html" პარამეტრით ქმნის მაქსიმუმ 4 MiB UTF-8 HTML დანართს. CSS და JavaScript უცვლელად რჩება. თავსებადი განახლებული აპი შენახულ ფაილს წყაროსა და მთლიანობის შემოწმების შემდეგ იზოლირებულ წინასწარ ხედში ხსნის. აპის შესვლის მონაცემები არ გადაეცემა; ფაილის, წყაროს ან სესიის შეცვლა ხედს აუქმებს.