Programma Les 136 van 250 · Gestructureerde Outputs & Function/Tool Calling
Gestructureerde Outputs & Function/Tool Calling

JSON Mode: Parse + Valideer tegen een Schema

Zodra je wilt dat een LLM een systeem verderop voedt -> een database, een API, een factureringstaak -> is vrije tekst nutteloos. Je hebt gestructureerde uitvoer nodig: het model geeft JSON terug, en je code maakt van die JSON een getypeerd object waarop het kan vertrouwen. De meeste model-API's hebben een "JSON-modus" waardoor het model een JSON-string uitspuugt. Maar "het is geldige JSON" en "het is het object waar ik om vroeg" zijn twee verschillende dingen. De grens tussen het model en je code is de plek waar je valideert.

In echte code ziet de modelaanroep er zo uit (alleen ter illustratie -> we roepen hier geen model aan):

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

Je bouwt parse_and_validate(text, schema). Het schema is een dict dat elk verplicht veld aan zijn Python-type koppelt, zoals {"name": str, "age": int}. Je functie moet:

  • de tekst met json.loads omzetten in een Python-object.
  • bevestigen dat het een dict is -> een JSON-array of een los getal is niet het record waar je om vroeg.
  • voor elk veld in het schema controleren of het aanwezig is (geef een fout bij een ontbrekend veld) en van het juiste type is (geef een fout bij een afwijking).
  • een getypeerd dict met alleen die velden teruggeven.

De valkuil bool-is-int. In Python is bool een subklasse van int, dus isinstance(True, int) is True. JSON true wordt Python True. Wil je schema een int voor age en stuurt het model "age": true, dan laat een naïeve isinstance-controle het door. Bescherm je ertegen: als het verwachte type int is, weiger dan expliciet een bool-waarde.

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

Gooi een duidelijke uitzondering (een ValueError met een melding die het foute veld noemt), zodat wie aanroept precies kan loggen wat het model fout deed. Bouw het zo dat twee verschillende goedgevormde payloads allebei slagen, en dat een ontbrekend veld, een verkeerd type en een stiekeme bool elk een fout geven.

Jij bent aan de beurt

Schrijf parse_and_validate(text, schema) waar schema een {field: type} dict is. json.loads de tekst, bevestig dat het een dict is, en controleer dan voor elk schema veld of het aanwezig is en van het juiste type, waarbij je het getypeerde dict teruggeeft. Ontbrekende velden en verkeerde types moeten een fout geven. Wees streng voor een JSON true waar een int vereist is (de bool-is-int valkuil).

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.