AiHummer
Eesti▾
SisselogimineKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Turvalisus/Kinnituse väravad

Kinnituse väravad

v1.2.x · uuendatud 2026-06-26

Mõned tööriista kutsed ei tohiks toimuda ilma inimese nõusolekuta — e-kirjade saatmine, kanalis postitamine, muudatuste tegemine, millel on tegeliku maailma tagajärjed. AiHummeri heakskiidu väravad pane inimene protsessi vahele enne, kui sellised tööriistad käivituvad, ja ühenda see idempotentsete kõrvalmõjudega, nii et taastatud toimingu heakskiitmine ei käivitaks sama tegevust kaks korda.

Tase: heakskiidulülid on tasulise taseme kontroll, mitte tasuta/platvormiülene.

Funktsioon Tase
Kinnituse väravad Ettevõttele suunatud (Business+/Enterprise)

Kuidas värav töötab

Te teavitab, millised tööriistad vajavad heakskiitu AIHUMMER_APPROVAL_TOOLS seade — tööriistade nimede loend. Kui agent otsustab ühe neist tööriistadest kutsuda, peatub täideviimine ja inimesele vaatamiseks esitatakse kinnitusnõue.

# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_request

Ootel päring kuvatakse administraatori kasutajaliideses ja administraatori API-s (/v1/admin/approvals), kus ülevaataja näeb tööriista, selle argumente ja konteksti, ning seejärel kinnitab või lükkab selle tagasi.

Kinnita tähendab käivitada, tagasi lükata tähendab mitte käivitada

värav on ühemõtteline:

  • Heaks kiita — tööriist käivitub täpselt nende argumentidega, mis üle vaadati.
  • Keelduma — tööriist on mitte täidetud. Ei ole mingit osalist ega edasi lükatud täideviimine; tagasi lükatud kõne lihtsalt ei toimu ja kord jätkub ilma selle kõrvalmõjuta.

[!NOTE] Tagasilükkamine on selle konkreetse kõne jaoks kindel peatus. Agendi ei tee seda vaikselt proovi tagasi lükatud toimingut teha kriitiku selja taga uuesti.

Miks see on taastumise ajal ohutu

Kinnituse väravad töötavad koos AiHummeriga idempotentsed kõrvaltoimed. Käik võib katkeda (taaskäivitamine, krahh) ja seejärel taastuda. Ilma kaitseta võib taastatud käik esitada juba toimunud tegevuse uuesti — saates sama e-kirja kaks korda, postitades sama sõnumi uuesti.

AiHummer takistab seda koos taasalusta-stabiilne pearaamatu võti ja üks kõrvaltoime tõke: iga kõrvaltoime salvestatakse stabiilse võtme alla ja barjäär keelab uuesti mõju käivitamise, mis pearaamat näitab juba teostatut.

[!TIP] Praktiline kasu: taastatud pöörde kinnitamine teeb ei topelt-tuli mail või channel-send. Barjäär tagab, et efekt toimub täpselt üks kord, kas pöörde taastamine õnnestus või mitte.

See Mitmeinimelisus ja idempotentsus päeviku täielike mehhanismide ja kõrvalmõjude barjääri jaoks.

Otsustamine, milliseid tööriistu piirata

Väravate tööriistad, mille mõjud on välimuselt nähtavad või raskesti tagasipööratavad. Head kandidaadid:

  • mail — väljuv e-kiri.
  • Kanal-saada / väljaminev kohaletoimetamine klientidele või töötajatele.
  • http_request ja muud tööriistad, mis võivad muutma väliseid süsteeme.
  • code_exec on jagatud hostid (samuti välja lülitatud vaikimisi seal).

Ainult lugemiseks mõeldud tööriistu (otsing, teadmiste otsing, aeg) tavaliselt värav ei vaja. Kombineeri heakskiiduväravaid koos õhueraldatud režiim ja väljundi juhtimine tööriistade jaoks, mis jõuavad avalikku internetti.

Kuhu järgmine