Pydantic AI

Pydantic AI

GenAI Agent Framework, the Pydantic way

Pydantic AI is a Python agent framework designed to make it less painful to build production grade applications with Generative AI.

Available Resources

Overview

• Coding Agent Skills

  • URL: https://pydantic.dev/docs/ai/overview/coding-agent-skills/index.md

• Pydantic AI Gateway

  • URL: https://pydantic.dev/docs/ai/overview/gateway/index.md

• Getting Help

  • URL: https://pydantic.dev/docs/ai/overview/help/index.md

• Installation

  • URL: https://pydantic.dev/docs/ai/overview/install/index.md

• Troubleshooting

  • URL: https://pydantic.dev/docs/ai/overview/troubleshooting/index.md

Core Concepts

• Agents

  • URL: https://pydantic.dev/docs/ai/core-concepts/agent/index.md

• Agent Specs

  • URL: https://pydantic.dev/docs/ai/core-concepts/agent-spec/index.md

• Capabilities

  • URL: https://pydantic.dev/docs/ai/core-concepts/capabilities/index.md

• Dependencies

  • URL: https://pydantic.dev/docs/ai/core-concepts/dependencies/index.md

• Direct Model Requests

  • URL: https://pydantic.dev/docs/ai/core-concepts/direct/index.md

• Hooks

  • URL: https://pydantic.dev/docs/ai/core-concepts/hooks/index.md

• Messages and chat history

  • URL: https://pydantic.dev/docs/ai/core-concepts/message-history/index.md

• Output

  • URL: https://pydantic.dev/docs/ai/core-concepts/output/index.md

Models & Providers

• Anthropic

  • URL: https://pydantic.dev/docs/ai/models/anthropic/index.md

• Bedrock

  • URL: https://pydantic.dev/docs/ai/models/bedrock/index.md

• Cerebras

  • URL: https://pydantic.dev/docs/ai/models/cerebras/index.md

• Cohere

  • URL: https://pydantic.dev/docs/ai/models/cohere/index.md

• Google

  • URL: https://pydantic.dev/docs/ai/models/google/index.md

• Groq

  • URL: https://pydantic.dev/docs/ai/models/groq/index.md

• Hugging Face

  • URL: https://pydantic.dev/docs/ai/models/huggingface/index.md

• Mistral

  • URL: https://pydantic.dev/docs/ai/models/mistral/index.md

• Ollama

  • URL: https://pydantic.dev/docs/ai/models/ollama/index.md

• OpenAI

  • URL: https://pydantic.dev/docs/ai/models/openai/index.md

• OpenRouter

  • URL: https://pydantic.dev/docs/ai/models/openrouter/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/models/overview/index.md

• xAI

  • URL: https://pydantic.dev/docs/ai/models/xai/index.md

Tools & Toolsets

• Common Tools

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/common-tools/index.md

• Deferred Tools

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/deferred-tools/index.md

• Native Tools

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/native-tools/index.md

• Third-Party Tools

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/third-party-tools/index.md

• Function Tools

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/tools/index.md

• Advanced Tool Features

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/tools-advanced/index.md

• Toolsets

  • URL: https://pydantic.dev/docs/ai/tools-toolsets/toolsets/index.md

Advanced Features

• Image, Audio, Video & Document Input

  • URL: https://pydantic.dev/docs/ai/advanced-features/input/index.md

• HTTP Request Retries

  • URL: https://pydantic.dev/docs/ai/advanced-features/retries/index.md

• Thinking

  • URL: https://pydantic.dev/docs/ai/advanced-features/thinking/index.md

Guides

• Embeddings

  • URL: https://pydantic.dev/docs/ai/guides/embeddings/index.md

• Extensibility

  • URL: https://pydantic.dev/docs/ai/guides/extensibility/index.md

• Multi-Agent Patterns

  • URL: https://pydantic.dev/docs/ai/guides/multi-agent-applications/index.md

• Testing

  • URL: https://pydantic.dev/docs/ai/guides/testing/index.md

• Web Chat UI

  • URL: https://pydantic.dev/docs/ai/guides/web/index.md

MCP

• Client

  • URL: https://pydantic.dev/docs/ai/mcp/client/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/mcp/overview/index.md

• Server

  • URL: https://pydantic.dev/docs/ai/mcp/server/index.md

Pydantic AI Harness

• Code Mode

  • URL: https://pydantic.dev/docs/ai/harness/code-mode/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/harness/overview/index.md

Pydantic Evals

• Overview

  • URL: https://pydantic.dev/docs/ai/evals/evals/index.md

• Built-in Evaluators

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/built-in/index.md

• Custom Evaluators

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/custom/index.md

• Third-Party Integrations

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/framework-integrations/index.md

• LLM Judge

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/llm-judge/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/overview/index.md

• Report Evaluators

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/report-evaluators/index.md

• Span-Based

  • URL: https://pydantic.dev/docs/ai/evals/evaluators/span-based/index.md

• Simple Validation

  • URL: https://pydantic.dev/docs/ai/evals/examples/simple-validation/index.md

