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 fitPydantic 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
objnie 'ndictis nie, retourneerok=Falsemet 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
inttot by 'nfloatwanneer 'n float wou word (dit is sonder verlies en veilig), maar moenie enigiets anders koers nie. - As daar enige foute was, gee
ok=Falsemet die versameldeerrorsen 'n leëvalue; anders geeok=Truemet die gesitiseerdevalue.
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.
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.
Hierdie blutser blokkeer koekies vir learn.floati.life, so lesse wat jy hier voltooi het kan nie in volgorde oopgaan nie. Laat koekies vir hierdie webwerf toe en laai nuut.