Verktyg
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=1blockerar 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 |
Skapa CSV-, TSV-, XLSX- eller HTML-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_fetchochhttp_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 privatamanaged-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_idsochconversation_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_TOOLSatt 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.
HTML-dokument
Agenten använder doc_generate med format: "html" för att skapa en HTML-bilaga på högst 4 MiB i UTF-8. CSS och JavaScript bevaras. En kompatibel uppdaterad app öppnar den sparade filen i en isolerad förhandsvisning efter kontroll av källa och integritet. Appens inloggningsuppgifter överförs inte; ändrad fil, källa eller session ogiltigförklarar förhandsvisningen.