În timpul unei ture, agentul poate apela instrumente. AiHummer livrează un
runtime de instrumente încorporat: unele instrumente sunt active implicit, altele
se activează doar când furnizezi configurația necesară. Instrumentele sunt
protejate împotriva SSRF și izolate acolo unde este relevant, iar instrumentele
riscante pot fi puse în spatele unei porți de aprobare umană.
Activate implicit
Aceste instrumente funcționează din start (unele depind de un model sau de o bază
de cunoștințe configurată).
Instrument
Ce face
Cum se activează
web_fetch
Preia conținutul unui URL. Protejat împotriva SSRF.
Activat implicit
http_request
Face o cerere HTTP de ieșire. Protejat împotriva SSRF.
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 repository GitHub.
Activat implicit
generate_pairing_code
Emite un cod de pairing pentru dispozitiv.
Activat implicit
search_knowledge
Caută în baza de cunoștințe (RAG) și fundamentează răspunsurile cu citate.
Cu o bază de cunoștințe configurată
deep_research
Rulează cercetare în mai mulți pași și produce un raport cu citate.
Activat implicit
Activate la configurare
Aceste instrumente rămân dezactivate până le îndrepți către resursa de care au
nevoie.
Instrument
Ce face
Cum se activează
web_search
Caută pe web.
SEARXNG_URL (instanță SearXNG)
browser / computer
Conduce un browser real prin Chrome DevTools Protocol.
CLOAKBROWSER_CDP_URL (CDP, port implicit :9222)
filesystem_read
Citește fișiere, izolat sub un director rădăcină.
AIHUMMER_FS_ROOT
db_query
Rulează interogări SQL doar pentru citire.
AIHUMMER_DB_QUERY_DSN
mail
Trimite și citește email.
Credențiale SMTP / IMAP
tts
Sintetizează vorbire (text-to-speech).
AIHUMMER_TTS_URL (sidecar TTS)
code_exec
Execută cod într-un sandbox.
AIHUMMER_CODE_EXEC
[!DANGER]
code_exec este dezactivat implicit pe gazdele partajate. Activează-l doar
într-un mediu pe care îl controlezi și în care ai încredere, deoarece rulează cod
scris de model. Chiar și izolat, tratează-l ca pe o capabilitate privilegiată.
Instrumente de integrare
Când conexiunea corespunzătoare este configurată, agentul primește și instrumente
de domeniu:
Instrument
Ce face
Cum se activează
Instrumente Bitrix24 CRM / sarcini / calendar
Citește și acționează asupra înregistrărilor CRM, sarcinilor și calendarului Bitrix24.
Conexiune Bitrix24 configurată
1C (БИТ.ФИНАНС OData)
Interoghează datele contabile 1C prin interfața OData БИТ.ФИНАНС.
Conexiune 1C OData configurată
Poarta de aprobare
Orice instrument poate fi pus în spatele unei porți de aprobare
human-in-the-loop. Listează numele instrumentelor în AIHUMMER_APPROVAL_TOOLS;
înainte ca un astfel de instrument să ruleze, un operator trebuie să aprobe
apelul. Un apel respins nu este executat.
Setează AIHUMMER_AIRGAPPED=1 pentru a bloca egresul public controlat de model.
În acest mod, agentul nu poate ajunge la internetul deschis prin instrumente,
ceea ce este potrivit pentru implementări suverane sau izolate.
AIHUMMER_AIRGAPPED=1
[!NOTE]
Dincolo de catalogul încorporat, AiHummer poate sintetiza instrumente din orice
spec OpenAPI 3.x și poate expune instrumentele oricărui server MCP fără cod de
integrare. Vezi secțiunea Marketplace și pluginuri din documentație.
În timpul unei ture, agentul poate apela **instrumente**. AiHummer livrează un
runtime de instrumente încorporat: unele instrumente sunt active implicit, altele
se activează doar când furnizezi configurația necesară. Instrumentele sunt
protejate împotriva SSRF și izolate acolo unde este relevant, iar instrumentele
riscante pot fi puse în spatele unei porți de aprobare umană.
## Activate implicit
Aceste instrumente funcționează din start (unele depind de un model sau de o bază
de cunoștințe configurată).
| Instrument | Ce face | Cum se activează |
|---|---|---|
| `web_fetch` | Preia conținutul unui URL. Protejat împotriva SSRF. | Activat implicit |
| `http_request` | Face o cerere HTTP de ieșire. Protejat împotriva SSRF. | 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 repository GitHub. | Activat implicit |
| `generate_pairing_code` | Emite un cod de pairing pentru dispozitiv. | Activat implicit |
| `search_knowledge` | Caută în baza de cunoștințe (RAG) și fundamentează răspunsurile cu citate. | Cu o bază de cunoștințe configurată |
| `deep_research` | Rulează cercetare în mai mulți pași și produce un raport cu citate. | Activat implicit |
## Activate la configurare
Aceste instrumente rămân dezactivate până le îndrepți către resursa de care au
nevoie.
| Instrument | Ce face | Cum se activează |
|---|---|---|
| `web_search` | Caută pe web. | `SEARXNG_URL` (instanță SearXNG) |
| `browser` / `computer` | Conduce un browser real prin Chrome DevTools Protocol. | `CLOAKBROWSER_CDP_URL` (CDP, port implicit `:9222`) |
| `filesystem_read` | Citește fișiere, izolat sub un director rădăcină. | `AIHUMMER_FS_ROOT` |
| `db_query` | Rulează interogări SQL doar pentru citire. | `AIHUMMER_DB_QUERY_DSN` |
| `mail` | Trimite și citește email. | Credențiale SMTP / IMAP |
| `tts` | Sintetizează vorbire (text-to-speech). | `AIHUMMER_TTS_URL` (sidecar TTS) |
| `code_exec` | Execută cod într-un sandbox. | `AIHUMMER_CODE_EXEC` |
> [!DANGER]
> `code_exec` este **dezactivat implicit pe gazdele partajate**. Activează-l doar
> într-un mediu pe care îl controlezi și în care ai încredere, deoarece rulează cod
> scris de model. Chiar și izolat, tratează-l ca pe o capabilitate privilegiată.
## Instrumente de integrare
Când conexiunea corespunzătoare este configurată, agentul primește și instrumente
de domeniu:
| Instrument | Ce face | Cum se activează |
|---|---|---|
| Instrumente Bitrix24 CRM / sarcini / calendar | Citește și acționează asupra înregistrărilor CRM, sarcinilor și calendarului Bitrix24. | Conexiune Bitrix24 configurată |
| 1C (БИТ.ФИНАНС OData) | Interoghează datele contabile 1C prin interfața OData БИТ.ФИНАНС. | Conexiune 1C OData configurată |
## Poarta de aprobare
Orice instrument poate fi pus în spatele unei **porți de aprobare
human-in-the-loop**. Listează numele instrumentelor în `AIHUMMER_APPROVAL_TOOLS`;
înainte ca un astfel de instrument să ruleze, un operator trebuie să aprobe
apelul. Un apel respins **nu** este executat.
```ini
# /home/.aihummer/etc/gateway.env
AIHUMMER_APPROVAL_TOOLS=mail,code_exec
```
## Modul air-gapped
Setează `AIHUMMER_AIRGAPPED=1` pentru a bloca egresul public controlat de model.
În acest mod, agentul nu poate ajunge la internetul deschis prin instrumente,
ceea ce este potrivit pentru implementări suverane sau izolate.
```ini
AIHUMMER_AIRGAPPED=1
```
> [!NOTE]
> Dincolo de catalogul încorporat, AiHummer poate sintetiza instrumente din orice
> spec OpenAPI 3.x și poate expune instrumentele oricărui server MCP fără cod de
> integrare. Vezi secțiunea Marketplace și pluginuri din documentație.
## Unde mergi mai departe
- Variabilele referite aici, în întregime: [Variabile de mediu](/en/v1.0/reference/env-vars).
- Gestionează instanța în funcțiune: [Referință CLI](/en/v1.0/reference/cli).
