Værktøjskatalog
Under en tur kan agenten kalde værktøjer. AiHummer leverer en indbygget værktøjsruntime: nogle værktøjer er aktiveret som standard, andre aktiveres kun, når du leverer den nødvendige konfiguration. Værktøjer er SSRF-beskyttede og sandboxede, hvor det er relevant, og risikable værktøjer kan placeres bag en menneskelig godkendelsesbarriere.
Aktiveret som standard
Disse værktøjer fungerer direkte (nogle afhænger af en konfigureret model eller vidensbase).
| Værktøj | Hvad det gør | Sådan aktiveres |
|---|---|---|
web_fetch |
Hent indholdet af en URL. SSRF-beskyttet. | Tændt som standard |
http_request |
Foretag en udgående HTTP-anmodning. SSRF-beskyttet. | Tændt som standard |
web_search |
Søg på nettet gennem den indbyggede SearXNG. | Tændt som standard (følger med installationsprogrammet); slå det fra med --no-search |
browser / computer |
Styr en rigtig browser via Chrome DevTools-protokollen. | Tændt som standard (følger med installationsprogrammet); slå det fra med --no-browser |
memory_store |
Gem et faktum i langtidshukommelsen (Einstein). Med opsamlingstilstanden auto (standarden) er faktummet søgbart med det samme; med review/off bliver det en kandidat, der afventer godkendelse. Resultatet bærer et searchable_now felt. |
Tændt som standard |
memory_search |
Søg i langtidshukommelsen (Einstein). | Tændt som standard |
doc_generate |
Opret CSV-, TSV-, XLSX- eller HTML-dokumenter. | Tændt som standard |
image_generate / edit_image |
Generer eller rediger billeder. | Kræver en konfigureret billedtjeneste; redigering kræver desuden, at tjenesten understøtter billedredigering. |
github_get_file |
Hent en enkelt fil fra et GitHub-arkiv. | Tændt som standard |
generate_pairing_code |
Udsted en enhedsparringskode. | Tændt som standard |
search_knowledge |
Søg i vidensbasen (RAG) og underbyg svar med citater. | Med en konfigureret vidensbase |
deep_research |
Udfør flertrinsforskning og udarbejd en citeret rapport. | Tændt som standard |
docs_search |
Søg en offline kopi af denne dokumentation (et snapshot fra docs.aihummer.ru følger med i udgivelsen, share/docs, ru/en) — agenten kan besvare produktspørgsmål uden internet. |
Med docs-snapshot til stede (standardinstallering) |
docs_read |
Læs en fuld dokumentationsside fundet via docs_search. |
Med docs-snapshot til stede (standardinstallering) |
filesystem_read |
Læser en fil eller viser indholdet af en mappe på serverens disk. | Som standard agentens egen arbejdsmappe; adgang til værtsmaskinen kræver, at ejeren udtrykkeligt vælger isoleringstilstand for denne agent. Ikke tilgængelig i administreret sky eller demo. |
[!NOTE]
AIHUMMER_FS_ROOTindsnævrer den tilladte rod yderligere; en tom værdi giver ikke adgang til hele serveren. Installationens indstillinger, databaseoplysninger og krypteringsnøgler samt procesmiljøer kan ikke læses. Godkendelse udvider ikke det tilladte filområde.
Aktivér i konfiguration
Disse værktøjer forbliver slukkede, indtil du peger dem mod den ressource, de har brug for. Alle aktiveringsknapperne (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) er Indstillingskatalog taster: indstil dem i webadministrationsgrænsefladen (Administration → Indstillinger, det har søgning) eller med aihummer settings set <KEY> <VALUE>. At sætte dem i gateway.env har ingen effekt — miljøet ignoreres for disse nøgler.
| Værktøj | Hvad det gør | Sådan aktiveres |
|---|---|---|
db_query |
Kør SQL-forespørgsler med skrivebeskyttet adgang. | AIHUMMER_DB_QUERY_DSN |
mail |
Send og læs e-mail. | SMTP / IMAP legitimationsoplysninger |
tts |
Syntetiser tale (tekst-til-tale). | AIHUMMER_TTS_URL (TTS sidecar) |
code_exec |
Kør kode i en sandkasse. | AIHUMMER_CODE_EXEC |
[!DANGER]
code_execer slået fra som standard. Aktivér det kun i et miljø, du kontrollerer og stoler på: det kører modelskrevet kode og er en privilegeret funktion selv i en sandkasse.
Integrationsværktøjer
Når den matchende forbindelse er konfigureret, får agenten også domæneværktøjer:
| Værktøj | Hvad det gør | Sådan aktiveres |
|---|---|---|
| Bitrix24 CRM / opgave / kalender værktøjer | Læs og håndter Bitrix24 CRM-poster, opgaver og kalender. | Bitrix24-forbindelse konfigureret |
| 1C (BIT.FINANS OData) | Forespørg 1C-regnskabsdata over БИТ.ФИНАНС OData-grænsefladen. | 1C OData-forbindelse konfigureret |
Godkendelsesport
Enhver værktøj kan sættes bag en godkendelsesport med menneskelig indblanding. List værktøjsnavnene i AIHUMMER_APPROVAL_TOOLS indstilling (webadmin UI: Management → Settings); før et sådant værktøj kører, skal en operatør godkende kaldet. Et afvist kald er ikke udført.
aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec
Luftspærret tilstand
Indstil AIHUMMER_AIRGAPPED indstilling til 1 at blokere modelstyret offentlig adgang. I denne tilstand kan agenten ikke få adgang til internettet gennem værktøjer, hvilket er passende for suveræne eller isolerede implementeringer.
aihummer settings set AIHUMMER_AIRGAPPED 1
[!NOTE] Ud over den indbyggede katalog kan AiHummer syntetisere værktøjer fra enhver OpenAPI 3.x specificer og eksponer ethvert MCP-serverværktøj uden integrationskode. Se Markedsplads- og pluginsektionen i dokumentationen.
Hvor til næste
- De variabler, der refereres til her, i fuld: Miljøvariabler.
- Administrer den kørende instans: CLI-reference.
HTML-dokumenter
Agenten bruger doc_generate med format: "html" til at oprette en HTML-vedhæftning på højst 4 MiB i UTF-8. CSS og JavaScript bevares. En kompatibel opdateret app åbner den gemte fil i en isoleret forhåndsvisning efter kontrol af kilde og integritet. Appens loginoplysninger overføres ikke; ændret fil, kilde eller session gør forhåndsvisningen ugyldig.