Structured output

Wat is structured output?

Structured output betekent dat een AI-model antwoordt in een vooraf afgesproken structuur. Meestal is dat JSON met vaste velden, types en toegelaten waarden.

Vrije tekst is prima voor een uitleg. Software heeft iets anders nodig. Als een volgende stap de output moet verwerken, wil je niet hopen dat het model "ongeveer" dezelfde vorm gebruikt. Je wil weten dat er een veld category, confidence en reason terugkomt.

Structured output maakt AI-antwoorden parseerbaar en testbaar.

Wanneer gebruik je structured output?

• Bij classificatie
  Een ticket moet naar één van vijf categorieën met een score.

• Bij extractie
  Een factuurmail wordt omgezet naar leverancier, bedrag, vervaldatum en PO-nummer.

• Bij tool use
  Het model kiest een actie en vult parameters in.

• Bij workflows
  Een flow beslist op basis van velden, niet op basis van vrije tekst.

Hoe werkt structured output?

Je definieert een schema. Daarin staat welke velden verplicht zijn, welke types ze hebben en welke waarden toegestaan zijn. Het model krijgt de taak om binnen die structuur te antwoorden.

Moderne AI-platformen ondersteunen dit op API-niveau. Dat is sterker dan alleen in de prompt vragen om JSON. Een prompt kan vergeten worden; een schema kan gevalideerd worden.

Na het antwoord valideert je applicatie de output nog steeds. Als een veld ontbreekt of een waarde buiten de lijst valt, kan de flow stoppen, opnieuw proberen of menselijke review vragen.

Structured output versus JSON mode

JSON mode betekent meestal dat het model geldige JSON probeert te geven. Structured output gaat verder: de JSON moet passen bij een specifiek schema.

Het verschil is belangrijk. Geldige JSON kan nog altijd het verkeerde veld bevatten. Structured output verkleint die ruimte.

Waar moet je op letten bij structured output?

Maak schema's niet te groot
Een schema met tientallen velden verhoogt de kans op twijfel en onderhoudswerk.

Gebruik enums waar het kan
Laat het model kiezen uit toegelaten waarden in plaats van vrije labels te verzinnen.

Bewaar de reden apart
Combineer een machineveld met een korte uitleg voor menselijke controle.

FAQ over structured output

1. Is structured output altijd JSON?
JSON is het meest gebruikelijk, maar het principe kan ook met andere vaste formats.

2. Maakt structured output AI altijd betrouwbaar?
Nee. Het maakt de vorm betrouwbaarder. De inhoud moet je nog testen en valideren.