AiHummer
Latviešu
PierakstītiesKonts
v1.2.x
{ }Swagger

Apstiprināšanas vārti

v1.2.x · atjaunināts 2026-06-26

Dažas rīku izsaukumus nevajadzētu veikt bez cilvēka piekrišanas — sūtīt e-pastus, publicēt kanālā, veikt izmaiņas ar reālās pasaules sekām. AiHummer’s apstiprināšanas vārti ielieciet personu cilpā pirms šādiem rīkiem darbojas, un savienojiet ar idempotentiem blakus efektiem, lai apstiprinātais atjaunotais solis nekad neatkārtotu to pašu darbību divreiz.

Līmenis: apstiprinājuma vārti ir maksas līmeņa kontrole, nevis bezmaksas/visaptveroša platforma.

Funkcija Līmenis
Apstiprināšanas vārti Uzņēmuma līmeņa (Business+/Enterprise)

Kā vārti darbojas

Jūs norādāt, kuri rīki prasa apstiprinājumu ar AIHUMMER_APPROVAL_TOOLS iestatījums — rīku nosaukumu saraksts. Kad aģents izlemj izmantot kādu no šiem rīkiem, izpilde apturēta un tiek izveidots apstiprinājuma pieprasījums, lai cilvēks to pārskatītu.

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

Gaidošais pieprasījums parādās administrēšanas lietotāja saskarnē un administrēšanas API (/v1/admin/approvals), kur recenzents redz rīku, tā argumentus un kontekstu, un pēc tam to apstiprina vai noraida.

Apstiprināt nozīmē palaist, noraidīt nozīmē nepalaist

Vārti ir viennozīmīgi:

  • Apstiprināt — rīks tiek izpildīts ar tieši tiem argumentiem, kas tika pārskatīti.
  • Noraidīt — instruments ir nav izpildīts. Nav daļējas vai atliktas izpilde; noraidīts zvans vienkārši nenotiek, un gājiens turpinās bez šīs blakusparādības.

[!NOTE] Noraidījums ir stingrs apstādinājums konkrētajam zvanam. Aģents klusējot ne atkārtoti mēģināt noraidīto darbību aiz recenzenta muguras.

Kāpēc tas ir droši atkopšanas laikā

Apstiprināšanas vārti sader ar AiHummer idempotentās blakusparādības. Gājums var tikt pārtraukts (restartēts, notikt avārija) un pēc tam atjaunots. Bez aizsardzības atjaunots gājums varētu atkārtoti izpildīt darbību, kas jau notikusi — nosūtīt to pašu e-pastu divreiz, publicēt to pašu ziņu vēlreiz.

AiHummer to novērš ar atsākt stabilās virsgrāmatas atslēgu un a blakusparādību barjera: katra blakusparādība tiek ierakstīta zem stabilas atslēgas, un barjera atsakās atkārtoti izpildīt efektu, ko žurnāls rāda kā jau izpildītu.

[!TIP] Praktiskā izdevība: apstiprinot atgūto gājienu, tas dara ne dubults uguns pasts vai kanāla sūtīšana. Barjera nodrošina, ka efekts notiek tieši vienu reizi, vai pagrieziens tika atgūts vai nē.

Redzēt Daudzīrīšu vide un idempotence pilnīgajai virsgrāmatas mehānikai un blakusefektu barjerai.

Izvēloties, kuri rīki tiks ierobežoti

Vārtu rīki, kuru efekti ir redzami ārēji vai grūti atsaucami. Labi kandidāti:

  • mail — ienākošais e-pasts.
  • Kanāla nosūtīšana / izejošā piegāde klientiem vai darbiniekiem.
  • http_request un citas rīki, kas var mainīt ārējās sistēmas.
  • code_exec koplietotos resursos (tur arī pēc noklusējuma izslēgts).

Rāda tikai lasāmos rīkus (meklēšana, zināšanu meklēšana, laiks) parasti nav nepieciešami vārti. Apvienojiet apstiprināšanas vārtus ar gaisa atdalītā režīms un izejas kontroles instrumentiem, kas sasniedz publisko internetu.

Kur uz nākamo