ხელსაწყოების კატალოგი

# /home/.aihummer/etc/gateway.env
AIHUMMER_APPROVAL_TOOLS=mail,code_exec

AIHUMMER_AIRGAPPED=1

ბიჯის განმავლობაში აგენტს შეუძლია გამოიძახოს **ხელსაწყოები**. AiHummer გააჩნია ჩაშენებული ხელსაწყოების გარემო: ზოგი ხელსაწყო ნაგულისხმევად ჩართულია, სხვები ააქტიურდება მხოლოდ მაშინ, როცა მიაწვდი საჭირო კონფიგურაციას. ხელსაწყოები SSRF-დაცულია და sandbox-ში ჩაკეტილია სადაც რელევანტურია, ხოლო სარისკო ხელსაწყოები შეიძლება დაიდოს ადამიანის დადასტურების კარიბჭის უკან. ## ნაგულისხმევად ჩართული ეს ხელსაწყოები მუშაობს კოლოფიდან (ზოგი დამოკიდებულია კონფიგურირებულ მოდელზე ან ცოდნის ბაზაზე). | ხელსაწყო | რას აკეთებს | როგორ ჩაირთვება | |---|---|---| | `web_fetch` | წამოიღებს URL-ის შიგთავსს. SSRF-დაცული. | ნაგულისხმევად ჩართული | | `http_request` | აკეთებს გამავალ HTTP მოთხოვნას. SSRF-დაცული. | ნაგულისხმევად ჩართული | | `doc_generate` | ქმნის დოკუმენტებს (CSV / TSV / XLSX). | ნაგულისხმევად ჩართული | | `image_generate` / `edit_image` | ქმნის ან არედაქტირებს სურათებს. | ნაგულისხმევად ჩართული | | `github_get_file` | წამოიღებს ერთ ფაილს GitHub საცავიდან. | ნაგულისხმევად ჩართული | | `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-ში root დირექტორიის ქვეშ. | `AIHUMMER_FS_ROOT` | | `db_query` | უშვებს მხოლოდ-კითხვის SQL მოთხოვნებს. | `AIHUMMER_DB_QUERY_DSN` | | `mail` | აგზავნის და კითხულობს ელ-ფოსტას. | SMTP / IMAP სარწმუნებლები | | `tts` | სინთეზირებს მეტყველებას (ტექსტი-მეტყველებად). | `AIHUMMER_TTS_URL` (TTS sidecar) | | `code_exec` | უშვებს კოდს sandbox-ში. | `AIHUMMER_CODE_EXEC` | > [!DANGER] > `code_exec` **ნაგულისხმევად გამორთულია საზიარო ჰოსტებზე**. ჩართე იგი მხოლოდ ისეთ > გარემოში, რომელსაც აკონტროლებ და ენდობი, რადგან ის უშვებს მოდელის ავტორობით დაწერილ > კოდს. sandbox-შიც კი მოეპყარი მას როგორც პრივილეგირებულ შესაძლებლობას. ## ინტეგრაციის ხელსაწყოები როცა შესაბამისი კავშირი კონფიგურირებულია, აგენტი ასევე იღებს დომენურ ხელსაწყოებს: | ხელსაწყო | რას აკეთებს | როგორ ჩაირთვება | |---|---|---| | Bitrix24 CRM / დავალების / კალენდრის ხელსაწყოები | კითხულობს და მოქმედებს Bitrix24 CRM ჩანაწერებზე, დავალებებსა და კალენდარზე. | Bitrix24 კავშირი კონფიგურირებული | | 1C (БИТ.ФИНАНС OData) | აგზავნის მოთხოვნებს 1C აღრიცხვის მონაცემებზე БИТ.ФИНАНС OData ინტერფეისით. | 1C OData კავშირი კონფიგურირებული | ## დადასტურების კარიბჭე ნებისმიერი ხელსაწყო შეიძლება დაიდოს **ადამიანის-ჩართულობით დადასტურების კარიბჭის** უკან. ჩამოთვალე ხელსაწყოს სახელები `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 > სპეციფიკაციიდან და ნებისმიერი MCP სერვერის ხელსაწყოების გამოქვეყნება ინტეგრაციის კოდის > გარეშე. იხ. დოკუმენტაციის Marketplace და Plugins განყოფილება. ## სად შემდეგ - აქ მითითებული ცვლადები სრულად: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars). - მართე გაშვებული ინსტანცია: [CLI ცნობარი](/ka/v1.0/reference/cli).