Doğrulanabilir adımlara bölmek

Teori: plan iki iş yapar#

Bir ajan planı aynı anda iki işe yarar: modelin sonraki kararını daraltır ve dışarıdan izlenebilir bir durum üretir. İkincisi genellikle atlanır. Planın açıkça temsil edilmediği bir döngüde işin neresinde olduğunuzu ancak izleri geriye doğru okuyarak anlarsınız; bu da hata ayıklamayı arkeolojiye çevirir.

Örtük plan ile açık plan arasındaki fark buradadır. Örtük planda adımlar modelin muhakemesinin içinde kalır. Açık planda adımın durumu — bekliyor, yürüyor, bitti, başarısız — kodda tutulur ve yeniden denemenin, kısmi bitirmenin, yarıda kalan işi devam ettirmenin dayanağı olur.

Ayrıştırma derinliği de bir ödünleşim. Fazla ince plan her adım için ayrı tur harcatır ve bağlamı doldurur. Fazla kaba plan adımın bitip bitmediğini belirsiz bırakır. Pratik ölçüt: bir adım tek bir araç çağrısı ya da birkaç çağrılık kapalı bir alt iş olmalı ve sonunda "oldu/olmadı" diye bakılabilecek bir gözlem bırakmalı.

Uygulamada: adım doğrulanabilir mi?#

Plan temsili#

{
  "hedef": "SIP-2026-0412 için gecikme talebini kapat",
  "adimlar": [
    { "no": 1, "ad": "siparis_durumu_sorgula",
      "bitis_kosulu": "durum alanı dolu", "durum": "bitti" },
    { "no": 2, "ad": "gecikme_nedeni_sinifla", "girdi": "adim:1.durum",
      "bitis_kosulu": "kategori, tanımlı kümeden bir değer", "durum": "yuruyor" },
    { "no": 3, "ad": "musteri_bilgi_taslagi_uret",
      "bitis_kosulu": "taslak metin üretildi", "durum": "bekliyor", "onay": true },
    { "no": 4, "ad": "talebi_kapat",
      "bitis_kosulu": "kayıt durumu kapandı", "durum": "bekliyor", "geri_alinamaz": true }
  ],
  "kabul_olcutu": "talep kapandı ve müşteriye bilgi mesajı gitti",
  "butce": { "tur_siniri": 8, "cagri_siniri": 12 }
}

Bu temsilde dört alan işi taşıyor. `bitis_kosulu` adımın doğrulanabilirliğini zorunlu kılar — yazamıyorsanız adım fazla kabadır. `girdi` adımlar arası bağımlılığı görünür yapar; bağımlılığı olmayan adımlar aynı turda yürütülebilir. `onay` ve `geri_alinamaz` yetki kapılarının planın üzerinde durmasını sağlar. `kabul_olcutu` ise hedef düzeyinde bir kontrol bırakır: adımların hepsi bitti diye hedef gerçekleşmiş olmaz.

Karar: baştan plan mı, tur başına mı?#

1. 1Hedef ilk turda yeterince anlaşılıyor mu?

   Girdide gereken bilgi varsa baştan bir plan çıkarmak izlenebilirlik ve bütçe öngörüsü kazandırır.

2. 2Sonraki adım önceki gözleme mi bağlı?

   Adımın ne olacağı ancak bir önceki sonuç görüldükten sonra belirleniyorsa baştan tam plan üretmek yanıltıcıdır: iskelet plan artı tur başına gözden geçirme daha uygundur.

3. 3Paralellik kazancı var mı?

   Birbirinden bağımsız adımlar varsa açık plan bunları görünür yapar ve aynı turda yürütülmelerini mümkün kılar.

4. 4İş yarıda kalabilir mi?

   Uzun süren, onay bekleyen veya insan devri olabilen işlerde açık plan zorunludur; devam etmenin tek dayanağı adım durumlarıdır.

Sık yapılan hata#

İki hata birlikte görülür. Birincisi planı modelden serbest metin olarak isteyip kodda ayrıştırmaya çalışmak: ortaya kırılgan bir metin ayrıştırma katmanı çıkar ve biçim her değiştiğinde plan kaybolur. İkincisi planı bir kez üretip sonuna kadar sorgusuz yürütmek: ilk yanlış gözlemden sonra kalan bütün adımlar anlamsız yürür. Plan yapılandırılmış üretilmeli ve her adımın bitiş koşulu yürütmeden sonra kontrol edilmeli.