Hata kurtarma ve yeniden planlama
Ajan hatalarını sınıflara ayırmayı, her sınıfı doğru katmana yönlendirmeyi ve yeniden planlama ile insana devir arasında seçim yapmayı öğretir.
Önkoşul: AI Agent, Function Calling
BU DERSİN SONUNDA
- Hata sınıflarını işaretlerinden ayırt etmek
- Her hata sınıfını doğru katmana — kod, model veya plan — yönlendirmek
- Yeniden planlamayı adımın bitiş koşulu kontrolüne bağlamak
- Devir paketini yan etki dökümüyle birlikte hazırlamak
- 1
Teori
Kavramın çalışma mantığı
- 2
Örnek
Gerçek bir senaryo üzerinde gösterim
- 3
Lab
Uygulamalı alıştırma
- 4
Test
Kısa ölçüm
- 5
Proje
Rotadaki projeye katkı
Kısa cevap
Ajanda kurtarma, hatayı tekrar denemek değil sınıflandırmaktır. Aynı çağrının tekrarı geçici hatalarda işe yarar, kalıcı hatalarda döngüyü boşa çevirir. Kurtarma tasarımı üç soruya cevap verir: bu çağrı tekrarlanabilir mi, plan mı yanlış, yoksa iş insana mı devredilmeli.
Teori: her hata sınıfı başka davranış ister#
Bir araç çağrısı başarısız olduğunda ortaya çıkan hata metni tek başına yeterli değildir; belirleyici olan hangi sınıfa girdiği. Geçici hatada sistem durumu değişmemiştir, aynı çağrı sonradan başarılı olabilir. Kalıcı hatada çağrının kendisi yanlıştır; argüman veya araç seçimi düzelmeden tekrar denemek aynı sonucu verir. Anlamsal hatada çağrı başarılıdır ama sonuç hedefe hizmet etmez — en zor sınıf, çünkü ortada bir hata sinyali yoktur.
Bu sınıflar farklı katmanlarda ele alınır. Geçici hata koda aittir: sınırlı sayıda tekrar, artan bekleme, yazma çağrısında idempotanlık anahtarı. Kalıcı ama düzeltilebilir hata modele aittir: düzeltme yolunu gösteren bir mesaj geri gider. Anlamsal hata plana aittir: adımın bitiş koşulu kontrol edildiğinde yakalanır ve yeniden planlamayı tetikler.
Bir ajanın dayanıklılığı büyük ölçüde bu ayrımın netliğiyle ölçülür. Her hatayı modele geri veren sistem, ağ kesintisinde de plan hatasında da aynı şeyi yapar: modelden çare bekler. Her hatayı kodda tekrar deneyen sistem ise düzeltilebilir bir argüman hatasında ısrarla aynı çağrıyı yollar. İkisi de bütçeyi hiçbir şey üretmeden tüketir.
Uygulamada: sınıf, işaret, davranış#
| Hata sınıfı | Tipik işaret | Kim ele alır | Davranış |
|---|---|---|---|
| Geçici | Zaman aşımı, hız sınırı, geçici sunucu hatası | Kod | Artan beklemeyle sınırlı tekrar; yazmada idempotanlık anahtarı |
| Kalıcı, düzeltilebilir | Biçim hatası, bilinmeyen kimlik, kümede olmayan değer | Model | Düzeltme yönlendirmesi içeren mesajla aynı döngüde yeniden deneme |
| Kalıcı, düzeltilemez | Yetki reddi, kapatılmış kayıt, silinmiş belge | Kod | Döngüyü kes, devir paketini hazırla, insana ver |
| Anlamsal | Çağrı başarılı ama adımın bitiş koşulu sağlanmadı | Plan | Adımı başarısız işaretle ve planı o noktadan revize et |
| Sonuç bilinmiyor | Yazma çağrısında zaman aşımı veya kopan bağlantı | Kod | Tekrar denemeden önce durumu okuyarak doğrula |
Yeniden planlama ne zaman tetiklenir?#
- 1Adımın bitiş koşulu sağlandı mı?
Sağlanmadıysa adım başarısızdır; aracın hata döndürmemiş olması bunu değiştirmez. Kontrol yürütmeden sonra kodda yapılır.
- 2Başarısızlık tek adıma mı ait?
Yalnızca o adımın argümanı yanlışsa adımı düzeltip devam edin; plana dokunmak gereksiz tur harcar.
- 3Adımın dayandığı varsayım çürüdü mü?
Varsayım yanlışsa — kayıt yok, kanal kapalı, süreç değişmiş — sonraki adımlar da geçersizdir. Planı o noktadan itibaren yeniden kurun.
- 4Bütçe kaldı mı?
Tur, çağrı veya süre bütçesi tükeniyorsa yeniden planlamak yerine devir yapın. Kalan bütçeyi yeni bir denemeye harcamak, işi hem yarım hem izsiz bırakır.
Devir: insana ne verilir?#
- Hedefin özeti ve ajanın nerede durduğu: hangi adımlar bitti, hangi adım başarısız oldu.
- Başarısızlığın sınıfı ve ham hata metni; yorum değil, olduğu gibi.
- Yapılmış yan etkilerin listesi: hangi kayıtlar değişti, hangi mesajlar gitti. Yarım kalan iş en çok burada hasar verir.
- Devam için gereken tek karar: insandan beklenen şey açık bir soru olmalı, "bir bakabilir misiniz" değil.
Sık yapılan hata#
En pahalı hata sınıflandırmasız tekrar denemedir: hata metni modele gider, model aynı çağrıyı biraz farklı argümanla yollar, araç aynı hatayı döndürür ve bu tur sınırına kadar sürer. Dışarıdan bakan "ajan denemeye devam ediyor" görür; gerçekte bütçe harcanmış ve sonunda kullanıcıya ne olduğu anlatılamıyordur. İkinci hata, yan etkilerin izini tutmadan yeniden planlamak: revize edilen plan, ilk denemede gönderilmiş mesajı bir kez daha gönderir.
LAB · UYGULAMALI ALIŞTIRMA
Hata sınıflandırıcısını kurun
- 1Ajanınızın geçmiş koşumlarından başarısız 10 turu iz kaydından toplayın; iz kaydınız yoksa geliştirme ortamında araçları kasıtlı hataya düşürerek (yanlış kimlik, kapalı kayıt, zaman aşımı taklidi) aynı sayıda tur üretin.
- 2Her turu beş sınıftan birine yerleştirin: geçici, kalıcı-düzeltilebilir, kalıcı-düzeltilemez, anlamsal, sonuç bilinmiyor.
- 3Sınıflandırmayı kodda tek bir eşleme fonksiyonuna dönüştürün: araç hatası girdi, davranış çıktı (tekrar, modele dön, kes, yeniden planla, durumu doğrula).
- 4Anlamsal sınıfa giren turların adımları için bitiş koşulunu yazın ve bu koşulu yürütmeden sonra kontrol eden kontrolü ekleyin.
- 5Aynı 10 turu sınıflandırıcıyla yeniden oynatın; kaçının artık gereksiz tekrar üretmediğini ve kaçının devre yönlendiğini sayın.
Beklenen çıktı
On başarısız turun sınıf dökümü, sınıf ve davranışı eşleyen fonksiyon ve yeniden oynatmada gereksiz tekrar sayısının önce/sonra karşılaştırması.
Sık sorulan sorular
Kaç kez tekrar denemek doğru?
Sabit bir doğru sayı yok; ölçüt hata sınıfı. Geçici hatalarda küçük bir üst sınır ve artan bekleme yeterlidir, kalıcı hatalarda doğru sayı sıfırdır. Tekrar sayısını sınıftan bağımsız tek bir ayara bağlamak, sınıflardan birini mutlaka yanlış ele alır.
Anlamsal hatayı model kendi fark edebilir mi?
Bazen eder, ama buna dayanmak riskli: kendi çıktısını değerlendirmesi güvenilir bir sinyal değil ve ortada hata sinyali yokken fark etmeyi tetikleyecek bir şey de yok. Güvenilir tetik, adımın bitiş koşulunun kodda kontrol edilmesidir.
Kurtarma mantığı ajanı yavaşlatmaz mı?
Bekleme ve durum doğrulama adımları gecikme ekler. Karşılığı, yarım kalan işin ve tekrarlanmış yan etkinin bedeli; yazma yapan araçlarda bu bedel gecikmeden hızla büyür. Yalnızca okuma yapan akışlarda daha gevşek bir kurtarma kabul edilebilir.
LEARN
AI Agent Developer rotasına devam et
Dersler tek başına da okunabilir, ama sıralı ilerlemek önkoşul boşluklarını kapatır.