Kurrikulum Leson 138 van 250 · Gestruktureerde Uitsettes & Funksie/Gereedskap Roeping
Gestruktureerde Uitsettes & Funksie/Gereedskap Roeping

Beperkte / Skema-afgedwingte Uitsette

Jy het die model JSON by hand in die vorige lesse gesit. Moderne praktyk gaan een stap vroeër: stop die model om slegte JSON uit te stoot van die begin af. Dit is constrained decoding (ook bekend as gestruktureerde uitset). Jy gee die API 'n skema, en die decoder word net toegelaat om tokens te kies wat die uitset geldig teen die skema hou. Die model kan letterlik nie 'n ontbrekende veld of 'n verkeerde tipe waarde produseer nie.

Met die OpenAI-styl API stuur jy 'n response_format met 'n JSON Schema en strict: true (illustratief net -> ons roep nie enige model hier nie):

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"],
            },
        },
    },
)

Die res van hierdie kursus roep Anthropic aan, wat dieselfde waarborg aanbied deur output_config vir gegarandeerde-JSON-antwoorde en strict tool-gebruik vir skema-perfekte tool-insets:

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"],
        },
    }},
)

In elk geval doen die verskaffer die beperking. Maar beperkte dekodering kan steeds nie jou besigheidsreëls nagaan nie (is die ouderdom redelik? is die valuta een wat jy ondersteun?), en nie elke model of gateway ondersteun dit nie. So jy valideer dus aan jou eie kant ongeag alles. Daardie validator is wat jy nou bou.

Aan die Python-kant is die de-facto standaard om daardie vorm te verklaar en te valideer Pydantic. Jy skryf 'n model-klas en die biblioteek parseer, dwing dit oor en valideer dit vir jou:

from pydantic import BaseModel

class Person(BaseModel):
    name: str
    age: int

record = Person.model_validate_json(text)   # raises if it does not fit

Pydantic is nie beskikbaar in hierdie in-browser sandbox nie, so jy gaan die selfde idee by hand met die standaardbiblioteek bou. Dit is presies wat hierdie biblioteke onder die oppervlak doen, en dit maak die reëls onmoontlik om weg te vee. Jy skryf validate_against_schema(obj, schema).

Die schema is 'n dict. Elke waarde is óf 'n tipe naam string ("int", "float", "str", "bool", "list", "dict") óf 'n klein spesifikasiedict soos {"type": "int", "default": 0}. Jou funksie gee 'n resultaatdict {"ok": bool, "value": dict, "errors": list} terug:

  • As obj nie 'n dict is nie, retourneer ok=False met een root-fout en 'n leë value.
  • Vir elke veld: as dit missing is en die spesifikasie het 'n "default", vul die standaard in (die coerce/default pass). As dit weg is sonder 'n standaard, rekord 'n fout.
  • As indien teenwoordig, kontroleer sy type. As dit nie ooreenstem nie, rekord 'n fout wat die veld benoem.
  • Coerce 'n gewone int tot by 'n float wanneer 'n float wou word (dit is sonder verlies en veilig), maar moenie enigiets anders koers nie.
  • As daar enige foute was, gee ok=False met die versamelde errors en 'n leë value; anders gee ok=True met die gesitiseerde value.

Die bool-is-int valstrik. In Python bool is 'n subklas van int, so isinstance(True, int) is True en JSON true dekodeer na Python True. 'n Naïewe tipetoets sal "age": true deur 'n int veld laat gly. Verwerp 'n bool uitdruklik waar 'n int of 'n float vereis word:

if expected is int and isinstance(value, bool):
    errors.append(field + ": expected int, got bool")

Bou dit sodat twee verskillende korrek gevormde payloads albei slaag, 'n ontbrekende veld en 'n verkeerde tipe land elk in errors, 'n standaard vul in, 'n int dwing oor na 'n float, en 'n skelm bool word verwerp waar 'n getal vereis word.

Jou beurt

Skryf validate_against_schema(obj, schema) wat {"ok", "value", "errors"} teruggee. schema koppel elke veld na 'n tipe-naam string ("int"/"float"/"str"/"bool"/"list"/"dict") of 'n spesifikasie-woordeboek {"type": ..., "default": ...}. Verwerp 'n nie-woordeboek obj. Registreer 'n fout vir elke ontbrekende (geen-standaard) of verkeerd-getipe veld. Vul 'n standaard in wanneer een verskaf word. Dwing 'n gewone int tot float. Verwerp 'n bool waar 'n int of float vereis word (die bool-is-int valstrik). Gee ok=True met die gesifiseerde value terug net wanneer daar geen foute is nie.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.