AiHummer
Lietuvių
PrisijungtiPaskyra
v1.0.x
{ }Swagger

Patvirtinimo vartai

v1.0.x · atnaujinta 2026-06-26

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_request ir kiti įrankiai, galintys pakeisti išorines sistemas.
  • code_exec bendrinamuose 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