Verktøykatalog

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

aihummer settings set AIHUMMER_AIRGAPPED 1

Under en tur kan agenten ringe **verktøy**. AiHummer leverer en innebygd verktøytid: noen verktøy er aktive som standard, andre aktiveres bare når du gir nødvendig konfigurasjon. Verktøyene er beskyttet mot SSRF og isolert der det er relevant, og risikable verktøy kan settes bak en menneskelig godkjenningsgrense. ## Aktivert som standard Disse verktøyene fungerer rett ut av boksen (noen avhenger av en konfigurert modell eller kunnskapsbase). | Verktøy | Hva det gjør | Hvordan aktivere | |---|---|---| | `web_fetch` | Hent innholdet fra en URL. Beskyttet mot SSRF. | På som standard | | `http_request` | Foreta en utgående HTTP-forespørsel. SSRF-beskyttet. | På som standard | | `web_search` | Søk på nettet gjennom den innebygde SearXNG. | På som standard (følger med installasjonsprogrammet); slå det av med `--no-search` | | `browser` / `computer` | Kjør en ekte nettleser via Chrome DevTools-protokollen. | På som standard (følger med installasjonsprogrammet); slå det av med `--no-browser` | | `memory_store` | Lagre et faktum i langtidsminnet (Einstein). Med innsamlingsmodus `auto` (standardvalget) er faktumet søkbart umiddelbart; med `review`/`off` blir det en kandidat som venter på godkjenning. Resultatet bærer et `searchable_now`-felt. | På som standard | | `memory_search` | Søk i langtidsminnet (Einstein). | På som standard | | `doc_generate` | Generer dokumenter (CSV / TSV / XLSX). | På som standard | | `image_generate` / `edit_image` | Generer eller rediger bilder. | På som standard | | `github_get_file` | Hent en enkelt fil fra et GitHub-depot. | På som standard | | `generate_pairing_code` | Utsted en enhetsparekode. | På som standard | | `search_knowledge` | Søk i kunnskapsbasen (RAG) og underbygg svar med kilder. | Med en konfigurert kunnskapsbase | | `deep_research` | Utfør forskning over flere trinn og produsér en rapport med kilder. | På som standard | | `docs_search` | Søk en **offline kopi av denne dokumentasjonen** (et docs.aihummer.ru-øyeblikksbilde følger med i utgivelsen, `share/docs`, ru/en) — agenten kan svare på produktspørsmål uten internett. | Med dokumentasjonens øyeblikksbilde til stede (standard installasjon) | | `docs_read` | Les en full dokumentasjonsside funnet via `docs_search`. | Med dokumentasjonens øyeblikksbilde til stede (standard installasjon) | | `filesystem_read` | Leser en fil eller lister en katalog på serverens disk. | **Alltid på.** `AIHUMMER_FS_ROOT` slår det ikke på — den bare **snevrer inn** sandkassen: så lenge verdien er tom, er sandkasserota hele serveren (`/`). | > [!DANGER] > **Hva som skjer:** agenten leser enhver fil som tjenestebrukeren til gatewayen > kan lese — inkludert filen med databasens tilkoblingsparametere og nøkkelen som > krypterer hemmelighetslageret. > **Under hvilken betingelse:** så lenge innstillingen `AIHUMMER_FS_ROOT` er tom. > Det er standardtilstanden rett etter en installasjon på egen server. > **Slik retter du det:** åpne **Administrasjon → Innstillinger**, finn > `AIHUMMER_FS_ROOT`, pek den til katalogen agenten faktisk trenger (for > eksempel `/srv/agent-files`) og lagre. Verdien ligger i databasen — en linje i > `gateway.env` ignoreres for denne nøkkelen. Legg dessuten `filesystem_read` i > `AIHUMMER_APPROVAL_TOOLS` slik at hvert kall venter på din godkjenning. > > I AiHummers administrerte sky gis verktøyet ikke til agenten i det hele tatt — > rota må bare snevres inn i din egen installasjon. ## Aktiver på konfigurering Disse verktøyene forblir av til du peker dem mot ressursen de trenger. Alle aktiveringsknappene (`AIHUMMER_DB_QUERY_DSN`, `AIHUMMER_CODE_EXEC`, …) er **Innstillingskatalog** taster: sett dem i webadmin-grensesnittet (**Administrasjon → Innstillinger**, det har søk) eller med `aihummer settings set <KEY> <VALUE>`. Å sette dem inn `gateway.env` har **ingen effekt** — miljøet blir ignorert for disse nøklene. | Verktøy | Hva det gjør | Hvordan aktivere | |---|---|---| | `db_query` | Kjør SQL-spørringer kun for lesing. | `AIHUMMER_DB_QUERY_DSN` | | `mail` | Send og les e-post. | SMTP / IMAP legitimasjon | | `tts` | Syntetiser tale (tekst-til-tale). | `AIHUMMER_TTS_URL` (TTS sidevogn) | | `code_exec` | Kjør kode i en sandkasse. | `AIHUMMER_CODE_EXEC` | > [!DANGER] > `code_exec` er **av som standard på delte verter**. Slå det bare på i en > miljøet du kontrollerer og stoler på, fordi det kjører kode skrevet av modellen. Selv > isolert, behandle det som en privilegert funksjon. ## Integrasjonsverktøy Når den matchende tilkoblingen er konfigurert, får agenten også domeneverktøy: | Verktøy | Hva det gjør | Hvordan aktivere | |---|---|---| | Bitrix24 CRM / oppgave / kalenderverktøy | Les og håndter Bitrix24 CRM-poster, oppgaver og kalender. | Bitrix24-tilkobling konfigurert | | 1C (BIT.FINANS OData) | Forespør 1C regnskapsdata over БИТ.ФИНАНС OData-grensesnittet. | 1C OData-tilkobling konfigurert | ## Godkjenningsport Enhver verktøy kan settes bak en **menneskelig-i-sløyfen-godkjenningsport**. List verktøynavnene i `AIHUMMER_APPROVAL_TOOLS` innstilling (webadmin UI: Management → Settings); før et slikt verktøy kjører, må en operatør godkjenne anropet. Et avvist anrop er **ikke** utført. ```bash aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec ``` ## Luft-gap-modus Sett `AIHUMMER_AIRGAPPED` innstilling til `1` for å blokkere modellkontrollert offentlig utgang. I denne modusen kan ikke agenten få tilgang til det åpne internett gjennom verktøy, noe som er passende for suverene eller isolerte distribusjoner. ```bash aihummer settings set AIHUMMER_AIRGAPPED 1 ``` > [!NOTE] > Utover den innebygde katalogen, kan AiHummer syntetisere verktøy fra enhver OpenAPI 3.x > spesifikasjon og eksponere verktøyene til enhver MCP-server uten integrasjonskode. Se > Markedsplass- og pluginseksjon i dokumentasjonen. ## Hvor til neste - Variablene som refereres til her i full: [Miljøvariabler](/no/v1.0/reference/env-vars). - Administrer den kjørende instansen: [CLI-referanse](/no/v1.0/reference/cli).