> tpl_air_041
Ajan Hata, Yedekleme ve Kurtarma Planı
Ajan hata sınıflandırmasını, sonsuz döngü tespitini, bağlam penceresi taşma kurtarmasını, model bozulması durumunda alternatif model yönlendirmelerini ve insan denetimli dead-letter queue (DLQ) yeniden oynatma hatlarını kurallara bağlayan operasyonel dayanıklılık planı ve kurtarma rehberi.
Ajan hata taksonomisini, döngü tespitini, devre kesicileri ve dead-letter queue kurtarma hatlarını kurallara bağlayan dayanıklılık planı.
Önemli Teknik Doküman Şablonu ve Hukuki Uyarı
TinyCTO.tv Teknik Doküman Şablon Bildirimi: Bu şablon genel eğitim ve operasyon amaçlı bir başlangıç materyalidir. Hukuki, vergisel, muhasebesel, yatırım, satın alma, mevzuat, güvenlik veya sertifikasyon danışmanlığı değildir. Gereklilikler ülkeye, kuruma, sözleşmeye ve riske göre değişir. Kullanmadan önce yetkin uzmanlarla gözden geçirip uyarlayın.
Çözülen Üretim Problemi
Otonom ajanlar sonsuz özyinelemeli araç çağırma döngülerine girer, API kota aşımlarında çöker veya birincil model bozulduğunda sessizce halüsinasyon üreterek sistemi felce uğratır; otomatik kurtarma mekanizması yoktur.
Ne Zaman Kullanılmalı?
- •Görev kritik müşteri odaklı otonom ajanlar için üretim SRE dayanıklılık standartları kurarken
- •Birincil LLM uç noktalarında gecikme veya 5xx kesintisi yaşandığında çoklu sağlayıcı yedek yönlendirmesi yapılandırırken
- •Başarısız olan ajan görevlerinin insan operatörlerce incelenmesi için Dead Letter Queue (DLQ) hatları kurarken
Ne Zaman Kullanılmamalı?
- •Fiziksel veri merkezi ve bulut felaket kurtarma planlaması için (TPL-OPS-004 kullanın)
- •Yazılım hata ayıklama ve sprint iş listesi yönetimi için (TPL-QAV-010 kullanın)
5 Şablon Bölümü ve Yapısal İskelet
Hata sınıflandırması: 1. Seviye (Sonsuz özyinelemeli döngüler / kilitlenme), 2. Seviye (Model sağlayıcı 5xx kesintisi / kota aşımı), 3. Seviye (Bağlam penceresi taşması / geçersiz JSON), 4. Seviye (Anlamsal halüsinasyon / ret).
Deterministik döngü tuzakları: Birbirinin aynı araç çağrılarının, mükerrer parametrelerin ve adım sınırlarının izlenmesi. 3 ardışık özdeş eylemde devre kesicinin tetiklenmesi.
Dinamik yönlendirme kademeleri: Birincil Model (Claude 3.5 Sonnet) kesintiye uğrar veya gecikmesi 5.000 ms'yi aşarsa, sistemin otomatik olarak İkincil Modele (GPT-4o) geçmesi.
Kurtarılamayan ajan görevlerinin kalıcı bir DLQ kuyruğuna (SQS/Kafka) yönlendirilmesi. Destek mühendislerinin durumu inceleyip düzelterek görevi kaldığı adımdan yeniden başlatabilmesi.
Üretimde yaşanan ajan arızalarını otomatik CI/CD değerlendirme testlerine dönüştürme. Ajan güncellemelerini yayına almadan önce geçmiş kaza senaryolarıyla simüle etme.
Doldurma ve Uygulama Yönergeleri
Bağımsız İnceleme ve Onay Kontrol Listesi
- Tüm zorunlu bölümler dolduruldu
- Gizli anahtar veya parola içermiyor
- Yönetici sponsor onayı alındı
Ajan Hata, Yedekleme ve Kurtarma Planı - Örnek Vaka Analizi
Örnek Organizasyon: Otonom Finansal Mutabakat Ajan Sistemi (Günde 50.000 Karmaşık Çok Adımlı İşlem Yürüten)
Otonom Finansal Mutabakat Ajan Sistemi (Günde 50.000 Karmaşık Çok Adımlı İşlem Yürüten) için eksiksiz operasyonel uygulamayı gösteren gerçek dünya vaka analizi.
- •Otomatik çoklu sağlayıcı yedekleme kademeleriyle kritik ajan çalışma çökmelerini %91 oranında azalttı
- •Temporal dayanıklı yürütme kayıtları ve DLQ yeniden oynatma ile başarısız olan yüksek tutarlı faturaların %100'ünü kurtardı
- •Katı 3 adımlı devre kesici kuralları ile 420'den fazla potansiyel sonsuz döngü kilitlenmesini engelledi
Sıkça Sorulan Sorular
Döngü tespit devre kesicisi (circuit breaker) bir ajanın kısır döngüye girdiğini nasıl anlar?
Çalışma zamanı motoru her araç çağrısının adını ve parametrelerini kriptografik olarak özetler. Eğer aynı özet dizisi ardışık 3 kez tekrarlanırsa veya ajan durumu ilerletmeden 10 adım harcarsa sigorta atar; görev durdurulur ve 1. Seviye alarm üretilir.
Dayanıklı yürütme (durable execution - Temporal) otonom ajan kurtarmada neden hayati öneme sahiptir?
Dayanıklı yürütme olmadan, 10 adımlı bir işin 8. adımında çöken bir ajan tüm işi baştan çalıştırmak zorunda kalır; bu da devasa token maliyetine ve mükerrer harici işlem riskine yol açar. Dayanıklı altyapı adımları kaydeder ve kurtarma anında ajanı tam 8. adımdan devam ettirir.
Yedek modele geçildiğinde ikincil model farklı bir araç şeması bekliyorsa ne yapılmalıdır?
Ağ geçidi (gateway) katmanı iki yönlü şema dönüştürme adaptörleri bulundurmalıdır. Anthropic araç sözdiziminden OpenAI fonksiyon sözdizimine geçildiğinde, ağ geçidi parametreleri ve sistem talimatlarını ikincil modele uygun formata otomatik olarak çevirir.
Teknik Doküman Şablon Paketi
Giriş GerekliTüm boş şablonları, işlenmiş senaryoları ve doğrulama manifestolarını tek bir arşivde indirin.
Yetkili Standartlar ve Kaynaklar
- Temporal.io: Durable Execution Architecture for AI AgentsTemporal Technologies • OFFICIAL REQUIREMENT
- OpenTelemetry Semantic Conventions for Generative AI OperationsOpenTelemetry • OFFICIAL REQUIREMENT
- Martin Fowler: Circuit Breaker Software Architectural PatternMartin Fowler • OFFICIAL REQUIREMENT