İşlev çağırma çevriminin mekaniği

Teori: model yürütmez, önerir#

Model bir araç çağrısı ürettiğinde ortaya çıkan şey bir ad ve bir argüman nesnesidir; hiçbir yan etkisi yoktur. Yan etki, kodun o öneriyi yürütmeye karar vermesiyle oluşur. Pratikte en çok atlanan nokta burası: öneriyi doğrudan yürüten bir uygulama, modelin ürettiği her argümanı doğrulanmış veri kabul etmiş olur.

Şema modele bir niyet bildirir. `required`, `enum`, `pattern` gibi kısıtlar doğru argüman üretme olasılığını artırır; çözümleme şemayla kısıtlansa bile elde edilen şey yalnızca biçimsel uygunluktur — değerin iş kuralına, oturumun yetkisine ve o anki sistem durumuna uyduğunu söylemez. Var olmayan bir kayıt kimliği de şemaya uyar. Bu yüzden doğrulama iki yerde yapılır: şemada modele rehberlik için, yürütmeden hemen önce kodda güvence için.

Argüman, kullanıcı girdisiyle aynı güven seviyesindedir. Model bağlamında güvenilmeyen metin varsa — getirilmiş bir belge, gelen bir e-posta, bir web sayfası — ürettiği argüman o metinden etkilenmiş olabilir. Bu yüzden yetki kontrolü argümanın içeriğine değil, oturumun kimliğine bağlanır.

Uygulamada: doğrulama katmanının işleri#

Gözlemi biçimlendirmek#

Aracın döndürdüğü şeyin ham API cevabı olması gerekmiyor. Bağlama yazılan her bayt, sonraki turda modelin okuduğu metindir: gereksiz alanlar hem bütçe harcar hem ilgili bilgiyi gürültüye gömer. Pratik kural üç parçalı — göreve yetecek en küçük gösterim, sonraki çağrı için gereken kimlik alanları, ve kesilme varsa devam işareti.

// HAM CEVAP: kırk alan, iç kimlikler, biçimlendirme meta verisi. Bağlama yazılmaz.
// GÖZLEM: göreve yeten alanlar artı devam bilgisi.
{
  "bulunan": 3,
  "gosterilen": 1,
  "kayitlar": [
    { "siparis_no": "SIP-2026-0412", "durum": "kargoda", "tahmini_teslim": "2026-09-18" }
  ],
  "kesildi": true,
  "devam_anahtari": "s2",
  "not": "Kalan kayıtlar için devam_anahtari ile tekrar çağır."
}

Paralel ve sıralı çağrı#

• Bağımsız çağrılar aynı turda birlikte verilebilir; gecikme toplam değil en yavaş çağrı kadar olur.
• Bir çağrının argümanı başka çağrının sonucundan geliyorsa paralel verilemez. Bunu şema açıklamasıyla değil akış tasarımıyla çözün.
• Yan etkileri birbirini etkileyen çağrıları (aynı kaydı güncelleyen iki çağrı) kod tarafında sıraya alın; sıra belirsizliği en zor teşhis edilen hata sınıfıdır.
• Kısmi başarı davranışı önceden tanımlı olmalı: üç çağrıdan biri hata verdiğinde diğer ikisinin sonucu da gözleme yazılır, yoksa model neyin yapıldığını bilemez.

Tekrar deneme ve idempotanlık#

Ajan döngüsünde bir çağrı sessizce iki kez yürütülebilir: zaman aşımı sonrası yeniden deneme, modelin aynı kararı tekrar üretmesi veya kısmi hatadan sonra planın baştan koşması. Yazma araçlarında bunun karşılığı çift kayıt, çift mesaj, çift tahsilattır. Çözüm model tarafında değil araç sözleşmesinde: yazma çağrıları bir istemci anahtarı taşır ve aynı anahtarla gelen ikinci çağrı yeni kayıt açmak yerine ilk sonucun kendisini döndürür.