AiHummer
Azərbaycanca▾
Daxil olŞəxsi kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Təhlükəsizlik/Təsdiq qapıları

Təsdiq qapıları

v1.1.x · yeniləndi 2026-06-26

Bəzi alət çağırışları insanın razılığı olmadan baş verməməlidir — məktub göndərmək, kanala paylaşım etmək, real dünya nəticələri olan dəyişikliklər etmək. AiHummer-in təsdiq qapıları Belə alətlər işləmədən əvvəl bir şəxsi prosesə daxil edin və eyni hərəkətin iki dəfə baş verməməsi üçün bərpa olunmuş addımı təsdiqləməyi idempotent yan təsirlərlə cütləşdirin.

Səviyyə: Təsdiq qapıları ödənişli səviyyə nəzarətidir, pulsuz/platformaya aid deyil.

Xüsusiyyət Pillə
Təsdiq qapıları Korporativ səviyyəli (Biznes+/Korporativ)

Qapının necə işlədiyi

Hansı alətlərin təsdiq tələb etdiyini siz elan edirsiniz AIHUMMER_APPROVAL_TOOLS tənzimləmə — alət adlarının siyahısı. Agent həmin alətlərdən birini çağırmağa qərar verdikdə, icra dayandırılır və insanın nəzərdən keçirməsi üçün təsdiq tələb olunur.

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

Gözləyən sorğu admin UI və admin API-də görünür (/v1/admin/approvals), burada yoxlayıcı aləti, onun arqumentlərini və konteksti görür və sonra onu təsdiqləyir və ya rədd edir.

Təsdiqləmək qaçmaq deməkdir, rədd etmək qaçmamaq deməkdir

Darvaza aydın şəkildədir:

  • Təsdiqlə — alət nəzərdən keçirilmiş dəqiq arqumentlərlə icra olunur.
  • Rədd et — alətdir icra edilməmiş. Hissə-hissə və ya təxirə salınmış yoxdur icra; rədd edilmiş zəng sadəcə baş vermir və növbə davam edir o yan təsir olmadan.

[!NOTE] Rədd etmək həmin xüsusi zəng üçün sərt dayandırmadır. Agent səssizcə etməz rədd edilmiş hərəkəti nəzərdən keçirənin arxasınca yenidən cəhd et.

Bərpa altında bunun niyə təhlükəsiz olması

Təsdiq qapıları AiHummer-inlə cütləşdirilir idempotent yan təsirlər. Bir dönüş ara verilə bilər (yenidən başlama, qəza) və sonra bərpa oluna bilər. Qorunma olmadan, bərpa edilmiş dönüş artıq baş vermiş bir hərəkəti yenidən icra edə bilər — eyni e-poçtu iki dəfə göndərmək, eyni mesajı yenidən yerləşdirmək.

AiHummer bunu bir vasitə ilə qarşısını alır təkrar başlat-stabilləşdirilmiş dəftər açarı və bir yan təsir baryeri: hər bir yan təsir sabit bir açar altında qeyd olunur və bariyer, qeyd dəftərində artıq yerinə yetirildiyi göstərilən təsiri yenidən işlətməkdən imtina edir.

[!TIP] Praktiki nəticə: bərpa olunmuş növbəni təsdiqləmək edir yox ikiqat-od poçt və ya kanal-göndər. Maneə təsirin tam olaraq bir dəfə baş verməsini təmin edir, dönüşün bərpa olunub-olunmaması.

Görmək Çoxtenantlilik və idempotentlik dəftərin tam mexanikası və yan təsir baryeri üçün.

Hansı alətləri məhdudlaşdırmağı seçmək

Təsirləri xaricdən görünən və ya geri alınması çətin olan qapı alətləri. Yaxşı namizədlər:

  • mail — çıxan e-poçt.
  • Müştərilərə və ya heyətə kanal vasitəsilə göndərmə / çıxış çatdırılması.
  • http_request və xarici sistemləri dəyişdirə bilən digər alətlər.
  • code_exec paylaşılan hostlarda (orada da standart olaraq söndürülüb).

Yalnız oxuma vasitələri (axtarış, bilik axtarışı, vaxt) ümumiyyətlə qapıya ehtiyac duymur. Təsdiq qapılarını ilə birləşdirin hava boşluğu rejimi və çıxış nəzarətləri ümumi internetə çıxan alətlər üçün.

Növbəti haradır