Müfredat 250 dersinden 136. · Yapılandırılmış Çıktılar ve Fonksiyon/Araç Çağırma
Yapılandırılmış Çıktılar ve Fonksiyon/Araç Çağırma

JSON Modu: Şemaya Göre Ayrıştır + Doğrula

Bir LLM'in bir alt sisteme yani bir veritabanına, bir API'ye veya bir faturalandırma işine veri sağlamasını istediğin an serbest metin işe yaramaz. yapılandırılmış çıktı gerekiyor: model JSON döndürür ve kodun bu JSON'u güvenebileceği tipi belirlenmiş bir nesneye dönüştürür. Çoğu model API'si modelin bir JSON dizisi üretmesini sağlayan bir "JSON mode" özelliğine sahiptir. Ancak "geçerli bir JSON" ile "istediğim nesne" iki farklı şeydir. Model ile kodun arasındaki sınır, doğrulamayı yaptığın yerdir.

Gerçek kodda model çağrısı şuna benzer (sadece örnektir -> burada herhangi bir model çağırmıyoruz):

resp = client.messages.create(model="...", messages=[...])
text = resp.content[0].text          # a JSON string, hopefully
record = parse_and_validate(text, {"name": str, "age": int})

parse_and_validate(text, schema) inşa ediyorsun. schema, her bir gerekli alanı Python tipine eşleyen bir dict, tıpkı {"name": str, "age": int} gibi. Fonksiyonun şunları yapmalı:

  • json.loads metni bir Python nesnesine dönüştür.
  • Bunun bir dict -> bir JSON dizisi veya yalın bir sayı istediğin kayıt değildir.
  • Şemadaki her alan için: mevcut olup olmadığını kontrol et (eksik alan varsa hata ver) ve doğru tipte olup olmadığını kontrol et (eşleşme yoksa hata ver).
  • Sadece o alanlardan oluşan tip tanımlı bir dict döndür.

bool-is-int tuzağı. Python'da, bool bir int alt sınıfıdır, bu yüzden isinstance(True, int) bir True'dir. JSON true Python True olarak çözümlenir. Şeman age için bir int bekliyor ve model "age": true gönderiyorsa, basit bir isinstance kontrolü bunu geçirebilir. Buna karşı önlem al: beklenen tip int olduğunda, bir bool değerini açıkça reddet.

if expected is int and isinstance(value, bool):
    raise ValueError("age must be int, got bool")

Hatalı alanı belirten bir mesaj içeren net bir exception (bir ValueError) fırlat ki çağıran kişi modelin tam olarak nerede hata yaptığını kaydedebilsin. İki farklı geçerli payloadun da geçeceği, eksik bir alanın, yanlış bir tipin ve gizli bir boolün ise her birinin hata fırlatacağı şekilde oluştur.

Senin sıran

schema bir {field: type} sözlüğü olduğunda parse_and_validate(text, schema) yaz. json.loads metni yaz, sözlük olduğunu doğrula, sonra her şema alanı için mevcut olup olmadığını ve doğru tipte olup olmadığını kontrol et, tipli sözlüğü döndür. Eksik alanlar ve yanlış tipler hata vermelidir. Bir int gereken bir JSON true durumunda reddet (bool-is-int tuzağı).

Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor

Bu alıştırma yakında açılacak

Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.