Yapılandırılmış yanıt nedir?
Yapılandırılmış yanıt, dil modelinden düz metin yerine adları, veri türleri ve kabul edilen değer aralıkları belli alanlardan oluşan bir kayıt istemek anlamına gelir. Her alanın zorunlu olup olmadığı ve bilgi yokken nasıl davranacağı baştan belirlenir. Çıktı uygulama tarafından okunup başka sistemlere aktarılabilir. Fakat şemaya uygun bir kayıt, içindeki bilginin gerçekle örtüştüğünü göstermez; yalnızca yapının kurallara uyduğunu gösterir.
Biçim denetimi neyi yakalar?
Bir şema doğrulayıcısı, zorunlu bir alanın eksik kalıp kalmadığını, bir değerin beklenen türde olup olmadığını ve sayısal bir alanın belirlenen sınırlar içinde durup durmadığını sınar. Bu kontroller otomatik ve tekrarlanabilir olduğu için değerlidir. Örneğin indirim oranı alanına 140 yazıldığında sistem, değerin yüzde sınırının dışında olduğunu fark edebilir.
Ancak aynı denetim, geçerli görünen ama yanlış bir değeri ayırt edemez. Kabul edilebilir aralıktaki bir indirim oranı, müşterinin onayladığı orandan farklı olabilir. Bu nedenle biçim kontrolünün sonucu, içerik kontrolü yapılana kadar hazır değil, yalnızca biçimce uygun olarak etiketlenmelidir.
Tasarım kararları: boş alan, varsayılan ve sınır
Şemayı yazarken en çok karar gerektiren konu, bilgi bulunmadığında alanın ne olacağıdır. Boş metin, null değeri ya da alanın hiç bulunmaması üç farklı anlam taşır ve hangisinin seçileceği sonraki adımı etkiler. Tahminle doldurulan bir alan eksiklik gibi görünmediği için en tehlikeli seçenektir. Bu nedenle her alan için bilinmeyen durumu açıkça tanımlanmalıdır.
Sınırlar da aynı dikkati ister. Çok geniş tutulan bir sayı aralığı hatalı girdileri sessizce geçirir; çok dar tutulan bir aralık ise geçerli ama nadir durumları reddeder. Şemayı tek seferde kesinleştirmek yerine, ilk dönemde reddedilen ve kabul edilen örnekleri gözden geçirip aralıkları buna göre ayarlamak daha güvenli bir yoldur.
Temsili işletme örneği
Temsili bir oto servis, müşterinin telefonda anlattığı arızayı kayda dönüştürmek için bir şema kullanmak istiyor. Alanlar araç markası, şikayet özeti, tahmini işçilik süresi ve randevu tercihini içeriyor. Müşteri markayı söylemediyse marka alanı boş kalır ve çıktıda belirtilmedi olarak işaretlenir. Model süre alanını yaklaşık iki saat gibi bir tahminle doldurursa, biçim kontrolü bunu hata saymayabilir. Servis danışmanı süreyi ustanın iş listesiyle karşılaştırana kadar kayıt taslak olarak bekler.
Biçim kontrolü ile içerik kontrolü
| Denetlenen konu | Biçim kontrolü | İçerik kontrolü |
|---|---|---|
| Zorunlu alan | Eksikse şema tarafından yakalanır | Dolu alanın doğru bilgi içerip içermediği ayrıca bakılır |
| Sayısal aralık | Sınır dışı değer yakalanır | Aralık içindeki değerin gerçek fiyat ya da süreyle uyumu kontrol edilir |
| Tahmin edilmiş değer | Tür ve aralık uygunsa geçer | Kaynakla karşılaştırılmadıkça hatalı kalabilir |
Sık karıştırılan nokta
Yanlış düşünce: Şemayı geçen çıktı güvenilir çıktıdır. Düzeltme: Doğrulama yalnızca alanın türünü, zorunluluğunu ve aralığını denetler. Alanların gerçek kaynakla eşleştiği ayrıca kontrol edilmelidir.
Uygulamada dikkat edilecekler
- Her alanın yanına bilgi yoksa nasıl davranacağını yazın ve bunu tek bir kurala bağlayın: boş değer, null ya da eksik anahtar.
- Sayısal alanlar için alt ve üst sınırı işletmenin gerçek uygulamasına göre belirleyin; sınır dışı değerleri ayrı bir inceleme listesine alın.
- Marka, ürün kodu ya da fiyat gibi alanları kendi kaynağınızla, örneğin güncel fiyat listesi ya da randevu defteriyle, ayrı bir adımda karşılaştırın.
- Kaydı sisteme yazmadan önce çıktıyı yetkili bir çalışana gösterin ve onay bilgisini kayıtta izleyin.
Sık sorulan sorular
Biçim kontrolünden geçen çıktıyı doğrudan kullanabilir miyim?
Hayır. Geçen çıktı yalnızca yapının kurala uyduğunu gösterir. Alanlardaki bilgi kaynakla karşılaştırılıp onaylandıktan sonra kullanılmalıdır.
Şemaya hangi alanları koymalıyım?
Süreçte gerçekten karar için kullanılacak alanlarla başlayın. Her alanın bir sorumlusu ve bilgi yokken izlenecek bir davranışı olmalıdır. Gereksiz zorunlu alanlar, bilgi vermeyen müşterilerde sürekli hata üretir.
Teknik kaynak
json-schema.org · Yapılandırılmış yanıt
Teknik tanım için birincil kaynağa başvurulmuştur. İşletme senaryosu açıklama amacıyla hazırlanmış temsili bir örnektir.
İlgili kavramlar
Kavramdan uygulamaya
İşletmenize uyarlamak için ilgili rehberleri inceleyin.
Ürün Sorularında Yanıt Sınırı: Kod, Birim Ve Adet KararlarıTalep Özeti İle CRM Kaydı Arasında Kapsam Sınırı Nasıl Çizilir?Tüm blog rehberleri