FDE Foundations · Modül 8: Ajanlar ve Araçlar
Ajanlar için Araç Sözleşmeleri
Ajan, araçları kadar güvenilirdir. Her araç bir sözleşmedir: tipli girdiler, tipli çıktılar, yapılandırılmış hatalar ve ne zaman kullanılacağını söyleyen açıklama.
11 dk okuma
Kazanımlar
- Araçları şemalı açık sözleşmeler olarak tasarlamak
- Ajanın eyleme geçebileceği yapılandırılmış hatalar döndürmek
- Araç yüzeyini küçük ve amaçlı tutmak
Araçlar, tahmin eden okuru olan API'lerdir
Model araçları açıklamalardan ve şemalardan seçer. O açıklamaları akıllı yeni bir çalışan için API dokümanı gibi yaz: amaç, ne zaman kullanılır, ne zaman kullanılmaz, anlamları ve örnekleriyle girdi alanları, çıktı biçimi ve hata anlamları. Açıklamadaki belirsizlik, döngüde rastgeleliğe dönüşür.
Ajanın kullanabileceği hatalar
Prose değil, kodlar ve yeniden deneme ipuçlarıyla yapılandırılmış hatalar döndür ("rate_limited, retry_after 30"). Ajan koda göre dallanabilmeli: yeniden dene, kullanıcıya sor ya da temiz vazgeç. Her çağrıyı ve sonucu kaydet; döküm hata ayıklama yüzeyindir.
Küçük yüzey, büyük kazanç
Beş iyi tasarlanmış araç, yirmi örtüşen aracı yener: her ek araç yanlış seçme şansıdır. Birbirine yakın kopyaları birleştir, iki iş yapan araçları böl ve yıkıcı işlemleri genel araçların bayrağı olarak değil ek sürtünmeli ayrı araçlar yap (onay argümanları, dar izinler).
Araçları modelsiz test et
Araçlar sözleşme olduğundan bağımsız test edilebilir: şema doğrulama, hata yolları, idempotency. Ajan davranışı üretimde bozulduğunda araç test takımı, sözleşmenin mi planlamanın mı kırıldığını söyler; bu hata ayıklama süresini yarıya indirir.
Mini kontrol
2-3 soruluk isteğe bağlı öz kontrol. Yanıtlar cihazından çıkmaz, saklanmaz ve hiçbir değerlendirmeye sayılmaz.
Alıştırma
Kurgusal bir iade ajanı için araç sözleşmeleri yazın: üç araç (sipariş bul, politika kontrol et, iade ver) girdi ve çıktı alanlarıyla, her biri iki hata kodu ve tek satırlık kullanım rehberiyle.
Geçme kriterleri
Üç araç tipli alanlarla, yeniden deneme ipuçlu yapılandırılmış hatalar, yıkıcı iade aracı onay argümanıyla ayrılmış ve kullanım rehberi örtüşen araçları ayırt etmeli.