Kısıtlanmış / Şema Zorunlu Çıktılar
Son derslerde model JSON'unu elle doğruladın. Modern uygulama bir adım önce başlar: modelin en baştan kötü JSON üretmesini durdur. Bu kısıtlı çözümlemedir (yapılandırılmış çıktılar da denir). API'ye bir şema verirsin, ve çözümleyicinin yalnızca çıktıyı ona karşı geçerli tutan token'ları örneklemesine izin verilir. Model kelimenin tam anlamıyla eksik bir alan ya da yanlış türde bir değer üretemez.
OpenAI tarzı API ile bir JSON Şeması ve strict: true içeren bir response_format verirsin (yalnızca açıklama amaçlı -> burada hiçbir modeli çağırmıyoruz):
resp = client.chat.completions.create(
model="...",
messages=[...],
response_format={
"type": "json_schema",
"json_schema": {
"name": "person",
"strict": True,
"schema": {
"type": "object",
"properties": {"name": {"type": "string"}, "age": {"type": "integer"}},
"required": ["name", "age"],
},
},
},
)Bu kursun geri kalanı Anthropic'i çağırır; o da aynı garantiyi garantili JSON cevapları için output_config ve şemaya tam uyan araç girdileri için strict araç kullanımı ile sunar:
resp = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[...],
output_config={"format": {
"type": "json_schema",
"schema": {
"type": "object",
"properties": {"name": {"type": "string"}, "age": {"type": "integer"}},
"required": ["name", "age"],
},
}},
)Her iki durumda da kısıtlamayı sağlayıcı yapar. Ama kısıtlı çözümleme yine de iş kurallarını kontrol edemez (yaş makul mü? para birimi desteklediğin biri mi?), ve her model ya da ağ geçidi onu desteklemez. Bu yüzden ne olursa olsun kendi tarafında doğrularsın. Şimdi kurduğun şey o doğrulayıcıdır.
Python tarafında o biçimi bildirmek ve doğrulamak için fiilî standart Pydantic'tir. Bir model sınıfı yazarsın ve kütüphane senin için ayrıştırır, dönüştürür ve doğrular:
from pydantic import BaseModel
class Person(BaseModel):
name: str
age: int
record = Person.model_validate_json(text) # raises if it does not fitPydantic bu tarayıcı içi korumalı alanda yok, bu yüzden aynı fikri standart kütüphaneyle elle kuracaksın. Bu kütüphaneler arka planda tam olarak bunu yapar, ve kuralları geçiştirmeyi imkânsız kılar. validate_against_schema(obj, schema) yazıyorsun.
schema bir sözlüktür. Her değer ya bir tür adı dizgisi ("int", "float", "str", "bool", "list", "dict") ya da {"type": "int", "default": 0} gibi küçük bir tanım sözlüğüdür. Fonksiyonun bir sonuç sözlüğü {"ok": bool, "value": dict, "errors": list} döndürür:
objbirdictdeğilse, tek bir kök hatası ve boş birvalueileok=Falsedöndür.- Her alan için: eksikse ve tanımın bir
"default"'u varsa, varsayılanı doldur (dönüştürme/varsayılan geçişi). Varsayılanı olmadan eksikse bir hata kaydet. - Varsa türünü kontrol et. Uyuşmazlıkta alanı adlandıran bir hata kaydet.
- Bir float istendiğinde düz bir
int'i birfloat'a dönüştür (bu kayıpsız ve güvenli), ama başka hiçbir şeyi dönüştürme. - Herhangi bir hata olduysa, toplanan
errorsve boş birvalueileok=Falsedöndür; aksi halde doğrulanmışvalueileok=Truedöndür.
bool-bir-int'tir tuzağı. Python'da bool, int'in bir alt sınıfıdır, bu yüzden isinstance(True, int) True'dur ve JSON true Python True'ya çözülür. Saf bir tür kontrolü "age": true'nun bir int alanından rahatça geçmesine izin verirdi. Bir int ya da float gereken her yerde bir bool'u açıkça reddet:
if expected is int and isinstance(value, bool):
errors.append(field + ": expected int, got bool")Onu öyle kur ki iki farklı iyi biçimli yük de geçsin, eksik bir alan ve yanlış bir türün her biri errors'a düşsün, bir varsayılan dolsun, bir int bir float'a dönüşsün, ve sinsi bir bool bir sayı gereken yerde reddedilsin.
{"ok", "value", "errors"} döndüren bir validate_against_schema(obj, schema) yaz. schema her alanı bir tip-adı dizgisine ("int"/"float"/"str"/"bool"/"list"/"dict") veya bir spec sözlüğüne {"type": ..., "default": ...} eşler. Sözlük olmayan bir obj durumunda reddet, eksik (varsayılanı olmayan) veya yanlış tipli her alan için bir hata kaydet, varsayılanı varsa doldur, düz bir int değerini float değerine zorla ve int veya float gereken yerde bir bool durumunu reddet (bool-is-int tuzağı). Hata olmadığında doğrulanmış value ile birlikte ok=True döndür.
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.
Bu tarayıcı learn.floati.life için çerezleri engelliyor, bu yüzden burada bitirdiğin dersler sırasıyla açılamıyor. Bu site için çerezlere izin ver ve sayfayı yenile.