Agent Çöktü — Şimdi Ne Olur?
Botonom'un beklenmeyen agent çökmelerini nasıl yönettiğini, 5 saniyelik otomatik toparlanma sürecini ve ilk kontrol etmeniz gerekenleri öğrenin.
Bu rehberde sırasıyla Agent çöktüğünde sistemde ne gerçekleşir?, Otomatik toparlanma aşamaları, İlk olarak kontrol etmeniz gereken adımlar, En sık karşılaşılan çökme nedenleri ve Sıkça Sorulan Sorular konularını ele alıyoruz.
Agent çöktüğünde sistemde ne gerçekleşir?
Bir agent öngörülemeyen bir çalışma zamanı hatasıyla karşılaştığında, Botonom'un otomatik izleme ve kurtarma (watchdog) servisi bu kesintiyi 5 saniye içinde tespit eder. Sistem durumu anında KURTARILIYOR (RECOVERING) olarak günceller ve otomatik yeniden başlatma dizisini devreye sokar.
Genellikle 10 ila 30 saniye süren bu toparlanma penceresinde, o an yürütülmekte olan tüm görevler ve gelen müşteri mesajları güvenle kuyruğa alınır. Agent tekrar ayağa kalktığında kaldığı yerden yürütmeye devam eder; hiçbir veri, müşteri mesajı veya konuşma bağlamı kaybolmaz.
Otomatik toparlanma aşamaları
Kurtarma hattı 4 adımdan oluşur ve saniyeler içinde tamamlanır:
- Teşhis (0-5s): Sağlık kontrolü başarısız olur, yanıt vermeyen süreç izole edilir ve bellek dökümü güvenli hata günlüğüne yazılır.
- Temiz Başlatma (5-15s): Agent'ın container çalışma ortamı, bellek hafızası ve ortam değişkenleri korunarak temiz bir izole alanda yeniden başlatılır.
- Bağlam Eşitleme (15-25s): En son doğrulanmış durum snapshot'ı ve konuşma geçmişi bellekten çalışma belleğine geri yüklenir.
- Kuyruk Boşaltma (25-30s): Kesinti süresince kuyrukta bekletilen tüm işler, webhook olayları ve kullanıcı mesajları kronolojik sırayla işleme alınır.
İlk olarak kontrol etmeniz gereken adımlar
Çoğu durumda sistem kesintiyi kendi kendine çözer. Ancak agent'ınız beklenenden uzun süredir çevrim dışıysa şu sırayla kontrol edebilirsiniz:
- Durum Rozeti: Agent kartındaki rozet 2 dakikadan uzun süredir
KURTARILIYORaşamasında takılı kaldıysa sayfayı sert yenileyin (Ctrl+Shift+R). - Harici Bağlantılar: Agent'ın bağlandığı üçüncü taraf servislerin (WhatsApp, Google Sheets, CRM vb.) token veya yetki sürelerinin dolup dolmadığını Ayarlar → Bağlantılar sekmesinden doğrulayın.
- Son Görev Yükü: Çökme öncesinde agent'a çok yüksek boyutlu (örn. 50 MB üzeri taranmış PDF veya devasa Excel tablosu) bir dosya yüklenip yüklenmediğini kontrol edin.
En sık karşılaşılan çökme nedenleri
| Neden | Açıklama | Çözüm |
|---|---|---|
| Bellek Sınırı (OOM) | Çok büyük belgelerin tek seferde bağlama yüklenmesi | Belgeleri parçalara bölerek veya özetleterek yükleyin |
| Üçüncü Taraf API Kesintisi | Entegre edilen harici servisin yanıt vermemesi | İlgili servisin durum sayfasını ve API anahtarını kontrol edin |
| Hatalı / Sonsuz Döngü | Çelişkili komutlar nedeniyle agent'ın kısır döngüye girmesi | Görevi iptal edip daha net ve yapılandırılmış talimatlar verin |
| Yetkilendirme Zaman Aşımı | OAuth bağlantısının süresinin dolması | Bağlantılar menüsünden "Yeniden Bağlan" ile izinleri tazeleyin |
Sıkça Sorulan Sorular
Soru: Çökme sırasında gelen WhatsApp müşteri mesajları kaybolur mu? Cevap: Kesinlikle hayır. Webhook kuyruk mekanizması gelen tüm iletileri sıraya alır ve agent yeniden aktifleştiği anda gecikmeksizin sırayla yanıtlar.
Soru: Yeniden başlatma faturama ek token maliyeti yansıtır mı? Cevap: Hayır. Kurtarma hattının ve watchdog ping'lerinin çalışması tamamen sistem altyapısına aittir; müşterinin paylaşımlı token havuzundan herhangi bir tüketim yapılmaz.