Patvirtinimo vartai
Kai kurių įrankių kvietimų neturėtų vykti be žmogaus sutikimo — siųsti laiškus, skelbti kanale, daryti pakeitimus, turinčius realių pasekmių. AiHummer’s patvirtinimo vartai įtraukite žmogų į procesą prieš paleidžiant tokius įrankius ir derinkite su idempotentiniais šalutiniais efektais, kad patvirtinus atkurtą veiksmą tas pats veiksmas nebūtų vykdomas dukart.
Lygis: tvirtinimo vartai yra mokamo lygio kontrolė, o ne nemokama/visoje platformoje.
| Funkcija | Lygis |
|---|---|
| Patvirtinimo vartai | Įmonės lygio (Verslas+/Įmonė) |
Kaip veikia vartai
Jūs nurodote, kurie įrankiai reikalauja patvirtinimo su AIHUMMER_APPROVAL_TOOLS nustatymas — įrankių pavadinimų sąrašas. Kai agentas nusprendžia iškviesti vieną iš tų įrankių, vykdymas sustabdomas ir sukuriamas patvirtinimo prašymas, kad žmogus galėtų peržiūrėti.
# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_request
Laukiantis užklausa atsiranda administratoriaus sąsajoje ir administratoriaus API (/v1/admin/approvals), kur recenzentas mato įrankį, jo argumentus ir kontekstą, o tada patvirtina arba atsisako jo.
Patvirtinti reiškia vykdyti, atmesti reiškia nevykdyti
Vartai yra vienareikšmiai:
- Patvirtinti — įrankis vykdo tiksliai su tais argumentais, kurie buvo peržiūrėti.
- Atmesti — įrankis yra neįvykdyta. Nėra dalinių ar atidėtų vykdymas; atmestas skambutis paprasčiausiai nevyksta, ir eilė tęsiasi be to šalutinio poveikio.
[!NOTE] Atmetimas reiškia visišką sustojimą tam konkrečiam skambučiui. Agentas tyliai nesielgia pakartotinai atlikti atmestą veiksmą už peržiūrėtojo nugaros.
Kodėl tai yra saugu atkūrimo metu
Patvirtinimo vartai derinami su AiHummer idempotentiniai šalutiniai poveikiai. Eiga gali būti nutraukta (perkrauta, sutrikimas) ir tada atstatyta. Be apsaugos, atstatyta eiga gali vėl vykdyti jau įvykdytą veiksmą — išsiųsti tą patį el. laišką du kartus, vėl paskelbti tą pačią žinutę.
AiHummer tai užkerta su tęsti-stabilų knygos raktą ir a pokalbinė kliūtis: kiekvienas šalutinis poveikis įrašomas po stabiliu raktu, o barjeras atsisako vėl vykdyti efektą, kurį žurnalas rodo jau atliktu.
[!TIP] Praktinė nauda: patvirtinus atgautą posūkį daroma ne dviguba ugnis paštas arba kanalo siuntimas. Sienelė užtikrina, kad efektas įvyktų tik vieną kartą, ar posūkis buvo atstatytas, ar ne.
Matyti Daugiabūtiškumas ir nepakartojamumas dėl visos apskaitos knygos mechanikos ir šalutinio poveikio barjero.
Pasirenkant, kuriuos įrankius užblokuoti
Vartų įrankiai, kurių poveikis yra išorėje matomas arba sunkiai atšaukiamas. Geri kandidatai:
mail— išeinantis el. laiškas.- Kanalas-siuntimas / išeinantis pristatymas klientams arba darbuotojams.
http_requestir kiti įrankiai, galintys pakeisti išorines sistemas.code_execbendrinamuose serveriuose (ten taip pat pagal numatytuosius nustatymus išjungta).
Tik skaitymui skirti įrankiai (paieška, žinių tikrinimas, laikas) paprastai nereikalauja vartų. Derinkite patvirtinimo vartus su oro tarpinės režimas ir išvesties kontrolė įrankiams, kurie pasiekia viešąjį internetą.
Kur toliau
- Daugiabūtiškumas ir nepakartojamumas — apskaitos knyga ir šalutinio poveikio barjeras už tiksliai vieną kartą vykdomų efektų.
- Apsauginės tvorelės ir apsauga nuo signalų injekcijos — laikyti kad modelis nebūtų nukreiptas į uždaro įrankio pavadinimą kenkėjišku būdu.
- Tinklas, auditas ir atskirtas nuo tinklo — apriboti, ką įrankiai gali pasiekti.