ინსტრუმენტები

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

**ინსტრუმენტები** ეს არის ის, როგორ მოქმედებს აგენტი მსოფლიოში — გვერდის ამოღებით, ძიების შესრულებით, წერილის გაგზავნით, მონაცემთა ბაზის კითხვის მიზნით, დოკუმენტის შექმნით. AiHummer უზრუნველყოფს მდიდარ **გაშენებული კატალოგი** და a **ქვის ვადის ხანგრძლივობა** რომელიც მოიცავს ხელსაწყოებს, როდესაც ისინი კონფიგურირებულია, აღდგენს მათ თავიდან ჩატვირთვის გარეშე, ბლოკავს საშიშ ხელსაწყოებს ადამიანის დამადასტურებელი თანხმობის მიღებამდე და შეუძლია სრულად დაბლოკოს გამოსვლა იზოლირებული ქსელის რეჟიმში. ამ გვერდზე აღწერილია შესრულების გარემოს ქცევა და ჩამოთვლილია შიდა ფუნქციები. სრული ცნობართათვის იხილეთ [კატალოგი ინსტრუმენტების](/ka/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 / დავალებები / კალენდარი | მოქმედებები CRM Bitrix24-ში, დავალებებში და კალენდარში | ბიტრიქს24 პლაგინი | | 1C (ბიტ.ფინანს OData) | მოზიდვა 1C BIT.FINANCE საშუალებით OData | 1C OData კონფიგურაცია | > [!NOTE] > `web_fetch` და `http_request` არის **დაცული SSRF** — ისინი უარს ამბობენ მოთხოვნებზე > შინაური მისამართები და სხვა უსაფრთხო სამიზნეები, ამიტომ მოდელი ვერ იყენებს მათ > თქვენი პირადი ქსელისთვის მიაღწიოთ. ## ობიექტური უნარები ა **მობ Dexter** არის ხელმეორედ გამოსაყენებელი ინსტრუქცია (შემოსატანი წუხილის ფრაგმენტი), რომელიც შეიძლება მიემაგროს აგენტებს. ბიბლიოთეკა მდებარეობს ადმინისტრაციულ ინტერფეისში **ობიექტური უნარები** გვერდი: მის შესაქმნელად საკმარისია სახელი და ტექსტი — იდენტიფიკატორი (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` მოითხოვოს დამტკიცება რაიმეს გვერდით > ეფექტი — წერილების გაგზავნა, კოდის შესრულება — ამავდროულად მხოლოდ წაკითხვის ინსტრუმენტები რჩებიან გახსნილი. ## სად შემდეგ? - იხილეთ სრული სანდო სახელმძღვანელო თითოეულ ინსტრუმენტზე [კატალოგი ინსტრუმენტების](/ka/v1.0/reference/tools-catalog). - გაიგეთ ციკლი, რომელიც იწვევს ამ ხელსაწყოებს [ორკესტრაცია და სუბაგენტები](/ka/v1.0/concepts/orchestration-subagents). - მონაცემებზე დაფუძნებული ინსტრუმენტი გიპასუხებთ თქვენს დოკუმენტებზე [განათლება / RAG](/ka/v1.0/concepts/knowledge-rag).