Structured outputs with Pydantic

Relay needs to triage every new ticket: which category it belongs to, how urgent it is, whether a human should see it now. Asking a model for that in prose and then parsing the prose is the worst of both worlds, a language model on one side and a regex on the other. Structured output removes the regex. You hand the provider a JSON schema, the model produces JSON that fits it, and you validate the result with the Pydantic model the schema came from. The schema is the contract, and the same class defines it, checks it, and types your code.

Start with the Pydantic class, and write it as if it were a prompt, because it is one. Field names, Literal choices, and description strings all reach the model.