Ajan döngüsü, araç sözleşmeleri ve hata kurtarma

Teori: döngü ve durma ölçütü#

Döngünün kendisi basittir: model durumu okur, bir araç çağırır, sonucu bağlamına ekler, yeniden karar verir. Bunu bir sisteme dönüştüren şey durma ölçütüdür. Görev bitti kararını tümüyle modele bırakırsanız iki uçta da hata görürsünüz: erken bırakma ve bitmeyen döngü. Bu yüzden her koşuda açık bir adım bütçesi, bir ilerleme ölçütü ve bütçe dolduğunda ne yapılacağı önceden tanımlı olmalıdır.

İlerleme ölçütü, döngünün gerçekten bir şey başardığını gösteren gözlemlenebilir bir değişimdir: yeni bir bilgi geldi, bir alan doldu, bir doğrulama geçti. Aynı aracın aynı argümanlarla yeniden çağrılması ilerleme değildir; bu kalıp görüldüğünde döngüyü kırmak, modeli daha fazla denemeye bırakmaktan iyidir. Bağlam da sınırlı bir kaynaktır: her adımın tam çıktısını biriktiren bir döngü uzun görevlerde kendi geçmişinde boğulur. Araç çıktılarını özetleyerek ya da kimlikle referanslayarak taşımak, döngünün ömrünü belirleyen karardır.

Araç sözleşmesi#

Model bir aracı adını ve açıklamasını okuyarak seçer; yani araç açıklaması istemin en kritik parçalarından biridir. İyi bir sözleşme tek bir iş yapar, parametreleri daraltılmış bir şemayla tanımlar, ne zaman kullanılmayacağını da söyler ve hata durumunda modele ne yapması gerektiğini anlatan yapılandırılmış bir cevap döner. Yan etkili araçlar ayrıca idempotans anahtarı almalıdır: aynı çağrının iki kez gitmesi iki kayıt oluşturmamalıdır.

{
  "ad": "izin_bakiyesi_getir",
  "aciklama": "Bir çalışanın güncel yıllık izin bakiyesini döner. Yalnızca bakiye sorularında kullanılır; izin talebi oluşturmak için kullanılmaz.",
  "parametreler": {
    "tip": "nesne",
    "alanlar": {
      "calisan_kimligi": { "tip": "metin", "desen": "^[0-9]{6}$" },
      "tarih": { "tip": "metin", "bicim": "tarih" }
    },
    "zorunlu": ["calisan_kimligi"]
  },
  "hata_cevaplari": [
    {
      "kod": "YETKI_YOK",
      "mesaj": "Bu çalışanın bakiyesini görme yetkisi yok.",
      "sonraki_adim": "Bu çağrıyı yeniden deneme; kullanıcıya yetki gerektiğini bildir."
    },
    {
      "kod": "GECERSIZ_KIMLIK",
      "mesaj": "Çalışan kimliği altı hane olmalı.",
      "sonraki_adim": "Kimliği kullanıcıdan doğrula, sonra tek kez yeniden çağır."
    }
  ],
  "yan_etki": "yok"
}

Uygulamada: araç tasarım ölçütleri#

Hata kurtarma#

1. 1Hatayı sınıflandır

   Geçici (zaman aşımı, oran sınırı), kalıcı (yetki, bulunamadı) ve girdi hatası (geçersiz parametre) ayrı ele alınır.

2. 2Yapılandırılmış geri bildirim ver

   Modele yığın izi değil; hata kodu, kısa açıklama ve önerilen sonraki adım gider. Model okuduğu şeye göre davranır.

3. 3Yeniden denemeyi sınırla

   Yalnızca geçici hatalarda, artan beklemeyle ve sayı sınırıyla; girdi hatasında yeniden deneme değil parametre düzeltmesi beklenir.

4. 4İlerleme yoksa döngüyü kır

   Aynı çağrı yineleniyorsa ya da adım bütçesi dolduysa koşuyu durdurup elde edileni ve eksik kalanı raporla.

5. 5Devret

   Kalıcı hatada karar insana geçer: ne denendi, nerede durdu, hangi yetki ya da bilgi eksik?

Yan etki ve güvenilmez girdi#

Ajanın gücü yan etki üretebilmesinden gelir, riski de oradan. İlk savunma araçları okuyan ve yazan olarak ayırmak, yazan her aracı onay kapısına ya da geri alınabilir bir işleme bağlamaktır. İkincisi girdi güvenidir: araçtan dönen metin — bir belge, bir web sayfası, bir destek kaydı — kullanıcı talimatı değil veridir. İçinde önceki yönergeleri yok say ya da şu aracı çağır gibi ifadeler geçebilir; döngü bunları yürütülecek komut olarak değil incelenecek içerik olarak taşımalıdır. Pratikte bu, talimat ile veriyi bağlamda ayrı ve etiketli tutmak ve araç çağrı yetkisini modelin okuduğu metne göre değil sabit bir politikaya göre vermek demektir.

Sık yapılan hata#

• Durma ölçütünü tümüyle modele bırakmak: adım bütçesi ve ilerleme ölçütü olmayan döngü ya erken biter ya hiç bitmez.
• Hata mesajı olarak yığın izi döndürmek: model okuduğunu anlamaz ve aynı çağrıyı yineler.
• Çok işi tek araca yığmak: model yanlış parametreyle çağırır, hatanın nedeni de görünmez olur.
• Araç çıktısını talimat gibi bağlama yapıştırmak: enjekte edilmiş bir yönerge döngünün kontrolünü alabilir.
• Ajanı yalnızca son çıktısıyla değerlendirmek: adım sayısı, çağrı dizisi ve yan etki denetimi olmadan iyileşme ölçülemez.