Godkjenningsporter
Noen verktøyringer bør ikke skje uten at et menneske sier ja — sende e-post, poste i en kanal, gjøre endringer med virkelige konsekvenser. AiHummer’s godkjenningsporter Sett en person i loopen før slike verktøy kjører, og kombiner med idempotente bieffekter slik at godkjenning av en gjenopprettet runde aldri utløser den samme handlingen to ganger.
Tier: godkjenningsporter er en kontroll i betalt nivå, ikke gratis/plattform-omfattende.
| Funksjon | Kjempe |
|---|---|
| Godkjenningsporter | Bedriftsnivå (Business+/Enterprise) |
Hvordan porten fungerer
Du erklærer hvilke verktøy som krever godkjenning med AIHUMMER_APPROVAL_TOOLS innstilling — en liste over verktøynavn. Når agenten bestemmer seg for å bruke et av disse verktøyene, pauses utførelsen og en godkjenningsforespørsel sendes for at et menneske skal vurdere den.
# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_requestDen ventende forespørselen vises i admingrensesnittet og admin-API-en (/v1/admin/approvals), der en vurderer ser verktøyet, dets argumenter og konteksten, og deretter godkjenner eller avviser det.
Godkjenn betyr kjør, avvis betyr ikke kjør
Porten er utvetydig:
- Godkjenn — verktøyet kjører med akkurat de argumentene som ble gjennomgått.
- Avvise — verktøyet er ikke utført. Det finnes ingen delvis eller utsatt utførelse; et avvist kall skjer rett og slett ikke, og turen fortsetter uten den bivirkningen.
[!NOTE] Et avslag er en hard stopp for den spesifikke samtalen. Agenten gjør det ikke stille prøv på nytt den avviste handlingen bak anmelderens rygg.
Hvorfor dette er trygt under gjenoppretting
Godkjenningsporter pares med AiHummers idempotente bivirkninger. En tur kan bli avbrutt (en omstart, en krasj) og deretter gjenopprettet. Uten beskyttelse kan en gjenopprettet tur utløse en handling som allerede har skjedd — sende den samme e-posten to ganger, poste den samme meldingen igjen.
AiHummer forhindrer dette med en gjenoppta-stabil hovedboknøkkel og en bivirkning barriere: hver bivirkning blir registrert under en stabil nøkkel, og barrieren nekter å kjøre en effekt på nytt som hovedboken viser allerede er utført.
[!TIP] Den praktiske gevinsten: å godkjenne en gjenopprettet tur gjør ikke dobbelt-ild mail eller kanal-send. Barrieren sørger for at effekten skjer nøyaktig én gang, om svingen ble gjenvunnet eller ikke.
Se Flerbrukerarkitektur og idempotens for hele mekanikken til hovedboken og bivirkningbarrieren.
Velge hvilke verktøy som skal sperres
Gateverktøy hvis effekter er synlige eksternt eller vanskelige å angre. Gode kandidater:
mail— utgående e-post.- Kanal-sending / utgående levering til kunder eller ansatte.
http_requestog andre verktøy som kan endre eksterne systemer.code_execpå delte verter (også slått av som standard der).
Skrivebeskyttede verktøy (søk, kunnskapssøk, tid) trenger vanligvis ikke en port. Kombiner godkjenningsporter med lufttett modus og utgående kontroller for verktøy som når det offentlige internettet.
Hvor til neste
- Flerbrukerarkitektur og idempotens — hovedboken og bivirkning-barrieren bak eksakt-en-gang-effekter.
- Rekkverk og forsvar mot prompt-injeksjon — behold modellen fra å bli styrt til å kalle et begrenset verktøy ondsinnet.
- Nettverk, revisjon og luftet gitt — begrense hva verktøy kan nå.