Instrumente — AiHummer Documentație

Instrumentele sunt modul în care un agent acționează asupra lumii — aducerea unei pagini, căutarea, trimiterea de e-mail, interogarea unei baze de date, generarea unui document. AiHummer livrează un bogat catalog integrat și un Tool Runtime care activează instrumentele când sunt configurate, le reîncarcă fără un restart, le pune pe cele riscante în spatele aprobării umane și poate bloca complet egresul în mod air-gapped.

Această pagină acoperă cum se comportă runtime-ul și listează componentele integrate. Pentru referința completă, vezi catalogul de instrumente.

Cum se comportă Tool Runtime-ul

Activare-la-configurare. Un instrument devine disponibil doar când configurația sa prerechizită este prezentă — de obicei o variabilă de mediu care indică serviciul de care are nevoie. Fără configurare, fără instrument.
Reîncărcare la cald. Activarea instrumentelor se aplică la cald, fără a reporni gateway-ul, astfel încât poți activa și dezactiva capabilități la runtime.
Poartă de aprobare. Instrumentele riscante pot fi plasate în spatele unei porți de aprobare cu om în buclă prin AIHUMMER_APPROVAL_TOOLS. Un apel respins nu este executat.
Mod air-gapped. Setarea AIHUMMER_AIRGAPPED=1 blochează egresul public controlat de model, pentru deployment-uri suverane sau izolate.

[!WARNING] code_exec este dezactivat în mod implicit pe gazde partajate. Activează-l doar acolo unde sandbox-ul și gazda sunt acceptabile pentru a rula cod scris de model și ia în considerare punerea lui în spatele porții de aprobare.

Instrumente integrate

Tool	What it does	Enable with
`web_fetch`	Aduce un URL (protejat împotriva SSRF)	activat implicit
`http_request`	Face o cerere HTTP (protejat împotriva SSRF)	activat implicit
`web_search`	Căutare web prin SearXNG	`SEARXNG_URL`
`browser`	Conduce un browser real prin CDP	`CLOAKBROWSER_CDP_URL`
`computer`	Utilizare de computer prin CDP	`CLOAKBROWSER_CDP_URL`
`filesystem_read`	Citește fișiere într-o rădăcină de sandbox	`AIHUMMER_FS_ROOT`
`db_query`	Interogare de bază de date doar în citire	`AIHUMMER_DB_QUERY_DSN`
`mail`	Trimite/primește e-mail (SMTP/IMAP)	credențiale de mail (vault)
`code_exec`	Rulează cod într-un sandbox (dezactivat implicit pe gazde partajate)	`AIHUMMER_CODE_EXEC`
`doc_generate`	Generează documente CSV/TSV/XLSX	activat implicit
`tts`	Text-to-speech	sidecar TTS
`image_generate` / `edit_image`	Generează și editează imagini	backend de imagini configurat
`github_get_file`	Aduce un fișier de pe GitHub	activat implicit
`generate_pairing_code`	Emite un cod de împerechere a dispozitivului	activat implicit
`search_knowledge` / `deep_research`	Recuperare de cunoștințe și cercetare în mai mulți pași	bază de cunoștințe
Bitrix24 CRM / sarcină / calendar	Acțiuni CRM, de sarcină și de calendar Bitrix24	plugin Bitrix24
1C (БИТ.ФИНАНС OData)	Acces 1C БИТ.ФИНАНС prin OData	configurare 1C OData

[!NOTE] web_fetch și http_request sunt protejate împotriva SSRF — refuză cererile către adrese interne și alte ținte nesigure, astfel încât un model nu le poate folosi pentru a ajunge la rețeaua ta privată.

Skills partajate

Un skill este o instrucțiune reutilizabilă (un fragment de prompt) care poate fi atașată agenților. Biblioteca trăiește pe pagina „Skills partajate” a interfeței de administrare: la creare sunt suficiente numele și textul — identificatorul (slug) este derivat automat. Skills-urile livrate de vendor „din start” sunt marcate cu badge-ul „Out of the box”; ele pot fi dezactivate, dar rămân în listă. Skills-urile atașate sunt redate în prefixul stabil al promptului de sistem al agentului.

Activarea instrumentelor

Majoritatea instrumentelor se activează când le furnizezi configurația. Comutatoare comune:

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] Folosește AIHUMMER_APPROVAL_TOOLS pentru a cere aprobare pentru orice are un efect secundar — trimiterea de e-mail, rularea de cod — lăsând instrumentele doar-în-citire fără poartă.

Unde mergi mai departe

Vezi referința completă per instrument în catalogul de instrumente.
Înțelege bucla care apelează aceste instrumente în Orchestrare și sub-agenți.
Fundamentează răspunsurile instrumentelor în documentele tale cu Cunoștințe / RAG.