Onay geçitleri
Bazı araç çağrıları, bir insanın ‘evet’ demesi olmadan gerçekleşmemelidir — mail göndermek, bir kanala mesaj göndermek, gerçek dünya sonuçları olan değişiklikler yapmak. AiHummer’ın onay geçitleri Böyle araçlar çalışmadan önce bir kişiyi sürece dahil edin ve iyileştirilmiş bir adımı onaylamak aynı eylemi iki kez tetiklememesi için idempotent yan etkilerle eşleştirin.
Seviye: onay kapıları ücretli bir katman kontrolüdür, ücretsiz/platform geneli değildir.
| Özellik | Katman |
|---|---|
| Onay geçitleri | Kurumsal düzey (İş+/Kurumsal) |
Kapının nasıl çalıştığı
Hangi araçların onay gerektirdiğini ile bildirirsiniz AIHUMMER_APPROVAL_TOOLS ayar — araç isimlerinden oluşan bir liste. Ajan bu araçlardan birini çağırmaya karar verdiğinde, yürütme duraklar ve bir insanın incelemesi için onay talebi oluşturulur.
# /home/.aihummer/etc/gateway.env
# Comma-separated list of tools that require approval before execution
AIHUMMER_APPROVAL_TOOLS=mail,http_requestBekleyen istek, yönetici kullanıcı arayüzü ve yönetici API’sinde görünür (/v1/admin/approvals), burada bir inceleyici aracı, argümanlarını ve bağlamını görür ve ardından onaylar veya reddeder.
Onaylamak çalışmak anlamına gelir, reddetmek çalışmamak anlamına gelir
Kapı açık seçiktir:
- Onayla — araç, gözden geçirilen tam argümanlarla çalışır.
- Reddet — araçtır uygulanmadı. Kısmi veya ertelenmiş yok yürütme; reddedilmiş bir çağrı basitçe gerçekleşmez ve sıra devam eder o yan etki olmadan.
[!NOTE] Reddetme, belirli bir arama için sert bir duraktır. Temsilci sessizce yapmaz reddedilen işlemi gözden geçirenin haberi olmadan tekrar dene.
Neden bu kurtarma altında güvenlidir
Onay geçişleri AiHummer’ınki ile eşleşir idempotent yan etkiler. Bir tur kesintiye uğrayabilir (yeniden başlatma, çökme) ve ardından kurtarılabilir. Koruma olmadan, kurtarılan bir tur daha önce gerçekleşmiş bir eylemi yeniden başlatabilir — aynı e-postayı iki kez göndermek, aynı mesajı tekrar paylaşmak.
AiHummer bunu bir ile önler devam et-stabil defter anahtarı ve bir yan etki bariyeri: her yan etki sabit bir anahtar altında kaydedilir ve bariyer, defterin zaten yapılmış olarak gösterdiği bir etkiyi yeniden çalıştırmayı reddeder.
[!TIP] Pratik kazanç: kurtarılmış bir dönüşü onaylamak yapar değil çift ateş posta veya kanal-gönder. Bariyer, etkinliğin tam olarak bir kez gerçekleşmesini sağlar, dönüşün kurtarılıp kurtarılmadığı.
Gör Çok kiracılılık ve değiştirilemezlik defterin tüm mekanikleri ve yan etki engeli için.
Hangi araçların kapatılacağını seçmek
Etkileri dışarıdan görülebilen veya geri alınması zor olan kapı araçları. İyi adaylar:
mail— giden e-posta.- Kanal üzerinden gönderim / müşterilere veya personele giden teslimat.
http_requestve dış sistemleri değiştirebilen diğer araçlar.code_execpaylaşılan sunucularda (orada da varsayılan olarak kapalı).
Salt okunur araçlar (arama, bilgi sorgulama, zaman) genellikle bir kapıya ihtiyaç duymaz. Onay kapılarını ile birleştirin hava boşluklu mod ve çıkış kontrolleri genel internete ulaşan araçlar için.
Sonra nereye?
- Çok kiracılılık ve değiştirilemezlik — tam olarak bir kez gerçekleşen etkilerin arkasındaki defter ve yan etki engeli.
- Koruma çitleri ve istem enjeksiyonu savunması — saklamak modelin kapalı bir aracı kötü niyetle çağırmaya yönlendirilmesini önlemek.
- Ağ, denetim ve hava boşluklu — hangi araçların ulaşabileceğini sınırlamak.