Verktygskatalog

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

aihummer settings set AIHUMMER_AIRGAPPED 1

Under ett slag kan agenten kalla **verktyg**. AiHummer levererar en inbyggd verktygs-runtime: vissa verktyg är aktiverade som standard, andra aktiveras först när du tillhandahåller den nödvändiga konfigurationen. Verktyg är skyddade mot SSRF och körs i en sandlåda där det är relevant, och riskfyllda verktyg kan placeras bakom en godkännandegrind av en människa. ## Aktiverad som standard Dessa verktyg fungerar direkt (vissa beror på en konfigurerad modell eller kunskapsbas). | Verktyg | Vad det gör | Hur man aktiverar | |---|---|---| | `web_fetch` | Hämta innehållet på en URL. SSRF-skyddad. | På som standard | | `http_request` | Gör en utgående HTTP-förfrågan. SSRF-skyddad. | På som standard | | `web_search` | Sök på webben genom den inbyggda SearXNG. | På som standard (medföljer installationsprogrammet); stäng av med `--no-search` | | `browser` / `computer` | Styr en riktig webbläsare via Chrome DevTools-protokollet. | På som standard (medföljer installationsprogrammet); stäng av med `--no-browser` | | `memory_store` | Lagra ett faktum i långtidsminnet (Einstein). Med insamlingsläget `auto` (standardvalet) är faktumet sökbart omedelbart; med `review`/`off` blir det en kandidat som väntar på godkännande. Resultatet bär ett fält `searchable_now`. | På som standard | | `memory_search` | Sök i långtidsminnet (Einstein). | På som standard | | `doc_generate` | Generera dokument (CSV / TSV / XLSX). | På som standard | | `image_generate` / `edit_image` | Generera eller redigera bilder. | På som standard | | `github_get_file` | Hämta en enskild fil från ett GitHub-förråd. | På som standard | | `generate_pairing_code` | Utfärda en enhetsparningskod. | På som standard | | `search_knowledge` | Sök i kunskapsbasen (RAG) och stöd svar med citat. | Med en konfigurerad kunskapsbas | | `deep_research` | Utför forskning i flera steg och producera en rapport med referenser. | På som standard | | `docs_search` | Sök en **offlinekopia av denna dokumentation** (en snapshot från docs.aihummer.ru levereras i versionen, `share/docs`, ru/en) — agenten kan svara på produktfrågor utan internet. | Med dokumentationsöversikten närvarande (standardinstallation) | | `docs_read` | Läs en fullständig dokumentationssida som finns via `docs_search`. | Med dokumentationsöversikten närvarande (standardinstallation) | | `filesystem_read` | Läser en fil eller listar en katalog på serverns disk. | **Alltid på.** `AIHUMMER_FS_ROOT` slår inte på verktyget — den bara **begränsar** sandlådan: så länge värdet är tomt är sandlådans rot hela servern (`/`). | > [!DANGER] > **Vad som händer:** agenten läser varje fil som gatewayens tjänsteanvändare får > läsa — inklusive filen med databasens anslutningsuppgifter och nyckeln som > krypterar hemlighetsvalvet. > **Under vilket villkor:** så länge inställningen `AIHUMMER_FS_ROOT` är tom. > Det är standardläget direkt efter en installation på egen server. > **Så åtgärdar du det:** öppna **Hantering → Inställningar**, hitta > `AIHUMMER_FS_ROOT`, peka den på katalogen agenten verkligen behöver (till > exempel `/srv/agent-files`) och spara. Värdet bor i databasen — en rad i > `gateway.env` ignoreras för den här nyckeln. Lägg dessutom `filesystem_read` > i `AIHUMMER_APPROVAL_TOOLS` så att varje anrop väntar på ditt godkännande. > > I AiHummers hanterade moln ges verktyget inte till agenten alls — roten behöver > bara begränsas i din egen installation. ## Aktivera i konfiguration Dessa verktyg förblir avstängda tills du pekar dem på den resurs de behöver. Alla aktiveringsknappar (`AIHUMMER_DB_QUERY_DSN`, `AIHUMMER_CODE_EXEC`, …) är **Inställningskatalog** nycklar: ställ in dem i webbadmingränssnittet (**Administration → Inställningar**, det har sökning) eller med `aihummer settings set <KEY> <VALUE>`. Att sätta dem i `gateway.env` har **ingen effekt** — miljön ignoreras för dessa nycklar. | Verktyg | Vad det gör | Hur man aktiverar | |---|---|---| | `db_query` | Kör SQL-frågor i skrivskyddat läge. | `AIHUMMER_DB_QUERY_DSN` | | `mail` | Skicka och läsa e-post. | SMTP / IMAP-referenser | | `tts` | Syntetisera tal (text-till-tal). | `AIHUMMER_TTS_URL` (TTS sidovagn) | | `code_exec` | Kör kod i en sandlåda. | `AIHUMMER_CODE_EXEC` | > [!DANGER] > `code_exec` är **avstängt som standard på delade värdar**. Aktivera det endast i en > miljö som du kontrollerar och litar på, eftersom den kör modell-skriven kod. Även > sandboxad, behandla det som en privilegierad förmåga. ## Integrationsverktyg När den matchande anslutningen är konfigurerad får agenten också domänverktyg: | Verktyg | Vad det gör | Hur man aktiverar | |---|---|---| | Bitrix24 CRM / uppgifts- / kalenderverktyg | Läs och agera på Bitrix24 CRM-poster, uppgifter och kalender. | Bitrix24-anslutning konfigurerad | | 1C (BIT.FINANS OData) | Fråga 1C redovisningsdata över БИТ.ФИНАНС OData-gränssnittet. | 1C OData-anslutning konfigurerad | ## Godkännandekontroll Vilket verktyg som helst kan sättas bakom en **godkännandekontroll med mänsklig inblandning**. Lista verktygsnamnen i `AIHUMMER_APPROVAL_TOOLS` inställning (webbadmin UI: Hantering → Inställningar); innan ett sådant verktyg körs måste en operatör godkänna anropet. Ett avvisat anrop är **inte** verkställd. ```bash aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec ``` ## Luftspärrsläge Ställ in `AIHUMMER_AIRGAPPED` inställning till `1` att blockera modellkontrollerad offentlig åtkomst. I detta läge kan agenten inte nå det öppna internet via verktyg, vilket är lämpligt för suveräna eller isolerade installationer. ```bash aihummer settings set AIHUMMER_AIRGAPPED 1 ``` > [!NOTE] > Utöver den inbyggda katalogen kan AiHummer syntetisera verktyg från vilken OpenAPI 3.x som helst > specificera och exponera alla MCP-serververktyg utan någon integrationskod. Se > Marknadsplats- och pluginsektionen i dokumentationen. ## Vart härnäst - De variabler som refereras här i sin helhet: [Miljövariabler](/sv/v1.0/reference/env-vars). - Hantera den körande instansen: [CLI-referens](/sv/v1.0/reference/cli).