LLM Yapılandırılmış Çıktılar: Pydantic v2, JSON Schema ve Instructor ile Sıfır Hatalı Veri Çıkarma

from typing import List
from pydantic import BaseModel, Field, field_validator
import instructor
from openai import OpenAI

class InvoiceItem(BaseModel):
    description: str = Field(description="Hizmet veya ürün açıklaması")
    unit_price: float = Field(gt=0, description="Birim fiyat (pozitif sayı)")
    quantity: int = Field(gt=0, default=1, description="Adet miktarı")
    total: float = Field(gt=0, description="Kalem toplam tutarı")

class InvoiceExtraction(BaseModel):
    vendor_name: str = Field(min_length=2, description="Faturayı kesen şirket adı")
    tax_id: str = Field(description="Vergi kimlik veya VKN numarası")
    items: List[InvoiceItem]
    grand_total: float = Field(gt=0, description="KDV dahil genel toplam")

    @field_validator("grand_total")
    @classmethod
    def validate_total(cls, v, values):
        items = values.data.get("items", [])
        calculated = sum(item.total for item in items)
        if abs(v - calculated) > 1.0:
            raise ValueError(f"Toplam tutar kalemler toplamıyla uyuşmuyor: {v} != {calculated}")
        return v

client = instructor.from_openai(OpenAI())

raw_ocr_text = """
VERGİ FATURASI: Bulut Bilişim A.Ş. VKN: 1928374650
1. 12 Aylık Dedicated Sunucu Barındırma - 12 x 1500 TL = 18000 TL
2. SSL ve Güvenlik Duvarı Lisansı - 1 x 2000 TL = 2000 TL
TOPLAM: 20000 TL
"""

invoice = client.chat.completions.create(
    model="gpt-4o-mini",
    response_model=InvoiceExtraction,
    max_retries=3,
    messages=[{"role": "user", "content": raw_ocr_text}]
)

print(f"Başarıyla Çıkarıldı: {invoice.vendor_name} | Kalem Sayısı: {len(invoice.items)}")