Structured Output

from pydantic import BaseModel
from opperai.agent import Agent

class Summary(BaseModel):
    title: str
    key_points: list[str]
    sentiment: str  # "positive" | "negative" | "neutral"

agent = Agent(
    name="summarizer",
    instructions="Summarize the input.",
    output_schema=Summary,
)

result = await agent.run("Python 3.12 brings major performance improvements...")

summary = result.output  # validated Summary instance
print(summary.title)
print(summary.sentiment)
for point in summary.key_points:
    print("-", point)

import { z } from "zod";
import { Agent } from "opperai";

const Summary = z.object({
  title: z.string().describe("A short title"),
  key_points: z.array(z.string()).describe("3-5 key points"),
  sentiment: z.enum(["positive", "negative", "neutral"]),
});

const agent = new Agent({
  name: "summarizer",
  instructions: "Summarize the input.",
  outputSchema: Summary,
});

const result = await agent.run("Python 3.12 brings major performance improvements...");

// result.output is typed — no cast needed
console.log(result.output.title);
console.log(result.output.sentiment);
for (const point of result.output.key_points) console.log("-", point);