Skip to main content
PydanticAI is a Python agent framework designed to make it less painful to build production-grade applications with Generative AI. Built by the team behind Pydantic, it provides a clean, type-safe way to build AI agents with structured outputs.

Install

Setup

Set up tracing using OpenTelemetry and the PydanticAI instrumentation:

Basic Usage

Here’s a simple example using PydanticAI with automatic tracing:

Advanced Usage

Agent with System Prompts and Tools

Observe

Now that you have tracing setup, all PydanticAI agent operations will be streamed to your running Phoenix instance for observability and evaluation. You’ll be able to see:
  • Agent interactions: Complete conversations between your application and the AI model
  • Structured outputs: Pydantic model validation and parsing results
  • Tool usage: When agents call external tools and their responses
  • Performance metrics: Response times, token usage, and success rates
  • Error handling: Validation errors, API failures, and retry attempts
  • Multi-agent workflows: Complex interactions between multiple agents
The traces will provide detailed insights into your AI agent behaviors, making it easier to debug issues, optimize performance, and ensure reliability in production.

Resources