ხელსაწყოები — AiHummer დოკუმენტაცია

ხელსაწყოები არის ის, თუ როგორ მოქმედებს აგენტი სამყაროზე — გვერდის წამოღება, ძებნა, ფოსტის გაგზავნა, მონაცემთა ბაზის გამოკითხვა, დოკუმენტის გენერაცია. AiHummer აწვდის მდიდარ ჩაშენებულ კატალოგსა და ხელსაწყოს გარემოს (Tool Runtime), რომელიც ხელსაწყოებს ჩართავს მათი კონფიგურირებისას, გადატვირთავს მათ გადატვირთვის გარეშე, აყენებს სარისკოებს ადამიანის დამოწმების მიღმა და შეუძლია სრულად ჩაკეტოს გასვლა იზოლირებულ (air-gapped) რეჟიმში.

ეს გვერდი ფარავს იმას, თუ როგორ იქცევა გარემო, და ჩამოთვლის ჩაშენებულებს. სრული ცნობარისთვის იხ. ხელსაწყოების კატალოგი.

როგორ იქცევა ხელსაწყოს გარემო

ჩართვა-კონფიგურაციაზე. ხელსაწყო ხელმისაწვდომი ხდება მხოლოდ მაშინ, როცა მისი წინაპირობითი კონფიგურაცია არსებობს — ჩვეულებრივ გარემოს ცვლადი, რომელიც მიუთითებს მისთვის საჭირო სერვისზე. კონფიგურაცია არ არის, ხელსაწყო არ არის.
ცხელი გადატვირთვა. ხელსაწყოს ჩართვა გამოიყენება ცხელად, gateway-ის გადატვირთვის გარეშე, ასე რომ შესაძლებლობების ჩართვა და გამორთვა გაშვების მომენტში შეგიძლიათ.
დამოწმების ფილტრი. სარისკო ხელსაწყოები შეიძლება დაყენდეს ადამიანი-ციკლში დამოწმების ფილტრის მიღმა AIHUMMER_APPROVAL_TOOLS-ის გავლით. უარყოფილი გამოძახება არ სრულდება.
იზოლირებული (air-gapped) რეჟიმი. AIHUMMER_AIRGAPPED=1-ის დაყენება ბლოკავს მოდელის მიერ მართულ საჯარო გასვლას, სუვერენული ან იზოლირებული განთავსებებისთვის.

[!WARNING] code_exec ნაგულისხმევად გამორთულია გაზიარებულ ჰოსტებზე. ჩართეთ ის მხოლოდ იქ, სადაც სავარჯიშო (sandbox) და ჰოსტი მისაღებია მოდელის მიერ დაწერილი კოდის გასაშვებად, და განიხილეთ მისი დამოწმების ფილტრის მიღმა დაყენება.

ჩაშენებული ხელსაწყოები

ხელსაწყო	რას აკეთებს	ჩართვა ამით
`web_fetch`	URL-ის წამოღება (SSRF-დაცული)	ნაგულისხმევად ჩართული
`http_request`	HTTP მოთხოვნის გაგზავნა (SSRF-დაცული)	ნაგულისხმევად ჩართული
`web_search`	ვებ ძებნა SearXNG-ის გავლით	`SEARXNG_URL`
`browser`	რეალური ბრაუზერის მართვა CDP-ის გავლით	`CLOAKBROWSER_CDP_URL`
`computer`	კომპიუტერით სარგებლობა CDP-ის გავლით	`CLOAKBROWSER_CDP_URL`
`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 sidecar
`image_generate` / `edit_image`	სურათების გენერაცია და რედაქტირება	კონფიგურირებული სურათის ბექენდი
`github_get_file`	ფაილის წამოღება GitHub-დან	ნაგულისხმევად ჩართული
`generate_pairing_code`	მოწყობილობის დაწყვილების კოდის გამოშვება	ნაგულისხმევად ჩართული
`search_knowledge` / `deep_research`	ცოდნის მოძიება და მრავალსაფეხურიანი კვლევა	ცოდნის ბაზა
Bitrix24 CRM / დავალება / კალენდარი	Bitrix24 CRM, დავალებისა და კალენდრის მოქმედებები	Bitrix24 დანამატი
1C (БИТ.ФИНАНС OData)	1C БИТ.ФИНАНС-ზე წვდომა OData-ის გავლით	1C OData კონფიგურაცია

[!NOTE] web_fetch და http_request SSRF-დაცულია — ისინი უარს ამბობენ შიდა მისამართებსა და სხვა სახიფათო სამიზნეებზე მოთხოვნებზე, ასე რომ მოდელს ვერ გამოიყენებს მათ თქვენი კერძო ქსელის მისაღწევად.

საერთო უნარები

უნარი არის მრავალჯერ გამოსაყენებელი ინსტრუქცია (პრომპტის ფრაგმენტი), რომელიც შეიძლება აგენტებს მიუერთდეს. ბიბლიოთეკა ცხოვრობს ადმინ UI-ის გვერდზე «საერთო უნარები»: შექმნისას საკმარისია სახელი და ტექსტი — იდენტიფიკატორი (slug) ავტომატურად გამოჰყავს. ვენდორის მიერ «ყუთიდანვე» მოწოდებული უნარები მონიშნულია ბეჯით «ყუთიდანვე»; მათი გამორთვა შესაძლებელია, მაგრამ ისინი სიაში რჩებიან. მიერთებული უნარები რენდერდება აგენტის სისტემური პრომპტის სტაბილურ პრეფიქსში.

ხელსაწყოების ჩართვა

ხელსაწყოების უმეტესობა ირთვება, როცა მათ კონფიგურაციას მიაწვდით. გავრცელებული გადამრთველები:

SEARXNG_URL=http://localhost:8888          # web_search
CLOAKBROWSER_CDP_URL=http://localhost:9222 # browser + computer
AIHUMMER_FS_ROOT=/srv/agent-files          # filesystem_read (sandboxed root)
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 დამოწმების მოსათხოვად ნებისმიერი გვერდითი ეფექტის მქონესთვის — ფოსტის გაგზავნა, კოდის გაშვება — ხოლო მხოლოდ-კითხვადი ხელსაწყოები გაუფილტრავად დატოვოთ.

სად შემდეგ

ნახეთ სრული თითო-ხელსაწყოს ცნობარი ხელსაწყოების კატალოგში.
გაიგეთ ის ციკლი, რომელიც ამ ხელსაწყოებს იძახებს ორკესტრაცია და ქვე-აგენტებში.
დააფუძნეთ ხელსაწყოს პასუხები თქვენს დოკუმენტებზე ცოდნა / RAG-ით.