• Core Concepts

  • URL: https://pydantic.dev/docs/ai/evals/getting-started/core-concepts/index.md

• Quick Start

  • URL: https://pydantic.dev/docs/ai/evals/getting-started/quick-start/index.md

• Concurrency & Performance

  • URL: https://pydantic.dev/docs/ai/evals/how-to/concurrency/index.md

• Dataset Management

  • URL: https://pydantic.dev/docs/ai/evals/how-to/dataset-management/index.md

• Dataset Serialization

  • URL: https://pydantic.dev/docs/ai/evals/how-to/dataset-serialization/index.md

• Case Lifecycle Hooks

  • URL: https://pydantic.dev/docs/ai/evals/how-to/lifecycle/index.md

• Logfire Integration

  • URL: https://pydantic.dev/docs/ai/evals/how-to/logfire-integration/index.md

• Metrics & Attributes

  • URL: https://pydantic.dev/docs/ai/evals/how-to/metrics-attributes/index.md

• Multi-Run Evaluation

  • URL: https://pydantic.dev/docs/ai/evals/how-to/multi-run/index.md

• Retry Strategies

  • URL: https://pydantic.dev/docs/ai/evals/how-to/retry-strategies/index.md

• Online Evaluation

  • URL: https://pydantic.dev/docs/ai/evals/online-evaluation/index.md

Pydantic Graph

• Decisions

  • URL: https://pydantic.dev/docs/ai/graph/builder/decisions/index.md

• Getting Started

  • URL: https://pydantic.dev/docs/ai/graph/builder/index.md

• Joins & Reducers

  • URL: https://pydantic.dev/docs/ai/graph/builder/joins/index.md

• Parallel Execution

  • URL: https://pydantic.dev/docs/ai/graph/builder/parallel/index.md

• Steps

  • URL: https://pydantic.dev/docs/ai/graph/builder/steps/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/graph/graph/index.md

Integrations

• Command Line Interface (CLI)

  • URL: https://pydantic.dev/docs/ai/integrations/cli/index.md

• Apache Airflow

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/airflow/index.md

• DBOS

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/dbos/index.md

• Kitaru

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/kitaru/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/overview/index.md

• Prefect

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/prefect/index.md

• Restate

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/restate/index.md

• Temporal

  • URL: https://pydantic.dev/docs/ai/integrations/durable_execution/temporal/index.md

• Debugging & Monitoring with Pydantic Logfire

  • URL: https://pydantic.dev/docs/ai/integrations/logfire/index.md

• AG-UI

  • URL: https://pydantic.dev/docs/ai/integrations/ui/ag-ui/index.md

• Overview

  • URL: https://pydantic.dev/docs/ai/integrations/ui/overview/index.md

• Vercel AI

  • URL: https://pydantic.dev/docs/ai/integrations/ui/vercel-ai/index.md

Examples

• Agent User Interaction (AG-UI)

  • URL: https://pydantic.dev/docs/ai/examples/ag-ui/index.md

• Bank Support

  • URL: https://pydantic.dev/docs/ai/examples/conversational-agents/bank-support/index.md

• Chat App with FastAPI

  • URL: https://pydantic.dev/docs/ai/examples/conversational-agents/chat-app/index.md

• Data Analyst

  • URL: https://pydantic.dev/docs/ai/examples/data-analytics/data-analyst/index.md

• RAG

  • URL: https://pydantic.dev/docs/ai/examples/data-analytics/rag/index.md

• SQL Generation

  • URL: https://pydantic.dev/docs/ai/examples/data-analytics/sql-gen/index.md

• Flight Booking

  • URL: https://pydantic.dev/docs/ai/examples/flight-booking/index.md

• Pydantic Model

  • URL: https://pydantic.dev/docs/ai/examples/getting-started/pydantic-model/index.md

• Weather Agent

  • URL: https://pydantic.dev/docs/ai/examples/getting-started/weather-agent/index.md

• Setup

  • URL: https://pydantic.dev/docs/ai/examples/setup/index.md

• Slack Lead Qualifier with Modal

  • URL: https://pydantic.dev/docs/ai/examples/slack-lead-qualifier/index.md

• Stream Markdown

  • URL: https://pydantic.dev/docs/ai/examples/streaming/stream-markdown/index.md

• Stream Whales

  • URL: https://pydantic.dev/docs/ai/examples/streaming/stream-whales/index.md

API Reference

