Catalog de unelte
Î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 sau HTML. | Activat implicit |
image_generate / edit_image |
Generează sau editează imagini. | Necesită un serviciu de imagini configurat; editarea cere și suportul acelei operații în serviciul respectiv. |
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. | Implicit, propriul dosar de lucru al agentului; accesul la gazdă cere alegerea explicită a izolării acestui agent de către proprietar. Indisponibil în cloudul administrat și în demonstrație. |
[!NOTE]
AIHUMMER_FS_ROOTrestrânge suplimentar rădăcina permisă; o valoare goală nu oferă acces la întregul server. Setările instalării, datele sale de acces la baza de date și cheile de criptare, precum și mediile proceselor, nu pot fi citite. Aprobarea nu extinde domeniul permis al fișierelor.
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_execeste dezactivat implicit. Activați-l numai într-un mediu controlat și de încredere: execută cod scris de model și rămâne o capacitate privilegiată chiar și într-un mediu izolat.
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.
Documente HTML
Agentul folosește doc_generate cu format: "html" pentru a crea un atașament HTML UTF-8 de cel mult 4 MiB. CSS și JavaScript sunt păstrate. O aplicație compatibilă și actualizată deschide fișierul salvat într-o previzualizare izolată după verificarea sursei și integrității. Datele de acces ale aplicației nu sunt transmise; schimbarea fișierului, sursei sau sesiunii invalidează previzualizarea.