Alətlər — AiHummer Sənədlər

Alətlər agentin dünyaya təsir etmə üsuludur — bir səhifəni gətirmək, axtarış, poçt göndərmək, verilənlər bazasını sorğulamaq, sənəd yaratmaq. AiHummer zəngin daxili kataloq və alətləri konfiqurasiya edildikdə aktivləşdirən, onları yenidən başlatmadan yenidən yükləyən, riskli olanları insan təsdiqi arxasında qapayan və hava-boşluqlu rejimdə çıxışı tamamilə kilidləyə bilən bir Tool Runtime təqdim edir.

Bu səhifə runtime-ın necə davrandığını əhatə edir və daxili alətləri sadalayır. Tam istinad üçün baxın: alətlər kataloqu.

Tool Runtime necə davranır

Konfiqurasiyada-aktivləşmə. Alət yalnız onun ilkin şərt konfiqurasiyası mövcud olduqda — adətən ehtiyacı olan xidmətə işarə edən ətraf mühit dəyişəni — mövcud olur. Konfiqurasiya yoxdursa, alət də yoxdur.
İsti yenilənmə. Alət aktivləşdirməsi gateway-i yenidən başlatmadan isti tətbiq olunur, beləliklə imkanları icra zamanı aça və bağlaya bilərsiniz.
Təsdiq qapısı. Riskli alətlər AIHUMMER_APPROVAL_TOOLS vasitəsilə insan iştiraklı təsdiq qapısı arxasına yerləşdirilə bilər. Rədd edilən çağırış icra edilmir.
Hava-boşluqlu rejim. AIHUMMER_AIRGAPPED=1 təyini suveren və ya izolyasiya edilmiş yerləşdirmələr üçün model tərəfindən idarə olunan ictimai çıxışı bloklayır.

[!WARNING] code_exec ortaq hostlarda defolt olaraq söndürülüb. Onu yalnız izolyasiya (sandbox) və hostun model tərəfindən yazılmış kodu icra etmək üçün məqbul olduğu yerdə aktivləşdirin və onu təsdiq qapısı arxasına qoymağı nəzərə alın.

Daxili alətlər

Alət	Nə edir	Bununla aktivləşdir
`web_fetch`	URL gətir (SSRF-qorunan)	defolt olaraq aktiv
`http_request`	HTTP sorğusu et (SSRF-qorunan)	defolt olaraq aktiv
`web_search`	SearXNG ilə veb axtarışı	`SEARXNG_URL`
`browser`	CDP üzərindən real brauzeri idarə et	`CLOAKBROWSER_CDP_URL`
`computer`	CDP üzərindən kompüter istifadəsi	`CLOAKBROWSER_CDP_URL`
`filesystem_read`	İzolyasiyalı kökdə faylları oxu	`AIHUMMER_FS_ROOT`
`db_query`	Yalnız-oxuma verilənlər bazası sorğusu	`AIHUMMER_DB_QUERY_DSN`
`mail`	Poçt göndər/al (SMTP/IMAP)	poçt etibarnamələri (seyf)
`code_exec`	Kodu izolyasiyada (sandbox) icra et (ortaq hostlarda defolt söndürülüb)	`AIHUMMER_CODE_EXEC`
`doc_generate`	CSV/TSV/XLSX sənədləri yarat	defolt olaraq aktiv
`tts`	Mətndən nitqə	TTS sidecar
`image_generate` / `edit_image`	Şəkilləri yarat və redaktə et	konfiqurasiya edilmiş şəkil backend-i
`github_get_file`	GitHub-dan fayl gətir	defolt olaraq aktiv
`generate_pairing_code`	Cihaz cütləşmə kodu ver	defolt olaraq aktiv
`search_knowledge` / `deep_research`	Bilik əldəetməsi və çoxaddımlı tədqiqat	bilik bazası
Bitrix24 CRM / tapşırıq / təqvim	Bitrix24 CRM, tapşırıq və təqvim əməliyyatları	Bitrix24 plagini
1C (БИТ.ФИНАНС OData)	OData üzərindən 1C БИТ.ФИНАНС girişi	1C OData konfiqurasiyası

[!NOTE] web_fetch və http_request SSRF-qorunandır — onlar daxili ünvanlara və digər təhlükəsiz olmayan hədəflərə sorğuları rədd edir, beləliklə model onları sizin özəl şəbəkənizə çatmaq üçün istifadə edə bilməz.

Ümumi bacarıqlar

Bacarıq agentlərə qoşula bilən yenidən istifadə olunan təlimatdır (prompt parçası). Kitabxana admin UI-nin «Ümumi bacarıqlar» səhifəsində yaşayır: yaratmaq üçün ad və mətn kifayətdir — identifikator (slug) avtomatik çıxarılır. Vendor tərəfindən «qutudan çıxan kimi» göndərilən bacarıqlar «Qutudan çıxan» nişanı ilə işarələnir; onları söndürmək olar, lakin siyahıda qalırlar. Qoşulmuş bacarıqlar agentin sistem promptunun stabil prefiksinə render olunur.

Alətlərin aktivləşdirilməsi

Əksər alətlər siz onların konfiqurasiyasını təqdim etdikdə işə düşür. Ümumi açarlar:

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] Yan təsiri olan istənilən şey üçün — poçt göndərmə, kod icrası — təsdiq tələb etmək üçün AIHUMMER_APPROVAL_TOOLS istifadə edin, yalnız-oxuma alətləri isə qapısız buraxın.

Sonra haraya

Hər alət üzrə tam istinadı alətlər kataloqu bölməsində görün.
Bu alətləri çağıran dövrəni Orkestrasiya və alt-agentlər bölməsində öyrənin.
Alət cavablarını sənədlərinizə əsaslandırın: Bilik / RAG.