Catalog de unelte — AiHummer Documentație

În timpul unui tur, agentul poate să sune unelte. AiHummer livrează un runtime de unelte încorporat: unele unelte sunt activate implicit, altele se activează doar când furnizezi configurația necesară. Uneltele sunt protejate împotriva SSRF și izolate în sandbox acolo unde este relevant, iar uneltele riscante pot fi plasate în spatele unei aprobări umane.

Activat implicit

Aceste instrumente funcționează imediat (unele depind de un model sau o bază de cunoștințe configurată).

Unealtă	Ce face	Cum să activezi
`web_fetch`	Preia conținutul unui URL. Protejat împotriva SSRF.	Activat implicit
`http_request`	Efectuează o cerere HTTP de ieșire. Protejat împotriva SSRF.	Activat implicit
`web_search`	Caută pe web prin SearXNG-ul încorporat.	Activat implicit (livrat cu instalatorul); îl dezactivezi cu `--no-search`
`browser` / `computer`	Controlează un browser real prin Protocolul Chrome DevTools.	Activat implicit (livrat cu instalatorul); îl dezactivezi cu `--no-browser`
`memory_store`	Stochează un fapt în memoria pe termen lung (Einstein). Cu modul de captare `auto` (implicit) faptul devine căutabil imediat; cu `review`/`off` devine un candidat care așteaptă aprobarea. Rezultatul poartă un câmp `searchable_now`.	Activat implicit
`memory_search`	Caută în memoria pe termen lung (Einstein).	Activat implicit
`doc_generate`	Generează documente (CSV / TSV / XLSX).	Activat implicit
`image_generate` / `edit_image`	Generează sau editează imagini.	Activat implicit
`github_get_file`	Preia un singur fișier dintr-un depozit GitHub.	Activat implicit
`generate_pairing_code`	Emite un cod de asociere a dispozitivului.	Activat implicit
`search_knowledge`	Caută în baza de cunoștințe (RAG) și fundamentează răspunsurile cu citări.	Cu o bază de cunoștințe configurată
`deep_research`	Realizează cercetări în mai mulți pași și produce un raport cu citări.	Activat implicit
`docs_search`	Caută un copie offline a acestei documentații (un snapshot docs.aihummer.ru este inclus în lansare, `share/docs`, ru/en) — agentul poate răspunde la întrebări despre produs fără internet.	Cu instantaneul documentelor prezent (instalare standard)
`docs_read`	Citește o pagină de documentație completă găsită prin `docs_search`.	Cu instantaneul documentelor prezent (instalare standard)
`filesystem_read`	Citește un fișier sau listează un director de pe discul serverului.	Mereu activ. `AIHUMMER_FS_ROOT` nu îl activează, ci doar îngustează izolarea: cât timp valoarea este goală, rădăcina este întregul server (`/`).

[!DANGER] Ce se întâmplă: agentul citește orice fișier pe care îl poate citi utilizatorul serviciului gateway — inclusiv fișierul cu datele de conectare la baza de date și cheia care criptează seiful de secrete. În ce condiție: cât timp setarea AIHUMMER_FS_ROOT este goală. Aceasta este starea implicită imediat după o instalare pe server propriu. Cum se remediază: deschideți Administrare → Setări, găsiți AIHUMMER_FS_ROOT, indicați directorul de care agentul chiar are nevoie (de exemplu /srv/agent-files) și salvați. Valoarea se păstrează în baza de date — o linie în gateway.env este ignorată pentru această cheie. În plus, adăugați filesystem_read în AIHUMMER_APPROVAL_TOOLS, ca fiecare apel să aștepte aprobarea dumneavoastră.

În cloudul administrat AiHummer unealta nu ajunge deloc la agent — rădăcina trebuie îngustată doar pe instalarea proprie.

Activează la configurare

Aceste unelte rămân oprite până când le îndrepți către resursa de care au nevoie. Toate butoanele de activare (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) sunt Catalog de setări chei: setează-le în interfața de administrare web (Management → Setări, are căutare) sau cu aihummer settings set <KEY> <VALUE>. Punându-le în gateway.env are fără efect — mediul este ignorat pentru aceste chei.

Unealtă	Ce face	Cum să activezi
`db_query`	Rulează interogări SQL doar pentru citire.	`AIHUMMER_DB_QUERY_DSN`
`mail`	Trimite și citește emailuri.	Date de autentificare SMTP / IMAP
`tts`	Sintetizează vorbire (text-în-vorbire).	`AIHUMMER_TTS_URL` (Fișier TTS secundar)
`code_exec`	Execută codul într-un mediu izolat.	`AIHUMMER_CODE_EXEC`

[!DANGER] code_exec este dezactivat implicit pe gazdele partajate. Activează-l doar într-un mediu pe care îl controlați și în care aveți încredere, deoarece rulează cod creat de model. Chiar și izolat, tratează-l ca pe o capacitate privilegiată.

Instrumente de integrare

Când conexiunea corespunzătoare este configurată, agentul primește și instrumente de domeniu:

Unealtă	Ce face	Cum să activezi
Instrumente Bitrix24 CRM / sarcini / calendar	Citește și acționează asupra înregistrărilor, sarcinilor și calendarului CRM Bitrix24.	Conexiunea Bitrix24 configurată
1C (BIT.FINANȚĂ OData)	Interogați datele contabile 1C prin interfața OData БИТ.ФИНАНС.	Conexiune 1C OData configurată

Poartă de aprobare

Orice unealtă poate fi pusă în spatele unui poartă de aprobare cu intervenție umană. Listează numele uneltelor în AIHUMMER_APPROVAL_TOOLS setare (UI web admin: Management → Setări); înainte ca un astfel de instrument să ruleze, un operator trebuie să aprobe apelul. Un apel refuzat este nu executat.

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

Mod izolat de rețea

Setează AIHUMMER_AIRGAPPED setare la 1 pentru a bloca ieșirea publică controlată de model. În acest mod, agentul nu poate accesa internetul deschis prin instrumente, ceea ce este potrivit pentru implementări suverane sau izolate.

aihummer settings set AIHUMMER_AIRGAPPED 1

[!NOTE] Dincolo de catalogul integrat, AiHummer poate sintetiza instrumente din orice OpenAPI 3.x specificați și expuneți orice instrumente ale unui server MCP fără cod de integrare. Vedeți Secțiunea Marketplace & Plugins din documentație.

Unde următor?

Variabilele menționate aici în întregime: Variabile de mediu.
Gestionați instanța care rulează: Referință CLI.