Gemini Interactions - Structured Output

Example showing structured output with the Interactions API.

Example showing structured output with the Interactions API. Uses Pydantic models to enforce JSON schema on responses.

structured_output.py

"""
Gemini Interactions - Structured Output
========================================

Example showing structured output with the Interactions API.
Uses Pydantic models to enforce JSON schema on responses.
"""

from agno.agent import Agent
from agno.models.google import GeminiInteractions
from pydantic import BaseModel, Field

# ---------------------------------------------------------------------------
# Define output schema
# ---------------------------------------------------------------------------


class MovieReview(BaseModel):
    title: str = Field(description="The movie title")
    year: int = Field(description="Release year")
    genre: str = Field(description="Primary genre")
    rating: float = Field(description="Rating out of 10")
    summary: str = Field(description="Brief review summary")


# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(
    model=GeminiInteractions(id="gemini-3.5-flash"),
    output_schema=MovieReview,
    markdown=True,
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    response = agent.run("Write a review of The Matrix (1999)")

    if response.content:
        # When using output_schema, the framework parses the response into
        # the Pydantic model automatically. response.content is a MovieReview object.
        review = response.content
        if isinstance(review, MovieReview):
            print(f"Title: {review.title}")
            print(f"Year: {review.year}")
            print(f"Genre: {review.genre}")
            print(f"Rating: {review.rating}/10")
            print(f"Summary: {review.summary}")
        else:
            print(f"Raw response: {review}")

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno google-genai
   
3. Export your Google API key

   Mac/Linux

   export GOOGLE_API_KEY="your_google_api_key_here"
   

   $Env:GOOGLE_API_KEY="your_google_api_key_here"
   
4. Run the example

   Save the code above as structured_output.py, then run:

   python structured_output.py
   

Full source: cookbook/90_models/google/gemini_interactions/structured_output.py