JSON garanterat av schema
På denna sida
Varför strukturerade utdata förändrar allt
När du använder en språkmodell i produktion behöver du svar som din kod kan hantera. Inte fritext, inte ungefärlig JSON – utan JSON som är garanterat kompatibel med ett schema du definierar. Det är precis vad Grok API:s strukturerade utdata erbjuder dig.
Principen är enkel: du tillhandahåller ett JSON-schema till modellen, och API:t garanterar att svaret följer denna struktur exakt. Inget slumpmässigt parsande, inga bräckliga regex-uttryck, inga try/catch-block för att hantera fall där modellen hittar på ett eget format.
Hur det fungerar
Strukturerade utdata förlitar sig på en begränsningsmekanism som tillämpas under genereringen av texten. Vid varje token som produceras tvingas modellen att endast generera token som är kompatibla med det angivna schemat. Resultatet: JSON som alltid är giltig och alltid kompatibel.
Låt oss titta på ett konkret exempel. Du vill extrahera kontaktinformation från ett e-postmeddelande:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# Svaret kommer ALLTID att vara ett giltigt Contact-objekt
Utan strukturerade utdata kan modellen returnera telefonnumret som "tel", "phone" eller "numéro". Med ett schema kommer fältet alltid att heta telephone, och dess värde kommer alltid att vara en sträng eller null.
Tillgänglighet
Strukturerade utdata stöds på alla xAI:s språkmodeller: Grok 4.5, Grok 4.3, grok-4.20-varianter och senare versioner. Oavsett vilken modell du använder är funktionen tillgänglig utan extra kostnad eller ytterligare konfiguration.
Utan kontra med strukturerade utdata
Här ser du vad du får utan och med denna funktion:
Utan strukturerade utdata:
- Modellen kan returnera fritext, ofullständig JSON eller ett oväntat format
- Du måste parsar manuellt och hantera fel
- Fältnamn kan variera från en begäran till en annan
- Din pipeline kraschar så fort modellen ändrar format
Med strukturerade utdata:
- JSON:en är alltid syntaktiskt giltig
- Strukturen matchar det angivna schemat exakt
- Datatyper respekteras (sträng, tal, booleskt värde, etc.)
- Din kod kan konsumera svaret direkt
Två tillgängliga metoder
Grok API erbjuder två metoder för att använda strukturerade utdata:
parse(): Automatisk metod som returnerar ett typat objekt direkt. Idealiskt för de flesta fall.response_format: Manuell metod som returnerar en JSON-sträng. Ger mer kontroll, men du måste själv hantera parsningen.
Du kommer att utforska dessa två metoder i detalj i de kommande lektionerna.
Viktiga punkter
- Strukturerade utdata garanterar JSON som är kompatibel med ditt schema vid varje anrop
- Begränsningen tillämpas under genereringen, inte efteråt
- Alla xAI:s språkmodeller stöder denna funktion
- Två metoder finns tillgängliga:
parse()(automatisk) ochresponse_format(manuell) - Detta är grunden för varje pålitlig produktionspipeline med Grok API