> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```python structured_output.py theme={null}
"""
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

<Steps>
  <Snippet file="create-venv-step.mdx" />

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U agno google-genai
    ```
  </Step>

  <Step title="Export your Google API key">
    <CodeGroup>
      ```bash Mac/Linux theme={null}
      export GOOGLE_API_KEY="your_google_api_key_here"
      ```

      ```bash Windows theme={null}
      $Env:GOOGLE_API_KEY="your_google_api_key_here"
      ```
    </CodeGroup>
  </Step>

  <Step title="Run the example">
    Save the code above as `structured_output.py`, then run:

    ```bash theme={null}
    python structured_output.py
    ```
  </Step>
</Steps>

Full source: [cookbook/90\_models/google/gemini\_interactions/structured\_output.py](https://github.com/agno-agi/agno/blob/main/cookbook/90_models/google/gemini_interactions/structured_output.py)