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

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 fit

Pydantic 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:

  • obj bir dict değilse, tek bir kök hatası ve boş bir value ile ok=False dö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 bir float'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 errors ve boş bir value ile ok=False döndür; aksi halde doğrulanmış value ile ok=True dö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.

Senin sıran

{"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.