Verktyg — AiHummer Dokument

Verktyg är hur en agent agerar på världen — hämtar en sida, söker, skickar mail, frågar en databas, genererar ett dokument. AiHummer levereras med en rik inbyggd katalog och en Verktygskörningstid som gör det möjligt för verktyg när de är konfigurerade, laddar om dem utan en omstart, sätter de riskabla bakom mänskligt godkännande och kan helt låsa utgående trafik i luftgapläge.

Denna sida behandlar hur körningstiden beter sig och listar de inbyggda funktionerna. För fullständig referens, se verktygskatalog.

Hur verktygets runtime beter sig

Aktivera-på-konfiguration. Ett verktyg blir tillgängligt endast när dess förutsättning konfiguration är närvarande — vanligtvis en miljövariabel som pekar på service den behöver. Ingen konfiguration, inget verktyg.
Varm omladdning. Verktygsaktivering gäller het, utan att starta om gateway, så att du kan slå på och av funktioner under körning.
Godkännandets port. Riskabla verktyg kan placeras bakom en människa-i-slingan godkännandeport via AIHUMMER_APPROVAL_TOOLS. Ett avvisat samtal är inte verkställd.
Luftspärrläge. Inställning AIHUMMER_AIRGAPPED=1 blockerar modellkontrollerad publik utgång, för suveräna eller isolerade distributioner.

[!WARNING] code_exec är avstängd som standard på delade webbhotell. Aktivera det endast där sandbox och värd är acceptabla för att köra modell-skriven kod, och överväg sätta det bakom godkännandekontrollen.

Inbyggda verktyg

Verktyg	Vad det gör	Aktivera med
`web_fetch`	Hämta en URL (SSRF-skyddad)	på som standard
`http_request`	Gör en HTTP-begäran (SSRF-skyddad)	på som standard
`web_search`	Webbsökning via den inbyggda SearXNG	på som standard; stäng av med installationsflaggan `--no-search`
`browser`	Kör en riktig webbläsare över CDP	på som standard; stäng av med installationsflaggan `--no-browser`
`computer`	Datoranvändning över CDP	på som standard; stäng av med installationsflaggan `--no-browser`
`memory_store`	Lagra ett faktum i långtidsminnet; med insamlingsläget `auto` (standardvalet) blir det sökbart direkt, med `review`/`off` blir det en kandidat som väntar på godkännande	på som standard
`memory_search`	Sök i långtidsminnet	på som standard
`filesystem_read`	Läsa en fil eller lista en katalog på serverns disk	på som standard; `AIHUMMER_FS_ROOT` begränsar sandlådan, tomt = hela servern
`db_query`	Skrivskyddad databassökning	`AIHUMMER_DB_QUERY_DSN`
`mail`	Skicka/motta e-post (SMTP/IMAP)	mejlinloggning (valv)
`code_exec`	Kör kod i en sandlåda (avstängt som standard på delade värdar)	`AIHUMMER_CODE_EXEC`
`doc_generate`	Generera CSV/TSV/XLSX-dokument	på som standard
`tts`	Text-till-tal	TTS sidovagn
`image_generate` / `edit_image`	Skapa och redigera bilder	konfigurerad bildbackend
`github_get_file`	Hämta en fil från GitHub	på som standard
`generate_pairing_code`	Utfärda en enhetsparningskod	på som standard
`search_knowledge` / `deep_research`	Kunskapsinhämtning och flerstegsundersökning	kunskapsbas
Bitrix24 CRM / uppgift / kalender	Bitrix24 CRM, uppgifts- och kalenderåtgärder	Bitrix24-plugin
1C (BIT.FINANS OData)	1C BIT.FINANS åtkomst via OData	1C OData-konfiguration

[!NOTE] web_fetch och http_request är SSRF-skyddad — de avslår förfrågningar att interna adresser och andra osäkra mål, så en modell kan inte använda dem för att någ din privata nätverk.

Beständig webbläsarprofil

Som standard öppnar computer en ren webbläsare vid varje förfrågan. Från version 1.3 kan verktyget behålla en uttryckligen tilldelad personlig profil (kakor och webbplatssessioner) mellan förfrågningar — till exempel så att en medarbetare arbetar i sina egna konton utan att logga in varje gång. En profil väljs aldrig utifrån ett namn eller en sökväg i modellens argument — bara via en uttrycklig bindning från operatören:

AIHUMMER_BROWSER_PROFILE_SOCKET — den absoluta sökvägen till den privata managed-profiles.sock-socketen för den installerade webbläsartjänsten; tom (standard) — beständiga profiler är av.
AIHUMMER_BROWSER_PROFILE_BINDINGS — en JSON-array av bindningar: profile_id, tenant_id, user_id, agent_ids och conversation_ids (upp till 64 profiler med en ägare vardera).

En profil öppnas bara när den aktuella användaren är dess ägare och agenten och dialogen står i bindningen; dialogen måste vara privat, utan andra mänskliga deltagare. Ägare och rättigheter kontrolleras vid varje åtgärd, inte bara vid första öppningen. Medan beständiga profiler är på körs computer-åtgärder bara med en matchande bindning. En uttrycklig nätverkspolicy för webbläsaren krävs — ett satt AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK (true eller false) eller en AIHUMMER_BROWSER_ALLOWED_HOSTNAMES-lista; kakor från en extern webbläsare importeras inte. Båda inställningarna räknas som farliga: i det hanterade molnet och på demoinstansen är de låsta.

Delade färdigheter

A färdighet är en återanvändbar instruktion (en promptfragment) som kan kopplas till agenter. Biblioteket finns på admingränssnittets Delade färdigheter sida: för att skapa en räcker det med ett namn och texten — identifieraren (slug) härleds automatiskt. Färdigheter som levereras av leverantören direkt från början har en Upp ur lådan märke; de kan inaktiveras men förblir listade. Bifogade färdigheter återges i agentens systemprompts stabila prefix.

Aktiverande verktyg

De flesta verktyg slås på när du tillhandahåller deras konfiguration. Vanliga strömbrytare:

AIHUMMER_FS_ROOT=/srv/agent-files          # BEGRÄNSAR sandlådan för filesystem_read (tomt = hela servern)
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] Använd AIHUMMER_APPROVAL_TOOLS att kräva godkännande för allt med en sida effekt — skicka e-post, köra kod — samtidigt som skrivskyddade verktyg förblir öppna.

Vart härnäst

Se den fullständiga referensen för varje verktyg i verktygskatalog.
Förstå loopen som anropar dessa verktyg Orkestrering och underagenter.
Grunda verktygs svar i dina dokument med Kunskap / RAG.