Unelte
Unelte se referă la modul în care un agent acționează asupra lumii — preluând o pagină, căutând, trimițând e-mail, interogând o bază de date, generând un document. AiHummer oferă un set bogat catalog încorporat și un Timp de rulare al instrumentului care permite activarea instrumentelor atunci când sunt configurate, le reîncarcă fără o repornire, plasează pe cele riscante în spatele aprobării umane și poate bloca complet ieșirea în modul izolat de rețea.
Această pagină acoperă modul în care se comportă timpul de execuție și listează funcțiile incluse. Pentru referința completă, vezi catalog de unelte.
Cum se comportă runtime-ul instrumentului
- Activează-la-configurare. Un instrument devine disponibil doar atunci când prerequisitul său configurația este prezentă — de obicei o variabilă de mediu care indică către serviciul de care are nevoie. Nicio configurare, niciun instrument.
- Reîncărcare rapidă. Activarea uneltei se aplică fierbinte, fără a reporni gateway, astfel încât să poți activa și dezactiva funcționalități în timpul execuției.
- Poartă de aprobare. Uneltele riscante pot fi plasate în spatele unui om în buclă
poartă de aprobare prin
AIHUMMER_APPROVAL_TOOLS. Un apel respins este nu executat. - Mod izolat de rețea. Setare
AIHUMMER_AIRGAPPED=1blochează controlul modelului ieșire publică, pentru implementări suverane sau izolate.
[!WARNING]
code_execeste dezactivat implicit pe gazde partajate. Activați-l doar acolo unde sandbox și gazda sunt acceptabile pentru rularea codului creat de model, și ia în considerare a-l pune în spatele porții de aprobare.
Instrumente încorporate
| Unealtă | Ce face | Activează cu |
|---|---|---|
web_fetch |
Preia un URL (protejată împotriva SSRF) | activat implicit |
http_request |
Efectuează o cerere HTTP (protejată împotriva SSRF) | activat implicit |
web_search |
Căutare web prin SearXNG-ul încorporat | activat implicit; îl dezactivezi cu opțiunea instalatorului --no-search |
browser |
Conduceți un browser real prin CDP | activat implicit; îl dezactivezi cu opțiunea instalatorului --no-browser |
computer |
Utilizarea calculatorului prin CDP | activat implicit; îl dezactivezi cu opțiunea instalatorului --no-browser |
memory_store |
Stochează un fapt în memoria pe termen lung; cu modul de captare auto (implicit) devine căutabil imediat, cu review/off devine un candidat care așteaptă aprobarea |
activat implicit |
memory_search |
Caută în memoria pe termen lung | activat implicit |
filesystem_read |
Citirea unui fișier sau listarea unui director de pe discul serverului | activ implicit; AIHUMMER_FS_ROOT îngustează izolarea, gol = întregul server |
db_query |
Interogare a bazei de date doar pentru citire | AIHUMMER_DB_QUERY_DSN |
mail |
Trimite/primi e-mail (SMTP/IMAP) | credențiale de e-mail (seif) |
code_exec |
Rulează codul într-o zonă izolată (dezactivată implicit pe gazdele partajate) | AIHUMMER_CODE_EXEC |
doc_generate |
Generează documente CSV / TSV / XLSX sau HTML. | activat implicit |
tts |
Text-la-vorbire | TTS partener |
image_generate / edit_image |
Generează și editează imagini | backend de imagine configurat |
github_get_file |
Preia un fișier de pe GitHub | activat implicit |
generate_pairing_code |
Emiteți un cod de asociere a dispozitivului | activat implicit |
search_knowledge / deep_research |
Recuperarea cunoștințelor și cercetarea în mai multe etape | bază de cunoștințe |
| Bitrix24 CRM / sarcină / calendar | Bitrix24 CRM, acțiuni pentru sarcini și calendar | Plugin Bitrix24 |
| 1C (BIT.FINANȚĂ OData) | Acces 1C BIT.FINANȚE prin OData | 1C Configurare OData |
[!NOTE]
web_fetchșihttp_requestare pază de SSRF — ei refuză cererile de a adrese interne și alte ținte nesigure, astfel încât un model să nu le poată folosi pentru accesează rețeaua ta privată.
Profil de browser persistent
Implicit, computer deschide un browser curat la fiecare cerere. Începând cu
versiunea 1.3, instrumentul poate păstra un profil personal atribuit
explicit (cookie-uri și sesiuni ale site-urilor) între cereri — de exemplu,
pentru ca un angajat să-și gestioneze propriile conturi fără să se
autentifice de fiecare dată. Un profil nu este ales niciodată după un nume sau
o cale din argumentele modelului — doar printr-o legătură explicită a
operatorului:
AIHUMMER_BROWSER_PROFILE_SOCKET— calea absolută către socketul privatmanaged-profiles.sockal serviciului de browser instalat; gol (implicit) — profilurile persistente sunt dezactivate.AIHUMMER_BROWSER_PROFILE_BINDINGS— un array JSON de legături:profile_id,tenant_id,user_id,agent_idsșiconversation_ids(până la 64 de profiluri, fiecare cu un singur proprietar).
Un profil se deschide doar când utilizatorul curent este proprietarul său, iar
agentul și dialogul sunt enumerate în legătură; dialogul trebuie să fie privat,
fără alți participanți umani. Proprietarul și drepturile sunt verificate la
fiecare acțiune, nu doar la prima deschidere. Cât timp profilurile persistente
sunt activate, acțiunile computer se execută doar cu o legătură potrivită.
Este necesară o politică de rețea explicită a browserului — un
AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK setat (true sau false) sau o listă
AIHUMMER_BROWSER_ALLOWED_HOSTNAMES; cookie-urile unui browser extern nu sunt
importate. Ambele setări sunt considerate periculoase: în cloudul administrat și
pe instanța demo sunt blocate.
Abilități partajate
A abilitate este o instrucțiune reutilizabilă (un fragment de prompt) care poate fi atașată agenților. Biblioteca se află în UI-ul de administrare Abilități comune pagină: pentru a crea una, un nume și textul sunt suficiente — identificatorul (slug-ul) este derivat automat. Abilitățile livrate de furnizor din cutie includ un Gata de utilizare insignă; acestea pot fi dezactivate, dar rămân listate. Abilitățile atașate sunt redate în prefixul stabil al promptului de sistem al agentului.
Activarea instrumentelor
Cele mai multe unelte se pornesc atunci când furnizați configurația lor. Comutatoare comune:
AIHUMMER_FS_ROOT=/srv/agent-files # ÎNGUSTEAZĂ izolarea filesystem_read (gol = întregul server)
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] Folosește
AIHUMMER_APPROVAL_TOOLSa necesita aprobare pentru orice cu un garnitură efect — trimiterea de e-mailuri, executarea codului — lăsând în același timp neblocate uneltele doar pentru citire.
Unde următor?
- Vezi referința completă pentru fiecare unealtă în catalog de unelte.
- Înțelegeți bucla care apelează aceste instrumente Orchestrare și sub-agenti.
- Bazează răspunsurile instrumentului pe documentele tale cu Cunoștințe / RAG.
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.