JSON garanteret af skema
På denne side
Hvorfor strukturerede output ændrer alt
Når du bruger en sprogmodel i produktion, har du brug for svar, som din kode kan anvende direkte. Ikke fritekst, ikke approksimativ JSON – men JSON, der er garanteret kompatibel med et skema, du definerer. Det er præcis, hvad Grok API’s strukturerede output tilbyder dig.
Princippet er simpelt: Du leverer et JSON-skema til modellen, og API’en garanterer, at svaret vil følge denne struktur nøjagtigt. Ingen tilfældig parsing, ingen skrøbelige regulære udtryk, ingen try/catch-blokke for at håndtere tilfælde, hvor modellen finder på et eget format.
Hvordan det virker
Strukturerede output baserer sig på en begrænsningsmekanisme, der anvendes under genereringen af teksten. Ved hvert enkelt token, der produceres, begrænses modellen til kun at generere tokens, der er kompatible med det angivne skema. Resultatet er JSON, der altid er gyldig og altid overholder reglerne.
Lad os se på et konkret eksempel. Du ønsker at udtrække kontaktoplysninger fra en e-mail:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# Svaret vil ALTID være et gyldigt Contact-objekt
Uden strukturerede output kunne modellen returnere telefonnummeret som "tel", "phone" eller "numéro". Med et skema vil feltet altid hedde telephone, og værdien vil altid være en streng eller null.
Tilgængelighed
Strukturerede output understøttes på alle xAI-sprogmodeller: Grok 4.5, Grok 4.3, grok-4.20-varianter og senere versioner. Uanset hvilken model du bruger, er funktionen tilgængelig uden ekstra omkostninger eller yderligere konfiguration.
Uden kontra med strukturerede output
Her er forskellen på at bruge funktionen eller ej:
Uden strukturerede output:
- Modellen kan returnere fritekst, delvis JSON eller et uventet format
- Du skal parse manuelt og håndtere fejl
- Feltnavne kan variere fra én anmodning til en anden
- Din pipeline bryder sammen, så snart modellen ændrer format
Med strukturerede output:
- JSON’en er altid syntaktisk gyldig
- Strukturen matcher det angivne skema nøjagtigt
- Typer overholdes (streng, tal, boolean osv.)
- Din kode kan forbruge svaret direkte
To tilgængelige tilgange
Grok API tilbyder to metoder til at bruge strukturerede output:
parse(): Automatisk metode, der returnerer et typet objekt direkte. Ideel til de fleste tilfælde.response_format: Manuel metode, der returnerer en JSON-streng. Giver mere kontrol, men kræver at du selv parser svaret.
Du vil opdage disse to metoder i detaljer i de kommende lektioner.
Vigtige pointer
- Strukturerede output garanterer JSON, der overholder dit skema ved hver eneste kald
- Begrænsningen anvendes under genereringen, ikke bagefter
- Alle xAI-sprogmodeller understøtter denne funktion
- To metoder er tilgængelige:
parse()(automatisk) ogresponse_format(manuel) - Dette er fundamentet for enhver pålidelig produktionspipeline med Grok API