# Pydantic AI Docs > Comprehensive reference documentation for Pydantic Ai Docs. - Skill: `knuckles-team/pydantic-ai-docs` (Agent Skill, multi-file: 409 files) - Install (CLI): `npx skillmds@latest add knuckles-team/pydantic-ai-docs` - Raw SKILL.md: https://api.skillmd.com/api/skills/knuckles-team/pydantic-ai-docs/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: Knuckles-Team (https://skillmd.com/u/knuckles-team) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/knuckles-team/pydantic-ai-docs --- # Pydantic Ai Docs Documentation Comprehensive reference documentation for Pydantic Ai Docs. **Original Sources**: - [https://ai.pydantic.dev](https://ai.pydantic.dev) **Contains**: 407 markdown files with full folder structure (crawled at depth 3). *Last updated: March 07, 2026* ## 📚 Table of Contents - 📁 **agent/** - [1. Model-level defaults](reference/agent/1.-Model-level-defaults.md) - [2. Agent-level defaults (overrides model defaults by merging)](reference/agent/2.-Agent-level-defaults-overrides-model-defaults-by-merging.md) - [3. Run-time overrides (highest priority)](reference/agent/3.-Run-time-overrides-highest-priority.md) - [Agents](reference/agent/Agents.md) - [First run](reference/agent/First-run.md) - [Run the agent](reference/agent/Run-the-agent.md) - [Second run, passing previous messages](reference/agent/Second-run-passing-previous-messages.md) - [Simple limit: allow up to 10 concurrent runs](reference/agent/Simple-limit-allow-up-to-10-concurrent-runs.md) - [With backpressure: limit concurrent runs and queue depth](reference/agent/With-backpressure-limit-concurrent-runs-and-queue-depth.md) - [Agent](reference/agent/agent.md) - [Table of Contents](reference/agent/toc.md) - 📁 **api_ag_ui/** - [Api Ag Ui](reference/api_ag_ui/api_ag_ui.md) - [`pydantic_ai.ag_ui`](reference/api_ag_ui/pydantic_ai.ag_ui.md) - [Table of Contents](reference/api_ag_ui/toc.md) - 📁 **api_agent/** - [Or provide additional models for UI selection](reference/api_agent/Or-provide-additional-models-for-UI-selection.md) - [Simple usage - uses agent's model and builtin tools](reference/api_agent/Simple-usage---uses-agents-model-and-builtin-tools.md) - [Then run with: uvicorn app:app --reload](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt1.md) - [Then Run With Uvicorn Appapp Reload Pt10](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt10.md) - [Then Run With Uvicorn Appapp Reload Pt11](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt11.md) - [Then Run With Uvicorn Appapp Reload Pt12](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt12.md) - [Then Run With Uvicorn Appapp Reload Pt13](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt13.md) - [Then Run With Uvicorn Appapp Reload Pt14](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt14.md) - [Then Run With Uvicorn Appapp Reload Pt15](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt15.md) - [Then Run With Uvicorn Appapp Reload Pt16](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt16.md) - [Then Run With Uvicorn Appapp Reload Pt2](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt2.md) - [Then Run With Uvicorn Appapp Reload Pt3](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt3.md) - [Then Run With Uvicorn Appapp Reload Pt4](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt4.md) - [Then Run With Uvicorn Appapp Reload Pt5](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt5.md) - [Then Run With Uvicorn Appapp Reload Pt6](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt6.md) - [Then Run With Uvicorn Appapp Reload Pt7](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt7.md) - [Then Run With Uvicorn Appapp Reload Pt8](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt8.md) - [Then Run With Uvicorn Appapp Reload Pt9](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt9.md) - [Api Agent](reference/api_agent/api_agent.md) - [`pydantic_ai.agent`](reference/api_agent/pydantic_ai.agent_pt1.md) - [Pydantic Ai.Agent Pt10](reference/api_agent/pydantic_ai.agent_pt10.md) - [Pydantic Ai.Agent Pt2](reference/api_agent/pydantic_ai.agent_pt2.md) - [Pydantic Ai.Agent Pt3](reference/api_agent/pydantic_ai.agent_pt3.md) - [Pydantic Ai.Agent Pt4](reference/api_agent/pydantic_ai.agent_pt4.md) - [Pydantic Ai.Agent Pt5](reference/api_agent/pydantic_ai.agent_pt5.md) - [Pydantic Ai.Agent Pt6](reference/api_agent/pydantic_ai.agent_pt6.md) - [Pydantic Ai.Agent Pt7](reference/api_agent/pydantic_ai.agent_pt7.md) - [Pydantic Ai.Agent Pt8](reference/api_agent/pydantic_ai.agent_pt8.md) - [Pydantic Ai.Agent Pt9](reference/api_agent/pydantic_ai.agent_pt9.md) - [Table of Contents](reference/api_agent/toc.md) - 📁 **api_builtin_tools/** - [Api Builtin Tools](reference/api_builtin_tools/api_builtin_tools.md) - [`pydantic_ai.builtin_tools`](reference/api_builtin_tools/pydantic_ai.builtin_tools.md) - [Table of Contents](reference/api_builtin_tools/toc.md) - 📁 **api_common_tools/** - [Api Common Tools](reference/api_common_tools/api_common_tools.md) - [`pydantic_ai.common_tools`](reference/api_common_tools/pydantic_ai.common_tools_pt1.md) - [Pydantic Ai.Common Tools Pt2](reference/api_common_tools/pydantic_ai.common_tools_pt2.md) - [Pydantic Ai.Common Tools Pt3](reference/api_common_tools/pydantic_ai.common_tools_pt3.md) - [Table of Contents](reference/api_common_tools/toc.md) - 📁 **api_direct/** - [Api Direct](reference/api_direct/api_direct.md) - [`pydantic_ai.direct`](reference/api_direct/pydantic_ai.direct.md) - [Table of Contents](reference/api_direct/toc.md) - 📁 **api_durable_exec/** - [Api Durable Exec](reference/api_durable_exec/api_durable_exec.md) - [`pydantic_ai.durable_exec`](reference/api_durable_exec/pydantic_ai.durable_exec_pt1.md) - [Pydantic Ai.Durable Exec Pt10](reference/api_durable_exec/pydantic_ai.durable_exec_pt10.md) - [Pydantic Ai.Durable Exec Pt11](reference/api_durable_exec/pydantic_ai.durable_exec_pt11.md) - [Pydantic Ai.Durable Exec Pt12](reference/api_durable_exec/pydantic_ai.durable_exec_pt12.md) - [Pydantic Ai.Durable Exec Pt13](reference/api_durable_exec/pydantic_ai.durable_exec_pt13.md) - [Pydantic Ai.Durable Exec Pt14](reference/api_durable_exec/pydantic_ai.durable_exec_pt14.md) - [Pydantic Ai.Durable Exec Pt15](reference/api_durable_exec/pydantic_ai.durable_exec_pt15.md) - [Pydantic Ai.Durable Exec Pt16](reference/api_durable_exec/pydantic_ai.durable_exec_pt16.md) - [Pydantic Ai.Durable Exec Pt17](reference/api_durable_exec/pydantic_ai.durable_exec_pt17.md) - [Pydantic Ai.Durable Exec Pt18](reference/api_durable_exec/pydantic_ai.durable_exec_pt18.md) - [Pydantic Ai.Durable Exec Pt19](reference/api_durable_exec/pydantic_ai.durable_exec_pt19.md) - [Pydantic Ai.Durable Exec Pt2](reference/api_durable_exec/pydantic_ai.durable_exec_pt2.md) - [Pydantic Ai.Durable Exec Pt20](reference/api_durable_exec/pydantic_ai.durable_exec_pt20.md) - [Pydantic Ai.Durable Exec Pt21](reference/api_durable_exec/pydantic_ai.durable_exec_pt21.md) - [Pydantic Ai.Durable Exec Pt22](reference/api_durable_exec/pydantic_ai.durable_exec_pt22.md) - [Pydantic Ai.Durable Exec Pt23](reference/api_durable_exec/pydantic_ai.durable_exec_pt23.md) - [Pydantic Ai.Durable Exec Pt3](reference/api_durable_exec/pydantic_ai.durable_exec_pt3.md) - [Pydantic Ai.Durable Exec Pt4](reference/api_durable_exec/pydantic_ai.durable_exec_pt4.md) - [Pydantic Ai.Durable Exec Pt5](reference/api_durable_exec/pydantic_ai.durable_exec_pt5.md) - [Pydantic Ai.Durable Exec Pt6](reference/api_durable_exec/pydantic_ai.durable_exec_pt6.md) - [Pydantic Ai.Durable Exec Pt7](reference/api_durable_exec/pydantic_ai.durable_exec_pt7.md) - [Pydantic Ai.Durable Exec Pt8](reference/api_durable_exec/pydantic_ai.durable_exec_pt8.md) - [Pydantic Ai.Durable Exec Pt9](reference/api_durable_exec/pydantic_ai.durable_exec_pt9.md) - [Table of Contents](reference/api_durable_exec/toc.md) - 📁 **api_embeddings/** - [Using default AWS credentials](reference/api_embeddings/Using-default-AWS-credentials.md) - [Using explicit credentials](reference/api_embeddings/Using-explicit-credentials_pt1.md) - [Using a model name (downloads from Hugging Face)](reference/api_embeddings/Using-explicit-credentials_pt2.md) - [Using Explicit Credentials Pt3](reference/api_embeddings/Using-explicit-credentials_pt3.md) - [Api Embeddings Pt1](reference/api_embeddings/api_embeddings_pt1.md) - [Api Embeddings Pt2](reference/api_embeddings/api_embeddings_pt2.md) - [Api Embeddings Pt3](reference/api_embeddings/api_embeddings_pt3.md) - [`pydantic_ai.embeddings`](reference/api_embeddings/pydantic_ai.embeddings_pt1.md) - [Pydantic Ai.Embeddings Pt2](reference/api_embeddings/pydantic_ai.embeddings_pt2.md) - [Pydantic Ai.Embeddings Pt3](reference/api_embeddings/pydantic_ai.embeddings_pt3.md) - [Pydantic Ai.Embeddings Pt4](reference/api_embeddings/pydantic_ai.embeddings_pt4.md) - [Pydantic Ai.Embeddings Pt5](reference/api_embeddings/pydantic_ai.embeddings_pt5.md) - [Pydantic Ai.Embeddings Pt6](reference/api_embeddings/pydantic_ai.embeddings_pt6.md) - [Pydantic Ai.Embeddings Pt7](reference/api_embeddings/pydantic_ai.embeddings_pt7.md) - [Table of Contents](reference/api_embeddings/toc.md) - 📁 **api_fasta2a/** - [Api Fasta2A Pt1](reference/api_fasta2a/api_fasta2a_pt1.md) - [Api Fasta2A Pt2](reference/api_fasta2a/api_fasta2a_pt2.md) - [Api Fasta2A Pt3](reference/api_fasta2a/api_fasta2a_pt3.md) - [`fasta2a`](reference/api_fasta2a/fasta2a_pt1.md) - [Fasta2A Pt2](reference/api_fasta2a/fasta2a_pt2.md) - [Fasta2A Pt3](reference/api_fasta2a/fasta2a_pt3.md) - [Fasta2A Pt4](reference/api_fasta2a/fasta2a_pt4.md) - [Table of Contents](reference/api_fasta2a/toc.md) - 📁 **api_mcp/** - [Api Mcp](reference/api_mcp/api_mcp.md) - [`pydantic_ai.mcp`](reference/api_mcp/pydantic_ai.mcp_pt1.md) - [Pydantic Ai.Mcp Pt2](reference/api_mcp/pydantic_ai.mcp_pt2.md) - [Pydantic Ai.Mcp Pt3](reference/api_mcp/pydantic_ai.mcp_pt3.md) - [Pydantic Ai.Mcp Pt4](reference/api_mcp/pydantic_ai.mcp_pt4.md) - [Table of Contents](reference/api_mcp/toc.md) - 📁 **api_messages/** - [Api Messages Pt1](reference/api_messages/api_messages_pt1.md) - [Api Messages Pt2](reference/api_messages/api_messages_pt2.md) - [Api Messages Pt3](reference/api_messages/api_messages_pt3.md) - [`pydantic_ai.messages`](reference/api_messages/pydantic_ai.messages_pt1.md) - [Pydantic Ai.Messages Pt2](reference/api_messages/pydantic_ai.messages_pt2.md) - [Pydantic Ai.Messages Pt3](reference/api_messages/pydantic_ai.messages_pt3.md) - [Pydantic Ai.Messages Pt4](reference/api_messages/pydantic_ai.messages_pt4.md) - [Pydantic Ai.Messages Pt5](reference/api_messages/pydantic_ai.messages_pt5.md) - [Pydantic Ai.Messages Pt6](reference/api_messages/pydantic_ai.messages_pt6.md) - [Pydantic Ai.Messages Pt7](reference/api_messages/pydantic_ai.messages_pt7.md) - [Table of Contents](reference/api_messages/toc.md) - 📁 **api_models_anthropic/** - [Setup Pt1](reference/api_models_anthropic/Setup_pt1.md) - [Setup Pt2](reference/api_models_anthropic/Setup_pt2.md) - [Setup Pt3](reference/api_models_anthropic/Setup_pt3.md) - [Setup Pt4](reference/api_models_anthropic/Setup_pt4.md) - [Api Models Anthropic](reference/api_models_anthropic/api_models_anthropic.md) - [`pydantic_ai.models.anthropic`](reference/api_models_anthropic/pydantic_ai.models.anthropic.md) - [Table of Contents](reference/api_models_anthropic/toc.md) - 📁 **api_models_base/** - [Api Models Base](reference/api_models_base/api_models_base.md) - [`pydantic_ai.models`](reference/api_models_base/pydantic_ai.models_pt1.md) - [Pydantic Ai.Models Pt2](reference/api_models_base/pydantic_ai.models_pt2.md) - [Pydantic Ai.Models Pt3](reference/api_models_base/pydantic_ai.models_pt3.md) - [Table of Contents](reference/api_models_base/toc.md) - 📁 **api_models_bedrock/** - [Setup Pt1](reference/api_models_bedrock/Setup_pt1.md) - [Setup Pt2](reference/api_models_bedrock/Setup_pt2.md) - [Setup Pt3](reference/api_models_bedrock/Setup_pt3.md) - [Api Models Bedrock](reference/api_models_bedrock/api_models_bedrock.md) - [`pydantic_ai.models.bedrock`](reference/api_models_bedrock/pydantic_ai.models.bedrock.md) - [Table of Contents](reference/api_models_bedrock/toc.md) - 📁 **api_models_google/** - [Setup Pt1](reference/api_models_google/Setup_pt1.md) - [Setup Pt2](reference/api_models_google/Setup_pt2.md) - [Setup Pt3](reference/api_models_google/Setup_pt3.md) - [Api Models Google](reference/api_models_google/api_models_google.md) - [`pydantic_ai.models.google`](reference/api_models_google/pydantic_ai.models.google.md) - [Table of Contents](reference/api_models_google/toc.md) - 📁 **api_models_groq/** - [Api Models Groq](reference/api_models_groq/api_models_groq.md) - [`pydantic_ai.models.groq`](reference/api_models_groq/pydantic_ai.models.groq.md) - [Table of Contents](reference/api_models_groq/toc.md) - 📁 **api_models_instrumented/** - [Api Models Instrumented](reference/api_models_instrumented/api_models_instrumented.md) - [pydantic_ai.models.instrumented](reference/api_models_instrumented/pydantic_ai.models.instrumented.md) - [Table of Contents](reference/api_models_instrumented/toc.md) - 📁 **api_models_mistral/** - [Api Models Mistral](reference/api_models_mistral/api_models_mistral.md) - [`pydantic_ai.models.mistral`](reference/api_models_mistral/pydantic_ai.models.mistral.md) - [Table of Contents](reference/api_models_mistral/toc.md) - 📁 **api_models_openai/** - [Setup Pt1](reference/api_models_openai/Setup_pt1.md) - [Setup Pt2](reference/api_models_openai/Setup_pt2.md) - [Setup Pt3](reference/api_models_openai/Setup_pt3.md) - [Setup Pt4](reference/api_models_openai/Setup_pt4.md) - [Setup Pt5](reference/api_models_openai/Setup_pt5.md) - [Setup Pt6](reference/api_models_openai/Setup_pt6.md) - [Setup Pt7](reference/api_models_openai/Setup_pt7.md) - [Api Models Openai](reference/api_models_openai/api_models_openai.md) - [`pydantic_ai.models.openai`](reference/api_models_openai/pydantic_ai.models.openai.md) - [Table of Contents](reference/api_models_openai/toc.md) - 📁 **api_models_outlines/** - [Api Models Outlines](reference/api_models_outlines/api_models_outlines.md) - [`pydantic_ai.models.outlines`](reference/api_models_outlines/pydantic_ai.models.outlines.md) - [Table of Contents](reference/api_models_outlines/toc.md) - 📁 **api_models_xai/** - [Api Models Xai](reference/api_models_xai/api_models_xai.md) - [`pydantic_ai.models.xai`](reference/api_models_xai/pydantic_ai.models.xai.md) - [Table of Contents](reference/api_models_xai/toc.md) - 📁 **api_profiles/** - [Api Profiles](reference/api_profiles/api_profiles.md) - [`pydantic_ai.profiles`](reference/api_profiles/pydantic_ai.profiles.md) - [Table of Contents](reference/api_profiles/toc.md) - 📁 **api_providers/** - [Api Providers](reference/api_providers/api_providers.md) - [`pydantic_ai.providers`](reference/api_providers/pydantic_ai.providers_pt1.md) - [Pydantic Ai.Providers Pt2](reference/api_providers/pydantic_ai.providers_pt2.md) - [Pydantic Ai.Providers Pt3](reference/api_providers/pydantic_ai.providers_pt3.md) - [Pydantic Ai.Providers Pt4](reference/api_providers/pydantic_ai.providers_pt4.md) - [Pydantic Ai.Providers Pt5](reference/api_providers/pydantic_ai.providers_pt5.md) - [Pydantic Ai.Providers Pt6](reference/api_providers/pydantic_ai.providers_pt6.md) - [Pydantic Ai.Providers Pt7](reference/api_providers/pydantic_ai.providers_pt7.md) - [Table of Contents](reference/api_providers/toc.md) - 📁 **api_pydantic_evals_dataset/** - [Api Pydantic Evals Dataset](reference/api_pydantic_evals_dataset/api_pydantic_evals_dataset.md) - [`pydantic_evals.dataset`](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt1.md) - [Pydantic Evals.Dataset Pt2](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt2.md) - [Pydantic Evals.Dataset Pt3](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt3.md) - [Pydantic Evals.Dataset Pt4](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt4.md) - [Pydantic Evals.Dataset Pt5](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt5.md) - [Table of Contents](reference/api_pydantic_evals_dataset/toc.md) - 📁 **api_pydantic_evals_evaluators/** - [Api Pydantic Evals Evaluators](reference/api_pydantic_evals_evaluators/api_pydantic_evals_evaluators.md) - [`pydantic_evals.evaluators`](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt1.md) - [Pydantic Evals.Evaluators Pt2](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt2.md) - [Pydantic Evals.Evaluators Pt3](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt3.md) - [Pydantic Evals.Evaluators Pt4](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt4.md) - [Table of Contents](reference/api_pydantic_evals_evaluators/toc.md) - 📁 **api_pydantic_evals_reporting/** - [Api Pydantic Evals Reporting](reference/api_pydantic_evals_reporting/api_pydantic_evals_reporting.md) - [`pydantic_evals.reporting`](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt1.md) - [Pydantic Evals.Reporting Pt2](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt2.md) - [Pydantic Evals.Reporting Pt3](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt3.md) - [Pydantic Evals.Reporting Pt4](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt4.md) - [Pydantic Evals.Reporting Pt5](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt5.md) - [Pydantic Evals.Reporting Pt6](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt6.md) - [Table of Contents](reference/api_pydantic_evals_reporting/toc.md) - 📁 **api_pydantic_graph_beta/** - [Api Pydantic Graph Beta](reference/api_pydantic_graph_beta/api_pydantic_graph_beta.md) - [`pydantic_graph.beta`](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt1.md) - [Pydantic Graph.Beta Pt2](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt2.md) - [Pydantic Graph.Beta Pt3](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt3.md) - [Pydantic Graph.Beta Pt4](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt4.md) - [Table of Contents](reference/api_pydantic_graph_beta/toc.md) - 📁 **api_pydantic_graph_beta_decision/** - [Api Pydantic Graph Beta Decision](reference/api_pydantic_graph_beta_decision/api_pydantic_graph_beta_decision.md) - [`pydantic_graph.beta.decision`](reference/api_pydantic_graph_beta_decision/pydantic_graph.beta.decision.md) - [Table of Contents](reference/api_pydantic_graph_beta_decision/toc.md) - 📁 **api_pydantic_graph_beta_graph/** - [Api Pydantic Graph Beta Graph](reference/api_pydantic_graph_beta_graph/api_pydantic_graph_beta_graph.md) - [`pydantic_graph.beta.graph`](reference/api_pydantic_graph_beta_graph/pydantic_graph.beta.graph_pt1.md) - [Pydantic Graph.Beta.Graph Pt2](reference/api_pydantic_graph_beta_graph/pydantic_graph.beta.graph_pt2.md) - [Pydantic Graph.Beta.Graph Pt3](reference/api_pydantic_graph_beta_graph/pydantic_graph.beta.graph_pt3.md) - [Table of Contents](reference/api_pydantic_graph_beta_graph/toc.md) - 📁 **api_pydantic_graph_beta_graph_builder/** - [Api Pydantic Graph Beta Graph Builder](reference/api_pydantic_graph_beta_graph_builder/api_pydantic_graph_beta_graph_builder.md) - [`pydantic_graph.beta.graph_builder`](reference/api_pydantic_graph_beta_graph_builder/pydantic_graph.beta.graph_builder_pt1.md) - [Pydantic Graph.Beta.Graph Builder Pt2](reference/api_pydantic_graph_beta_graph_builder/pydantic_graph.beta.graph_builder_pt2.md) - [Pydantic Graph.Beta.Graph Builder Pt3](reference/api_pydantic_graph_beta_graph_builder/pydantic_graph.beta.graph_builder_pt3.md) - [Table of Contents](reference/api_pydantic_graph_beta_graph_builder/toc.md) - 📁 **api_pydantic_graph_graph/** - [Api Pydantic Graph Graph](reference/api_pydantic_graph_graph/api_pydantic_graph_graph.md) - [`pydantic_graph`](reference/api_pydantic_graph_graph/pydantic_graph_pt1.md) - [Pydantic Graph Pt2](reference/api_pydantic_graph_graph/pydantic_graph_pt2.md) - [Pydantic Graph Pt3](reference/api_pydantic_graph_graph/pydantic_graph_pt3.md) - [Pydantic Graph Pt4](reference/api_pydantic_graph_graph/pydantic_graph_pt4.md) - [Pydantic Graph Pt5](reference/api_pydantic_graph_graph/pydantic_graph_pt5.md) - [Table of Contents](reference/api_pydantic_graph_graph/toc.md) - 📁 **api_pydantic_graph_persistence/** - [Api Pydantic Graph Persistence](reference/api_pydantic_graph_persistence/api_pydantic_graph_persistence.md) - [`pydantic_graph.persistence`](reference/api_pydantic_graph_persistence/pydantic_graph.persistence.md) - [Table of Contents](reference/api_pydantic_graph_persistence/toc.md) - 📁 **api_result/** - [Api Result](reference/api_result/api_result.md) - [`pydantic_ai.result`](reference/api_result/pydantic_ai.result_pt1.md) - [Pydantic Ai.Result Pt2](reference/api_result/pydantic_ai.result_pt2.md) - [Pydantic Ai.Result Pt3](reference/api_result/pydantic_ai.result_pt3.md) - [Table of Contents](reference/api_result/toc.md) - 📁 **api_run/** - [Api Run](reference/api_run/api_run.md) - [`pydantic_ai.run`](reference/api_run/pydantic_ai.run.md) - [Table of Contents](reference/api_run/toc.md) - 📁 **api_tools/** - [Api Tools](reference/api_tools/api_tools.md) - [`pydantic_ai.tools`](reference/api_tools/pydantic_ai.tools_pt1.md) - [Pydantic Ai.Tools Pt2](reference/api_tools/pydantic_ai.tools_pt2.md) - [Pydantic Ai.Tools Pt3](reference/api_tools/pydantic_ai.tools_pt3.md) - [Table of Contents](reference/api_tools/toc.md) - 📁 **api_toolsets/** - [Api Toolsets](reference/api_toolsets/api_toolsets.md) - [`pydantic_ai.toolsets`](reference/api_toolsets/pydantic_ai.toolsets_pt1.md) - [Pydantic Ai.Toolsets Pt2](reference/api_toolsets/pydantic_ai.toolsets_pt2.md) - [Pydantic Ai.Toolsets Pt3](reference/api_toolsets/pydantic_ai.toolsets_pt3.md) - [Pydantic Ai.Toolsets Pt4](reference/api_toolsets/pydantic_ai.toolsets_pt4.md) - [Pydantic Ai.Toolsets Pt5](reference/api_toolsets/pydantic_ai.toolsets_pt5.md) - [Table of Contents](reference/api_toolsets/toc.md) - 📁 **api_ui_ag_ui/** - [Api Ui Ag Ui](reference/api_ui_ag_ui/api_ui_ag_ui.md) - [`pydantic_ai.ui.ag_ui`](reference/api_ui_ag_ui/pydantic_ai.ui.ag_ui_pt1.md) - [Pydantic Ai.Ui.Ag Ui Pt2](reference/api_ui_ag_ui/pydantic_ai.ui.ag_ui_pt2.md) - [Pydantic Ai.Ui.Ag Ui Pt3](reference/api_ui_ag_ui/pydantic_ai.ui.ag_ui_pt3.md) - [Table of Contents](reference/api_ui_ag_ui/toc.md) - 📁 **api_ui_base/** - [Api Ui Base](reference/api_ui_base/api_ui_base.md) - [`pydantic_ai.ui`](reference/api_ui_base/pydantic_ai.ui_pt1.md) - [Pydantic Ai.Ui Pt2](reference/api_ui_base/pydantic_ai.ui_pt2.md) - [Pydantic Ai.Ui Pt3](reference/api_ui_base/pydantic_ai.ui_pt3.md) - [Pydantic Ai.Ui Pt4](reference/api_ui_base/pydantic_ai.ui_pt4.md) - [Pydantic Ai.Ui Pt5](reference/api_ui_base/pydantic_ai.ui_pt5.md) - [Pydantic Ai.Ui Pt6](reference/api_ui_base/pydantic_ai.ui_pt6.md) - [Table of Contents](reference/api_ui_base/toc.md) - 📁 **api_ui_vercel_ai/** - [Api Ui Vercel Ai](reference/api_ui_vercel_ai/api_ui_vercel_ai.md) - [`pydantic_ai.ui.vercel_ai`](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt1.md) - [Pydantic Ai.Ui.Vercel Ai Pt2](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt2.md) - [Pydantic Ai.Ui.Vercel Ai Pt3](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt3.md) - [Pydantic Ai.Ui.Vercel Ai Pt4](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt4.md) - [Pydantic Ai.Ui.Vercel Ai Pt5](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt5.md) - [Table of Contents](reference/api_ui_vercel_ai/toc.md) - 📁 **api_usage/** - [Api Usage](reference/api_usage/api_usage.md) - [`pydantic_ai.usage`](reference/api_usage/pydantic_ai.usage.md) - [Table of Contents](reference/api_usage/toc.md) - 📁 **builtin-tools/** - [Built-in Tools](reference/builtin-tools/Built-in-Tools.md) - [Run with location](reference/builtin-tools/Run-with-location.md) - [Run without location (tool will be omitted)](reference/builtin-tools/Run-without-location-tool-will-be-omitted.md) - [Builtin Tools](reference/builtin-tools/builtin-tools.md) - [Table of Contents](reference/builtin-tools/toc.md) - 📁 **changelog/** - 📁 **Upgrade-Guide/** - [Breaking Changes](reference/changelog/Upgrade-Guide/Breaking-Changes.md) - [Full Changelog Pt1](reference/changelog/Full-Changelog_pt1.md) - [Full Changelog Pt2](reference/changelog/Full-Changelog_pt2.md) - [Full Changelog Pt3](reference/changelog/Full-Changelog_pt3.md) - [Full Changelog Pt4](reference/changelog/Full-Changelog_pt4.md) - [Upgrade Guide](reference/changelog/Upgrade-Guide.md) - [Changelog](reference/changelog/changelog.md) - [Table of Contents](reference/changelog/toc.md) - 📁 **graph/** - [Graphs](reference/graph/Graphs.md) - [Graph](reference/graph/graph.md) - [Table of Contents](reference/graph/toc.md) - 📁 **output/** - 📁 **Output/** - [Examples](reference/output/Output/Examples.md) - [Image Output](reference/output/Output/Image-output.md) - [Streamed Results](reference/output/Output/Streamed-Results.md) - [Structured Output Data](reference/output/Output/Structured-output-data.md) - [Output](reference/output/Output.md) - [Output](reference/output/output.md) - [Table of Contents](reference/output/toc.md) - 📁 **toolsets/** - [...](reference/toolsets/....md) - [Toolsets](reference/toolsets/Toolsets.md) - [Table of Contents](reference/toolsets/toc.md) - [Toolsets](reference/toolsets/toolsets.md) - [Agents](reference/AGENTS.md) - [Claude](reference/CLAUDE.md) - [A2A](reference/a2a.md) - [Api Concurrency](reference/api_concurrency.md) - [Api Exceptions](reference/api_exceptions.md) - [Api Ext](reference/api_ext.md) - [Api Format Prompt](reference/api_format_prompt.md) - [Api Models Function](reference/api_models_function.md) - [Api Models Huggingface](reference/api_models_huggingface.md) - [Api Models Mcp Sampling](reference/api_models_mcp-sampling.md) - [Api Models Openrouter](reference/api_models_openrouter.md) - [Api Models Test](reference/api_models_test.md) - [Api Models Wrapper](reference/api_models_wrapper.md) - [Api Output](reference/api_output.md) - [Api Pydantic Evals Generation](reference/api_pydantic_evals_generation.md) - [Api Pydantic Graph Beta Join](reference/api_pydantic_graph_beta_join.md) - [Api Pydantic Graph Beta Node](reference/api_pydantic_graph_beta_node.md) - [Api Pydantic Graph Beta Step](reference/api_pydantic_graph_beta_step.md) - [Api Pydantic Graph Exceptions](reference/api_pydantic_graph_exceptions.md) - [Api Pydantic Graph Mermaid](reference/api_pydantic_graph_mermaid.md) - [Api Pydantic Graph Nodes](reference/api_pydantic_graph_nodes.md) - [Api Retries](reference/api_retries.md) - [Api Settings](reference/api_settings.md) - [Cli](reference/cli.md) - [Common Tools](reference/common-tools.md) - [Contributing](reference/contributing.md) - [Deferred Tools](reference/deferred-tools.md) - [Dependencies](reference/dependencies.md) - [Direct](reference/direct.md) - [Durable Execution Dbos](reference/durable_execution_dbos.md) - [Durable Execution Overview](reference/durable_execution_overview.md) - [Durable Execution Prefect](reference/durable_execution_prefect.md) - [Durable Execution Temporal](reference/durable_execution_temporal.md) - [Embeddings](reference/embeddings.md) - [Evals](reference/evals.md) - [Evals Core Concepts](reference/evals_core-concepts.md) - [Evals Evaluators Built In](reference/evals_evaluators_built-in.md) - [Evals Evaluators Custom](reference/evals_evaluators_custom.md) - [Evals Evaluators Llm Judge](reference/evals_evaluators_llm-judge.md) - [Evals Evaluators Overview](reference/evals_evaluators_overview.md) - [Evals Evaluators Report Evaluators](reference/evals_evaluators_report-evaluators.md) - [Evals Evaluators Span Based](reference/evals_evaluators_span-based.md) - [Evals Examples Simple Validation](reference/evals_examples_simple-validation.md) - [Evals How To Concurrency](reference/evals_how-to_concurrency.md) - [Evals How To Dataset Management](reference/evals_how-to_dataset-management.md) - [Evals How To Dataset Serialization](reference/evals_how-to_dataset-serialization.md) - [Evals How To Logfire Integration](reference/evals_how-to_logfire-integration.md) - [Evals How To Metrics Attributes](reference/evals_how-to_metrics-attributes.md) - [Evals How To Multi Run](reference/evals_how-to_multi-run.md) - [Evals How To Retry Strategies](reference/evals_how-to_retry-strategies.md) - [Evals Quick Start](reference/evals_quick-start.md) - [Examples Ag Ui](reference/examples_ag-ui.md) - [Examples Bank Support](reference/examples_bank-support.md) - [Examples Chat App](reference/examples_chat-app.md) - [Examples Data Analyst](reference/examples_data-analyst.md) - [Examples Flight Booking](reference/examples_flight-booking.md) - [Examples Pydantic Model](reference/examples_pydantic-model.md) - [Examples Question Graph](reference/examples_question-graph.md) - [Examples Rag](reference/examples_rag.md) - [Examples Setup](reference/examples_setup.md) - [Examples Slack Lead Qualifier](reference/examples_slack-lead-qualifier.md) - [Examples Sql Gen](reference/examples_sql-gen.md) - [Examples Stream Markdown](reference/examples_stream-markdown.md) - [Examples Stream Whales](reference/examples_stream-whales.md) - [Examples Weather Agent](reference/examples_weather-agent.md) - [Gateway](reference/gateway.md) - [Graph Beta](reference/graph_beta.md) - [Graph Beta Decisions](reference/graph_beta_decisions.md) - [Graph Beta Joins](reference/graph_beta_joins.md) - [Graph Beta Parallel](reference/graph_beta_parallel.md) - [Graph Beta Steps](reference/graph_beta_steps.md) - [Help](reference/help.md) - [Index](reference/index.md) - [Input](reference/input.md) - [Install](reference/install.md) - [Logfire](reference/logfire.md) - [Mcp Client](reference/mcp_client.md) - [Mcp Fastmcp Client](reference/mcp_fastmcp-client.md) - [Mcp Overview](reference/mcp_overview.md) - [Mcp Server](reference/mcp_server.md) - [Message History](reference/message-history.md) - [Models Anthropic](reference/models_anthropic.md) - [Models Bedrock](reference/models_bedrock.md) - [Models Cerebras](reference/models_cerebras.md) - [Models Cohere](reference/models_cohere.md) - [Models Google](reference/models_google.md) - [Models Groq](reference/models_groq.md) - [Models Mistral](reference/models_mistral.md) - [Models Openai](reference/models_openai.md) - [Models Openrouter](reference/models_openrouter.md) - [Models Outlines](reference/models_outlines.md) - [Models Overview](reference/models_overview.md) - [Models Xai](reference/models_xai.md) - [Multi Agent Applications](reference/multi-agent-applications.md) - [Retries](reference/retries.md) - [Testing](reference/testing.md) - [Thinking](reference/thinking.md) - [Third Party Tools](reference/third-party-tools.md) - [Tools Advanced](reference/tools-advanced.md) - [Tools](reference/tools.md) - [Troubleshooting](reference/troubleshooting.md) - [Ui Ag Ui](reference/ui_ag-ui.md) - [Ui Overview](reference/ui_overview.md) - [Ui Vercel Ai](reference/ui_vercel-ai.md) - [Version Policy](reference/version-policy.md) - [Web](reference/web.md) ## 🤖 Agent Usage Guide - When the user asks anything about **Pydantic Ai Docs**, consult the reference files. - Prefer exact quotes and direct links to the relevant file/section. - The hierarchical TOC above makes navigation fast and intuitive. - All images and assets are preserved so links work perfectly.