Bir araç çağrısı mükemmel bir şekilde geçerli yapılandırılmış veri olabilir ve yine de yanlış işlemi tanımlayabilir. Bir tarih doğru formatta olabilir ancak yanlış zaman diliminde olabilir. Bir müşteri adı birkaç kişiyle eşleşebilir. Boş bir arama sonucu, eşleşen kayıtların olmaması anlamına gelebilir veya aramanın başarısız olduğu anlamına gelebilir.
Bir ajan odaklı araç tasarladığımda, bu ayrımları aracın sözleşmesinin bir parçası olarak değerlendiriyorum. Model, girdilerin ne anlama geldiğini, sonucun hangi kanıtı sağladığını ve çağrıdan sonra hangi belirsizliğin kaldığını bilmelidir.
Açık bir anlamı olan tanımlayıcılar kullanın
Bir asistan “Alex için siparişi kontrol et” alırsa. Sadece serbest metin müşteri alanı kabul eden bir araç, belirsizliği arka plana itmeye teşvik eder. Daha iyi bir etkileşim, önce aday hesapları çözümler, ardından sipariş sorgulamasına kararlı bir tanımlayıcı gönderir.
Birden fazla aday kalırsa, sonuç bu belirsizliği ortaya çıkarmalı ve sessizce ilkini seçmemelidir. Bir araç tanımı, beklenen sıralamayı açıklayabilir, ancak arka uç yine de kimlik doğrulama hesabının kapsamı dışındaki bir tanımlayıcıyı reddetmelidir.
Son kontrol, model belgelenmiş sırayı takip etse bile gereklidir. Talimatlar doğru kullanımı açıklar; yürütme kuralları uygulamanın gerçekten neye izin verdiğini belirler.
Belgeler eksik, boş ve bilinmeyen değerler
Bir atlanan filtre, boş bir filtre ve “bilinmeyen” olarak ayarlanmış bir filtre farklı iş anlamlarına sahip olabilir. Örneğin, bir tarih aralığını atlamak varsayılan bir pencere kullanabilirken, boş bir aralık geçersiz olabilir. Ayrımı örtük bırakmak modeli tahmin yapmaya zorlar.
Sözleşmelerin varsayımları ve sınırları açıkça belirttiği durumları tercih ederim. Bir arama yanıtı, tamamlanıp tamamlanmadığını, daha fazla sayfanın olup olmadığını ve istenen kaynaklardan herhangi birinin sorgulanamadığını bildirmelidir. “Sonuç yok” ifadesi, gerçekten belirtilen kapsam içinde tamamlanan bir arama için ayrılmalıdır.
Conviro, benim inşa ettiğim platform‘nun müşteri destek bağlamı, bunu özellikle somut hale getiriyor. Bir asistan, mevcut olmayan bilgiyi, bir olayın hiç yaşanmadığına dair kanıttan ayırt edebilmelidir. Bunlar, bir müşteriye verilen farklı yanıtlardır.
Sonraki kararı destekleyen hataları döndürün
Faydalı bir hata, geçersiz bir isteği, geçici bir hizmet sorununu, erişim reddini ve belirsiz bir sonucu ayırt eder. Her biri farklı bir eyleme yol açmalıdır. Yeniden denemek, bir izin hatasını düzeltemez ve müşteriden ifadeyi yeniden formüle etmesini istemek, mevcut olmayan bir hizmeti onaramaz.
Bir arama için, found, not_found, ambiguous ve unavailable gibi sonuçları bir sonuç versiyonu ile tanımlardım. İsimler sadece örnektir. Önemli olan nokta, arayanın başarıyı metinden çıkarım yapmadan bir sonraki kararı verebilmesidir.
Ayrıntılı tanılamalar, bir operatöre kimlik bilgilerini, dahili sorguları veya özel kayıtları modele maruz bırakmadan erişilebilir kalabilir. Eyleme geçirilebilir bir hata, her uygulama detayını içermek zorunda değildir.
Önerilerden ayrı olarak etkileri tanımlayın.
“Güncelleme siparişi” adında bir araç, “teslimat adresi değişikliği önermeyi” daha fazla belirsizlikle gizler. Bir araç durum değiştirirse, sözleşmesi hedefi, ön koşulları ve kabulü onaylayan sonucu belirtmelidir. Üretilen önizleme, güncellemenin zaten gerçekleştiğine dair bir kanıt gibi görünmemelidir.
Bir ajanının önerisini yan etkilerinden ayırma konusunu daha fazla tartışıyorum. Kesin isimlendirme faydalıdır, ancak ayrımın tüm istek ve yanıt sürecine dayanması gerekir.
Sistem büyüdükçe sözleşmeyi versiyonlayın
Bir varsayılanı değiştirmek veya bir sonuç alanının anlamını değiştirmek, girişi hala geçerli olsa bile bir ajanı bozabilir. Temsilci çağrıları ve beklenen yorumları, belirsiz kimlikler ve eksik aramalar dahil olmak üzere, sözleşme örnekleri olarak saklayacağım.
Araç tanımları, şemalar ve çalışma zamanı doğrulaması aynı işlemi tanımlamalıdır. Bir araç yeni bir iş türünü desteklediğinde, ne zaman çağrılacağını belirleyen iş akışını yeniden gözden geçirin. İyi sözleşmeler, model sınırının her iki tarafındaki tahminleri azaltır ve yanlış çağrıları tanımlamayı kolaylaştırır.
30 Eylül 2026’da güncellendi.