• Link: [](

  • URL: https://pydantic.dev/docs/ai/api/builtin_tools/index.md)

• pydantic_ai.models.anthropic

  • URL: https://pydantic.dev/docs/ai/api/models/anthropic/index.md

• pydantic_ai.models

  • URL: https://pydantic.dev/docs/ai/api/models/base/index.md

• pydantic_ai.models.bedrock

  • URL: https://pydantic.dev/docs/ai/api/models/bedrock/index.md

• pydantic_ai.models.cerebras

  • URL: https://pydantic.dev/docs/ai/api/models/cerebras/index.md

• pydantic_ai.models.cohere

  • URL: https://pydantic.dev/docs/ai/api/models/cohere/index.md

• pydantic_ai.models.fallback

  • URL: https://pydantic.dev/docs/ai/api/models/fallback/index.md

• pydantic_ai.models.function

  • URL: https://pydantic.dev/docs/ai/api/models/function/index.md

• pydantic_ai.models.google

  • URL: https://pydantic.dev/docs/ai/api/models/google/index.md

• pydantic_ai.models.groq

  • URL: https://pydantic.dev/docs/ai/api/models/groq/index.md

• pydantic_ai.models.huggingface

  • URL: https://pydantic.dev/docs/ai/api/models/huggingface/index.md

• pydantic_ai.models.instrumented

  • URL: https://pydantic.dev/docs/ai/api/models/instrumented/index.md

• pydantic_ai.models.mcp_sampling

  • URL: https://pydantic.dev/docs/ai/api/models/mcp-sampling/index.md

• pydantic_ai.models.mistral

  • URL: https://pydantic.dev/docs/ai/api/models/mistral/index.md

• pydantic_ai.models.ollama

  • URL: https://pydantic.dev/docs/ai/api/models/ollama/index.md

• pydantic_ai.models.openai

  • URL: https://pydantic.dev/docs/ai/api/models/openai/index.md

• pydantic_ai.models.openrouter

  • URL: https://pydantic.dev/docs/ai/api/models/openrouter/index.md

• pydantic_ai.models.test

  • URL: https://pydantic.dev/docs/ai/api/models/test/index.md

• pydantic_ai.models.wrapper

  • URL: https://pydantic.dev/docs/ai/api/models/wrapper/index.md

• pydantic_ai.models.xai

  • URL: https://pydantic.dev/docs/ai/api/models/xai/index.md

• pydantic_ai.agent

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/agent/index.md

• pydantic_ai.capabilities

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/capabilities/index.md

• pydantic_ai.common_tools

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/common_tools/index.md

• pydantic_ai — Concurrency

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/concurrency/index.md

• pydantic_ai.direct

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/direct/index.md

• pydantic_ai.durable_exec

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/durable_exec/index.md

• pydantic_ai.embeddings

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/embeddings/index.md

• pydantic_ai.exceptions

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/exceptions/index.md

• pydantic_ai.ext

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/ext/index.md

• pydantic_ai.format_prompt

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/format_prompt/index.md

• pydantic_ai.function_signature

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/function_signature/index.md

• pydantic_ai.mcp

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/mcp/index.md

• pydantic_ai.messages

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/messages/index.md

• pydantic_ai.native_tools

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/native_tools/index.md

• pydantic_ai.output

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/output/index.md

• pydantic_ai.profiles

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/profiles/index.md

• pydantic_ai.providers

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/providers/index.md

• pydantic_ai.result

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/result/index.md

• pydantic_ai.retries

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/retries/index.md

• pydantic_ai.run

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/run/index.md

• pydantic_ai.settings

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/settings/index.md

• pydantic_ai.tools

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/tools/index.md

• pydantic_ai.toolsets

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/toolsets/index.md

• pydantic_ai.usage

  • URL: https://pydantic.dev/docs/ai/api/pydantic-ai/usage/index.md

• pydantic_evals.dataset

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/dataset/index.md

• pydantic_evals.evaluators

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/evaluators/index.md

• pydantic_evals.generation

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/generation/index.md

• pydantic_evals.lifecycle

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/lifecycle/index.md

• pydantic_evals.online

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/online/index.md

• pydantic_evals.online_capability

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/online_capability/index.md

• pydantic_evals.otel

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/otel/index.md

• pydantic_evals.reporting

  • URL: https://pydantic.dev/docs/ai/api/pydantic_evals/reporting/index.md

• pydantic_graph.basenode

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/basenode/index.md

• pydantic_graph.decision

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/decision/index.md

• pydantic_graph.exceptions

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/exceptions/index.md

• pydantic_graph.graph_builder

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/graph_builder/index.md

• pydantic_graph.join

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/join/index.md

• pydantic_graph.node

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/node/index.md

• pydantic_graph.step

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/step/index.md

• pydantic_graph.util

  • URL: https://pydantic.dev/docs/ai/api/pydantic_graph/util/index.md

• pydantic_ai.ui.ag_ui

  • URL: https://pydantic.dev/docs/ai/api/ui/ag_ui/index.md

• pydantic_ai.ui

  • URL: https://pydantic.dev/docs/ai/api/ui/base/index.md

• pydantic_ai.ui.vercel_ai

  • URL: https://pydantic.dev/docs/ai/api/ui/vercel_ai/index.md

Project

• Upgrade Guide

  • URL: https://pydantic.dev/docs/ai/project/changelog/index.md

• Contributing

  • URL: https://pydantic.dev/docs/ai/project/contributing/index.md

• Version Policy

  • URL: https://pydantic.dev/docs/ai/project/version-policy/index.md

How to Use This Skill

Reference these resources when working with Pydantic AI.