File contents 1 --- 2 name: pydantic-ai-docs 3 description: Comprehensive reference documentation for Pydantic Ai Docs. 4 --- 5 6 # Pydantic Ai Docs Documentation 7 8 Comprehensive reference documentation for Pydantic Ai Docs. 9 10 **Original Sources**: 11 - [https://ai.pydantic.dev](https://ai.pydantic.dev) 12 13 **Contains**: 407 markdown files with full folder structure (crawled at depth 3). 14 *Last updated: March 07, 2026* 15 16 ## 📚 Table of Contents 17 18 - 📁 **agent/** 19 - [1. Model-level defaults](reference/agent/1.-Model-level-defaults.md) 20 - [2. Agent-level defaults (overrides model defaults by merging)](reference/agent/2.-Agent-level-defaults-overrides-model-defaults-by-merging.md) 21 - [3. Run-time overrides (highest priority)](reference/agent/3.-Run-time-overrides-highest-priority.md) 22 - [Agents](reference/agent/Agents.md) 23 - [First run](reference/agent/First-run.md) 24 - [Run the agent](reference/agent/Run-the-agent.md) 25 - [Second run, passing previous messages](reference/agent/Second-run-passing-previous-messages.md) 26 - [Simple limit: allow up to 10 concurrent runs](reference/agent/Simple-limit-allow-up-to-10-concurrent-runs.md) 27 - [With backpressure: limit concurrent runs and queue depth](reference/agent/With-backpressure-limit-concurrent-runs-and-queue-depth.md) 28 - [Agent](reference/agent/agent.md) 29 - [Table of Contents](reference/agent/toc.md) 30 - 📁 **api_ag_ui/** 31 - [Api Ag Ui](reference/api_ag_ui/api_ag_ui.md) 32 - [`pydantic_ai.ag_ui`](reference/api_ag_ui/pydantic_ai.ag_ui.md) 33 - [Table of Contents](reference/api_ag_ui/toc.md) 34 - 📁 **api_agent/** 35 - [Or provide additional models for UI selection](reference/api_agent/Or-provide-additional-models-for-UI-selection.md) 36 - [Simple usage - uses agent's model and builtin tools](reference/api_agent/Simple-usage---uses-agents-model-and-builtin-tools.md) 37 - [Then run with: uvicorn app:app --reload](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt1.md) 38 - [Then Run With Uvicorn Appapp Reload Pt10](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt10.md) 39 - [Then Run With Uvicorn Appapp Reload Pt11](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt11.md) 40 - [Then Run With Uvicorn Appapp Reload Pt12](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt12.md) 41 - [Then Run With Uvicorn Appapp Reload Pt13](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt13.md) 42 - [Then Run With Uvicorn Appapp Reload Pt14](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt14.md) 43 - [Then Run With Uvicorn Appapp Reload Pt15](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt15.md) 44 - [Then Run With Uvicorn Appapp Reload Pt16](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt16.md) 45 - [Then Run With Uvicorn Appapp Reload Pt2](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt2.md) 46 - [Then Run With Uvicorn Appapp Reload Pt3](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt3.md) 47 - [Then Run With Uvicorn Appapp Reload Pt4](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt4.md) 48 - [Then Run With Uvicorn Appapp Reload Pt5](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt5.md) 49 - [Then Run With Uvicorn Appapp Reload Pt6](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt6.md) 50 - [Then Run With Uvicorn Appapp Reload Pt7](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt7.md) 51 - [Then Run With Uvicorn Appapp Reload Pt8](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt8.md) 52 - [Then Run With Uvicorn Appapp Reload Pt9](reference/api_agent/Then-run-with-uvicorn-appapp---reload_pt9.md) 53 - [Api Agent](reference/api_agent/api_agent.md) 54 - [`pydantic_ai.agent`](reference/api_agent/pydantic_ai.agent_pt1.md) 55 - [Pydantic Ai.Agent Pt10](reference/api_agent/pydantic_ai.agent_pt10.md) 56 - [Pydantic Ai.Agent Pt2](reference/api_agent/pydantic_ai.agent_pt2.md) 57 - [Pydantic Ai.Agent Pt3](reference/api_agent/pydantic_ai.agent_pt3.md) 58 - [Pydantic Ai.Agent Pt4](reference/api_agent/pydantic_ai.agent_pt4.md) 59 - [Pydantic Ai.Agent Pt5](reference/api_agent/pydantic_ai.agent_pt5.md) 60 - [Pydantic Ai.Agent Pt6](reference/api_agent/pydantic_ai.agent_pt6.md) 61 - [Pydantic Ai.Agent Pt7](reference/api_agent/pydantic_ai.agent_pt7.md) 62 - [Pydantic Ai.Agent Pt8](reference/api_agent/pydantic_ai.agent_pt8.md) 63 - [Pydantic Ai.Agent Pt9](reference/api_agent/pydantic_ai.agent_pt9.md) 64 - [Table of Contents](reference/api_agent/toc.md) 65 - 📁 **api_builtin_tools/** 66 - [Api Builtin Tools](reference/api_builtin_tools/api_builtin_tools.md) 67 - [`pydantic_ai.builtin_tools`](reference/api_builtin_tools/pydantic_ai.builtin_tools.md) 68 - [Table of Contents](reference/api_builtin_tools/toc.md) 69 - 📁 **api_common_tools/** 70 - [Api Common Tools](reference/api_common_tools/api_common_tools.md) 71 - [`pydantic_ai.common_tools`](reference/api_common_tools/pydantic_ai.common_tools_pt1.md) 72 - [Pydantic Ai.Common Tools Pt2](reference/api_common_tools/pydantic_ai.common_tools_pt2.md) 73 - [Pydantic Ai.Common Tools Pt3](reference/api_common_tools/pydantic_ai.common_tools_pt3.md) 74 - [Table of Contents](reference/api_common_tools/toc.md) 75 - 📁 **api_direct/** 76 - [Api Direct](reference/api_direct/api_direct.md) 77 - [`pydantic_ai.direct`](reference/api_direct/pydantic_ai.direct.md) 78 - [Table of Contents](reference/api_direct/toc.md) 79 - 📁 **api_durable_exec/** 80 - [Api Durable Exec](reference/api_durable_exec/api_durable_exec.md) 81 - [`pydantic_ai.durable_exec`](reference/api_durable_exec/pydantic_ai.durable_exec_pt1.md) 82 - [Pydantic Ai.Durable Exec Pt10](reference/api_durable_exec/pydantic_ai.durable_exec_pt10.md) 83 - [Pydantic Ai.Durable Exec Pt11](reference/api_durable_exec/pydantic_ai.durable_exec_pt11.md) 84 - [Pydantic Ai.Durable Exec Pt12](reference/api_durable_exec/pydantic_ai.durable_exec_pt12.md) 85 - [Pydantic Ai.Durable Exec Pt13](reference/api_durable_exec/pydantic_ai.durable_exec_pt13.md) 86 - [Pydantic Ai.Durable Exec Pt14](reference/api_durable_exec/pydantic_ai.durable_exec_pt14.md) 87 - [Pydantic Ai.Durable Exec Pt15](reference/api_durable_exec/pydantic_ai.durable_exec_pt15.md) 88 - [Pydantic Ai.Durable Exec Pt16](reference/api_durable_exec/pydantic_ai.durable_exec_pt16.md) 89 - [Pydantic Ai.Durable Exec Pt17](reference/api_durable_exec/pydantic_ai.durable_exec_pt17.md) 90 - [Pydantic Ai.Durable Exec Pt18](reference/api_durable_exec/pydantic_ai.durable_exec_pt18.md) 91 - [Pydantic Ai.Durable Exec Pt19](reference/api_durable_exec/pydantic_ai.durable_exec_pt19.md) 92 - [Pydantic Ai.Durable Exec Pt2](reference/api_durable_exec/pydantic_ai.durable_exec_pt2.md) 93 - [Pydantic Ai.Durable Exec Pt20](reference/api_durable_exec/pydantic_ai.durable_exec_pt20.md) 94 - [Pydantic Ai.Durable Exec Pt21](reference/api_durable_exec/pydantic_ai.durable_exec_pt21.md) 95 - [Pydantic Ai.Durable Exec Pt22](reference/api_durable_exec/pydantic_ai.durable_exec_pt22.md) 96 - [Pydantic Ai.Durable Exec Pt23](reference/api_durable_exec/pydantic_ai.durable_exec_pt23.md) 97 - [Pydantic Ai.Durable Exec Pt3](reference/api_durable_exec/pydantic_ai.durable_exec_pt3.md) 98 - [Pydantic Ai.Durable Exec Pt4](reference/api_durable_exec/pydantic_ai.durable_exec_pt4.md) 99 - [Pydantic Ai.Durable Exec Pt5](reference/api_durable_exec/pydantic_ai.durable_exec_pt5.md) 100 - [Pydantic Ai.Durable Exec Pt6](reference/api_durable_exec/pydantic_ai.durable_exec_pt6.md) 101 - [Pydantic Ai.Durable Exec Pt7](reference/api_durable_exec/pydantic_ai.durable_exec_pt7.md) 102 - [Pydantic Ai.Durable Exec Pt8](reference/api_durable_exec/pydantic_ai.durable_exec_pt8.md) 103 - [Pydantic Ai.Durable Exec Pt9](reference/api_durable_exec/pydantic_ai.durable_exec_pt9.md) 104 - [Table of Contents](reference/api_durable_exec/toc.md) 105 - 📁 **api_embeddings/** 106 - [Using default AWS credentials](reference/api_embeddings/Using-default-AWS-credentials.md) 107 - [Using explicit credentials](reference/api_embeddings/Using-explicit-credentials_pt1.md) 108 - [Using a model name (downloads from Hugging Face)](reference/api_embeddings/Using-explicit-credentials_pt2.md) 109 - [Using Explicit Credentials Pt3](reference/api_embeddings/Using-explicit-credentials_pt3.md) 110 - [Api Embeddings Pt1](reference/api_embeddings/api_embeddings_pt1.md) 111 - [Api Embeddings Pt2](reference/api_embeddings/api_embeddings_pt2.md) 112 - [Api Embeddings Pt3](reference/api_embeddings/api_embeddings_pt3.md) 113 - [`pydantic_ai.embeddings`](reference/api_embeddings/pydantic_ai.embeddings_pt1.md) 114 - [Pydantic Ai.Embeddings Pt2](reference/api_embeddings/pydantic_ai.embeddings_pt2.md) 115 - [Pydantic Ai.Embeddings Pt3](reference/api_embeddings/pydantic_ai.embeddings_pt3.md) 116 - [Pydantic Ai.Embeddings Pt4](reference/api_embeddings/pydantic_ai.embeddings_pt4.md) 117 - [Pydantic Ai.Embeddings Pt5](reference/api_embeddings/pydantic_ai.embeddings_pt5.md) 118 - [Pydantic Ai.Embeddings Pt6](reference/api_embeddings/pydantic_ai.embeddings_pt6.md) 119 - [Pydantic Ai.Embeddings Pt7](reference/api_embeddings/pydantic_ai.embeddings_pt7.md) 120 - [Table of Contents](reference/api_embeddings/toc.md) 121 - 📁 **api_fasta2a/** 122 - [Api Fasta2A Pt1](reference/api_fasta2a/api_fasta2a_pt1.md) 123 - [Api Fasta2A Pt2](reference/api_fasta2a/api_fasta2a_pt2.md) 124 - [Api Fasta2A Pt3](reference/api_fasta2a/api_fasta2a_pt3.md) 125 - [`fasta2a`](reference/api_fasta2a/fasta2a_pt1.md) 126 - [Fasta2A Pt2](reference/api_fasta2a/fasta2a_pt2.md) 127 - [Fasta2A Pt3](reference/api_fasta2a/fasta2a_pt3.md) 128 - [Fasta2A Pt4](reference/api_fasta2a/fasta2a_pt4.md) 129 - [Table of Contents](reference/api_fasta2a/toc.md) 130 - 📁 **api_mcp/** 131 - [Api Mcp](reference/api_mcp/api_mcp.md) 132 - [`pydantic_ai.mcp`](reference/api_mcp/pydantic_ai.mcp_pt1.md) 133 - [Pydantic Ai.Mcp Pt2](reference/api_mcp/pydantic_ai.mcp_pt2.md) 134 - [Pydantic Ai.Mcp Pt3](reference/api_mcp/pydantic_ai.mcp_pt3.md) 135 - [Pydantic Ai.Mcp Pt4](reference/api_mcp/pydantic_ai.mcp_pt4.md) 136 - [Table of Contents](reference/api_mcp/toc.md) 137 - 📁 **api_messages/** 138 - [Api Messages Pt1](reference/api_messages/api_messages_pt1.md) 139 - [Api Messages Pt2](reference/api_messages/api_messages_pt2.md) 140 - [Api Messages Pt3](reference/api_messages/api_messages_pt3.md) 141 - [`pydantic_ai.messages`](reference/api_messages/pydantic_ai.messages_pt1.md) 142 - [Pydantic Ai.Messages Pt2](reference/api_messages/pydantic_ai.messages_pt2.md) 143 - [Pydantic Ai.Messages Pt3](reference/api_messages/pydantic_ai.messages_pt3.md) 144 - [Pydantic Ai.Messages Pt4](reference/api_messages/pydantic_ai.messages_pt4.md) 145 - [Pydantic Ai.Messages Pt5](reference/api_messages/pydantic_ai.messages_pt5.md) 146 - [Pydantic Ai.Messages Pt6](reference/api_messages/pydantic_ai.messages_pt6.md) 147 - [Pydantic Ai.Messages Pt7](reference/api_messages/pydantic_ai.messages_pt7.md) 148 - [Table of Contents](reference/api_messages/toc.md) 149 - 📁 **api_models_anthropic/** 150 - [Setup Pt1](reference/api_models_anthropic/Setup_pt1.md) 151 - [Setup Pt2](reference/api_models_anthropic/Setup_pt2.md) 152 - [Setup Pt3](reference/api_models_anthropic/Setup_pt3.md) 153 - [Setup Pt4](reference/api_models_anthropic/Setup_pt4.md) 154 - [Api Models Anthropic](reference/api_models_anthropic/api_models_anthropic.md) 155 - [`pydantic_ai.models.anthropic`](reference/api_models_anthropic/pydantic_ai.models.anthropic.md) 156 - [Table of Contents](reference/api_models_anthropic/toc.md) 157 - 📁 **api_models_base/** 158 - [Api Models Base](reference/api_models_base/api_models_base.md) 159 - [`pydantic_ai.models`](reference/api_models_base/pydantic_ai.models_pt1.md) 160 - [Pydantic Ai.Models Pt2](reference/api_models_base/pydantic_ai.models_pt2.md) 161 - [Pydantic Ai.Models Pt3](reference/api_models_base/pydantic_ai.models_pt3.md) 162 - [Table of Contents](reference/api_models_base/toc.md) 163 - 📁 **api_models_bedrock/** 164 - [Setup Pt1](reference/api_models_bedrock/Setup_pt1.md) 165 - [Setup Pt2](reference/api_models_bedrock/Setup_pt2.md) 166 - [Setup Pt3](reference/api_models_bedrock/Setup_pt3.md) 167 - [Api Models Bedrock](reference/api_models_bedrock/api_models_bedrock.md) 168 - [`pydantic_ai.models.bedrock`](reference/api_models_bedrock/pydantic_ai.models.bedrock.md) 169 - [Table of Contents](reference/api_models_bedrock/toc.md) 170 - 📁 **api_models_google/** 171 - [Setup Pt1](reference/api_models_google/Setup_pt1.md) 172 - [Setup Pt2](reference/api_models_google/Setup_pt2.md) 173 - [Setup Pt3](reference/api_models_google/Setup_pt3.md) 174 - [Api Models Google](reference/api_models_google/api_models_google.md) 175 - [`pydantic_ai.models.google`](reference/api_models_google/pydantic_ai.models.google.md) 176 - [Table of Contents](reference/api_models_google/toc.md) 177 - 📁 **api_models_groq/** 178 - [Api Models Groq](reference/api_models_groq/api_models_groq.md) 179 - [`pydantic_ai.models.groq`](reference/api_models_groq/pydantic_ai.models.groq.md) 180 - [Table of Contents](reference/api_models_groq/toc.md) 181 - 📁 **api_models_instrumented/** 182 - [Api Models Instrumented](reference/api_models_instrumented/api_models_instrumented.md) 183 - [pydantic_ai.models.instrumented](reference/api_models_instrumented/pydantic_ai.models.instrumented.md) 184 - [Table of Contents](reference/api_models_instrumented/toc.md) 185 - 📁 **api_models_mistral/** 186 - [Api Models Mistral](reference/api_models_mistral/api_models_mistral.md) 187 - [`pydantic_ai.models.mistral`](reference/api_models_mistral/pydantic_ai.models.mistral.md) 188 - [Table of Contents](reference/api_models_mistral/toc.md) 189 - 📁 **api_models_openai/** 190 - [Setup Pt1](reference/api_models_openai/Setup_pt1.md) 191 - [Setup Pt2](reference/api_models_openai/Setup_pt2.md) 192 - [Setup Pt3](reference/api_models_openai/Setup_pt3.md) 193 - [Setup Pt4](reference/api_models_openai/Setup_pt4.md) 194 - [Setup Pt5](reference/api_models_openai/Setup_pt5.md) 195 - [Setup Pt6](reference/api_models_openai/Setup_pt6.md) 196 - [Setup Pt7](reference/api_models_openai/Setup_pt7.md) 197 - [Api Models Openai](reference/api_models_openai/api_models_openai.md) 198 - [`pydantic_ai.models.openai`](reference/api_models_openai/pydantic_ai.models.openai.md) 199 - [Table of Contents](reference/api_models_openai/toc.md) 200 - 📁 **api_models_outlines/** 201 - [Api Models Outlines](reference/api_models_outlines/api_models_outlines.md) 202 - [`pydantic_ai.models.outlines`](reference/api_models_outlines/pydantic_ai.models.outlines.md) 203 - [Table of Contents](reference/api_models_outlines/toc.md) 204 - 📁 **api_models_xai/** 205 - [Api Models Xai](reference/api_models_xai/api_models_xai.md) 206 - [`pydantic_ai.models.xai`](reference/api_models_xai/pydantic_ai.models.xai.md) 207 - [Table of Contents](reference/api_models_xai/toc.md) 208 - 📁 **api_profiles/** 209 - [Api Profiles](reference/api_profiles/api_profiles.md) 210 - [`pydantic_ai.profiles`](reference/api_profiles/pydantic_ai.profiles.md) 211 - [Table of Contents](reference/api_profiles/toc.md) 212 - 📁 **api_providers/** 213 - [Api Providers](reference/api_providers/api_providers.md) 214 - [`pydantic_ai.providers`](reference/api_providers/pydantic_ai.providers_pt1.md) 215 - [Pydantic Ai.Providers Pt2](reference/api_providers/pydantic_ai.providers_pt2.md) 216 - [Pydantic Ai.Providers Pt3](reference/api_providers/pydantic_ai.providers_pt3.md) 217 - [Pydantic Ai.Providers Pt4](reference/api_providers/pydantic_ai.providers_pt4.md) 218 - [Pydantic Ai.Providers Pt5](reference/api_providers/pydantic_ai.providers_pt5.md) 219 - [Pydantic Ai.Providers Pt6](reference/api_providers/pydantic_ai.providers_pt6.md) 220 - [Pydantic Ai.Providers Pt7](reference/api_providers/pydantic_ai.providers_pt7.md) 221 - [Table of Contents](reference/api_providers/toc.md) 222 - 📁 **api_pydantic_evals_dataset/** 223 - [Api Pydantic Evals Dataset](reference/api_pydantic_evals_dataset/api_pydantic_evals_dataset.md) 224 - [`pydantic_evals.dataset`](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt1.md) 225 - [Pydantic Evals.Dataset Pt2](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt2.md) 226 - [Pydantic Evals.Dataset Pt3](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt3.md) 227 - [Pydantic Evals.Dataset Pt4](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt4.md) 228 - [Pydantic Evals.Dataset Pt5](reference/api_pydantic_evals_dataset/pydantic_evals.dataset_pt5.md) 229 - [Table of Contents](reference/api_pydantic_evals_dataset/toc.md) 230 - 📁 **api_pydantic_evals_evaluators/** 231 - [Api Pydantic Evals Evaluators](reference/api_pydantic_evals_evaluators/api_pydantic_evals_evaluators.md) 232 - [`pydantic_evals.evaluators`](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt1.md) 233 - [Pydantic Evals.Evaluators Pt2](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt2.md) 234 - [Pydantic Evals.Evaluators Pt3](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt3.md) 235 - [Pydantic Evals.Evaluators Pt4](reference/api_pydantic_evals_evaluators/pydantic_evals.evaluators_pt4.md) 236 - [Table of Contents](reference/api_pydantic_evals_evaluators/toc.md) 237 - 📁 **api_pydantic_evals_reporting/** 238 - [Api Pydantic Evals Reporting](reference/api_pydantic_evals_reporting/api_pydantic_evals_reporting.md) 239 - [`pydantic_evals.reporting`](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt1.md) 240 - [Pydantic Evals.Reporting Pt2](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt2.md) 241 - [Pydantic Evals.Reporting Pt3](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt3.md) 242 - [Pydantic Evals.Reporting Pt4](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt4.md) 243 - [Pydantic Evals.Reporting Pt5](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt5.md) 244 - [Pydantic Evals.Reporting Pt6](reference/api_pydantic_evals_reporting/pydantic_evals.reporting_pt6.md) 245 - [Table of Contents](reference/api_pydantic_evals_reporting/toc.md) 246 - 📁 **api_pydantic_graph_beta/** 247 - [Api Pydantic Graph Beta](reference/api_pydantic_graph_beta/api_pydantic_graph_beta.md) 248 - [`pydantic_graph.beta`](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt1.md) 249 - [Pydantic Graph.Beta Pt2](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt2.md) 250 - [Pydantic Graph.Beta Pt3](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt3.md) 251 - [Pydantic Graph.Beta Pt4](reference/api_pydantic_graph_beta/pydantic_graph.beta_pt4.md) 252 - [Table of Contents](reference/api_pydantic_graph_beta/toc.md) 253 - 📁 **api_pydantic_graph_beta_decision/** 254 - [Api Pydantic Graph Beta Decision](reference/api_pydantic_graph_beta_decision/api_pydantic_graph_beta_decision.md) 255 - [`pydantic_graph.beta.decision`](reference/api_pydantic_graph_beta_decision/pydantic_graph.beta.decision.md) 256 - [Table of Contents](reference/api_pydantic_graph_beta_decision/toc.md) 257 - 📁 **api_pydantic_graph_beta_graph/** 258 - [Api Pydantic Graph Beta Graph](reference/api_pydantic_graph_beta_graph/api_pydantic_graph_beta_graph.md) 259 - [`pydantic_graph.beta.graph`](reference/api_pydantic_graph_beta_graph/pydantic_graph.beta.graph_pt1.md) 260 - [Pydantic Graph.Beta.Graph Pt2](reference/api_pydantic_graph_beta_graph/pydantic_graph.beta.graph_pt2.md) 261 - [Pydantic Graph.Beta.Graph Pt3](reference/api_pydantic_graph_beta_graph/pydantic_graph.beta.graph_pt3.md) 262 - [Table of Contents](reference/api_pydantic_graph_beta_graph/toc.md) 263 - 📁 **api_pydantic_graph_beta_graph_builder/** 264 - [Api Pydantic Graph Beta Graph Builder](reference/api_pydantic_graph_beta_graph_builder/api_pydantic_graph_beta_graph_builder.md) 265 - [`pydantic_graph.beta.graph_builder`](reference/api_pydantic_graph_beta_graph_builder/pydantic_graph.beta.graph_builder_pt1.md) 266 - [Pydantic Graph.Beta.Graph Builder Pt2](reference/api_pydantic_graph_beta_graph_builder/pydantic_graph.beta.graph_builder_pt2.md) 267 - [Pydantic Graph.Beta.Graph Builder Pt3](reference/api_pydantic_graph_beta_graph_builder/pydantic_graph.beta.graph_builder_pt3.md) 268 - [Table of Contents](reference/api_pydantic_graph_beta_graph_builder/toc.md) 269 - 📁 **api_pydantic_graph_graph/** 270 - [Api Pydantic Graph Graph](reference/api_pydantic_graph_graph/api_pydantic_graph_graph.md) 271 - [`pydantic_graph`](reference/api_pydantic_graph_graph/pydantic_graph_pt1.md) 272 - [Pydantic Graph Pt2](reference/api_pydantic_graph_graph/pydantic_graph_pt2.md) 273 - [Pydantic Graph Pt3](reference/api_pydantic_graph_graph/pydantic_graph_pt3.md) 274 - [Pydantic Graph Pt4](reference/api_pydantic_graph_graph/pydantic_graph_pt4.md) 275 - [Pydantic Graph Pt5](reference/api_pydantic_graph_graph/pydantic_graph_pt5.md) 276 - [Table of Contents](reference/api_pydantic_graph_graph/toc.md) 277 - 📁 **api_pydantic_graph_persistence/** 278 - [Api Pydantic Graph Persistence](reference/api_pydantic_graph_persistence/api_pydantic_graph_persistence.md) 279 - [`pydantic_graph.persistence`](reference/api_pydantic_graph_persistence/pydantic_graph.persistence.md) 280 - [Table of Contents](reference/api_pydantic_graph_persistence/toc.md) 281 - 📁 **api_result/** 282 - [Api Result](reference/api_result/api_result.md) 283 - [`pydantic_ai.result`](reference/api_result/pydantic_ai.result_pt1.md) 284 - [Pydantic Ai.Result Pt2](reference/api_result/pydantic_ai.result_pt2.md) 285 - [Pydantic Ai.Result Pt3](reference/api_result/pydantic_ai.result_pt3.md) 286 - [Table of Contents](reference/api_result/toc.md) 287 - 📁 **api_run/** 288 - [Api Run](reference/api_run/api_run.md) 289 - [`pydantic_ai.run`](reference/api_run/pydantic_ai.run.md) 290 - [Table of Contents](reference/api_run/toc.md) 291 - 📁 **api_tools/** 292 - [Api Tools](reference/api_tools/api_tools.md) 293 - [`pydantic_ai.tools`](reference/api_tools/pydantic_ai.tools_pt1.md) 294 - [Pydantic Ai.Tools Pt2](reference/api_tools/pydantic_ai.tools_pt2.md) 295 - [Pydantic Ai.Tools Pt3](reference/api_tools/pydantic_ai.tools_pt3.md) 296 - [Table of Contents](reference/api_tools/toc.md) 297 - 📁 **api_toolsets/** 298 - [Api Toolsets](reference/api_toolsets/api_toolsets.md) 299 - [`pydantic_ai.toolsets`](reference/api_toolsets/pydantic_ai.toolsets_pt1.md) 300 - [Pydantic Ai.Toolsets Pt2](reference/api_toolsets/pydantic_ai.toolsets_pt2.md) 301 - [Pydantic Ai.Toolsets Pt3](reference/api_toolsets/pydantic_ai.toolsets_pt3.md) 302 - [Pydantic Ai.Toolsets Pt4](reference/api_toolsets/pydantic_ai.toolsets_pt4.md) 303 - [Pydantic Ai.Toolsets Pt5](reference/api_toolsets/pydantic_ai.toolsets_pt5.md) 304 - [Table of Contents](reference/api_toolsets/toc.md) 305 - 📁 **api_ui_ag_ui/** 306 - [Api Ui Ag Ui](reference/api_ui_ag_ui/api_ui_ag_ui.md) 307 - [`pydantic_ai.ui.ag_ui`](reference/api_ui_ag_ui/pydantic_ai.ui.ag_ui_pt1.md) 308 - [Pydantic Ai.Ui.Ag Ui Pt2](reference/api_ui_ag_ui/pydantic_ai.ui.ag_ui_pt2.md) 309 - [Pydantic Ai.Ui.Ag Ui Pt3](reference/api_ui_ag_ui/pydantic_ai.ui.ag_ui_pt3.md) 310 - [Table of Contents](reference/api_ui_ag_ui/toc.md) 311 - 📁 **api_ui_base/** 312 - [Api Ui Base](reference/api_ui_base/api_ui_base.md) 313 - [`pydantic_ai.ui`](reference/api_ui_base/pydantic_ai.ui_pt1.md) 314 - [Pydantic Ai.Ui Pt2](reference/api_ui_base/pydantic_ai.ui_pt2.md) 315 - [Pydantic Ai.Ui Pt3](reference/api_ui_base/pydantic_ai.ui_pt3.md) 316 - [Pydantic Ai.Ui Pt4](reference/api_ui_base/pydantic_ai.ui_pt4.md) 317 - [Pydantic Ai.Ui Pt5](reference/api_ui_base/pydantic_ai.ui_pt5.md) 318 - [Pydantic Ai.Ui Pt6](reference/api_ui_base/pydantic_ai.ui_pt6.md) 319 - [Table of Contents](reference/api_ui_base/toc.md) 320 - 📁 **api_ui_vercel_ai/** 321 - [Api Ui Vercel Ai](reference/api_ui_vercel_ai/api_ui_vercel_ai.md) 322 - [`pydantic_ai.ui.vercel_ai`](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt1.md) 323 - [Pydantic Ai.Ui.Vercel Ai Pt2](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt2.md) 324 - [Pydantic Ai.Ui.Vercel Ai Pt3](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt3.md) 325 - [Pydantic Ai.Ui.Vercel Ai Pt4](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt4.md) 326 - [Pydantic Ai.Ui.Vercel Ai Pt5](reference/api_ui_vercel_ai/pydantic_ai.ui.vercel_ai_pt5.md) 327 - [Table of Contents](reference/api_ui_vercel_ai/toc.md) 328 - 📁 **api_usage/** 329 - [Api Usage](reference/api_usage/api_usage.md) 330 - [`pydantic_ai.usage`](reference/api_usage/pydantic_ai.usage.md) 331 - [Table of Contents](reference/api_usage/toc.md) 332 - 📁 **builtin-tools/** 333 - [Built-in Tools](reference/builtin-tools/Built-in-Tools.md) 334 - [Run with location](reference/builtin-tools/Run-with-location.md) 335 - [Run without location (tool will be omitted)](reference/builtin-tools/Run-without-location-tool-will-be-omitted.md) 336 - [Builtin Tools](reference/builtin-tools/builtin-tools.md) 337 - [Table of Contents](reference/builtin-tools/toc.md) 338 - 📁 **changelog/** 339 - 📁 **Upgrade-Guide/** 340 - [Breaking Changes](reference/changelog/Upgrade-Guide/Breaking-Changes.md) 341 - [Full Changelog Pt1](reference/changelog/Full-Changelog_pt1.md) 342 - [Full Changelog Pt2](reference/changelog/Full-Changelog_pt2.md) 343 - [Full Changelog Pt3](reference/changelog/Full-Changelog_pt3.md) 344 - [Full Changelog Pt4](reference/changelog/Full-Changelog_pt4.md) 345 - [Upgrade Guide](reference/changelog/Upgrade-Guide.md) 346 - [Changelog](reference/changelog/changelog.md) 347 - [Table of Contents](reference/changelog/toc.md) 348 - 📁 **graph/** 349 - [Graphs](reference/graph/Graphs.md) 350 - [Graph](reference/graph/graph.md) 351 - [Table of Contents](reference/graph/toc.md) 352 - 📁 **output/** 353 - 📁 **Output/** 354 - [Examples](reference/output/Output/Examples.md) 355 - [Image Output](reference/output/Output/Image-output.md) 356 - [Streamed Results](reference/output/Output/Streamed-Results.md) 357 - [Structured Output Data](reference/output/Output/Structured-output-data.md) 358 - [Output](reference/output/Output.md) 359 - [Output](reference/output/output.md) 360 - [Table of Contents](reference/output/toc.md) 361 - 📁 **toolsets/** 362 - [...](reference/toolsets/....md) 363 - [Toolsets](reference/toolsets/Toolsets.md) 364 - [Table of Contents](reference/toolsets/toc.md) 365 - [Toolsets](reference/toolsets/toolsets.md) 366 - [Agents](reference/AGENTS.md) 367 - [Claude](reference/CLAUDE.md) 368 - [A2A](reference/a2a.md) 369 - [Api Concurrency](reference/api_concurrency.md) 370 - [Api Exceptions](reference/api_exceptions.md) 371 - [Api Ext](reference/api_ext.md) 372 - [Api Format Prompt](reference/api_format_prompt.md) 373 - [Api Models Function](reference/api_models_function.md) 374 - [Api Models Huggingface](reference/api_models_huggingface.md) 375 - [Api Models Mcp Sampling](reference/api_models_mcp-sampling.md) 376 - [Api Models Openrouter](reference/api_models_openrouter.md) 377 - [Api Models Test](reference/api_models_test.md) 378 - [Api Models Wrapper](reference/api_models_wrapper.md) 379 - [Api Output](reference/api_output.md) 380 - [Api Pydantic Evals Generation](reference/api_pydantic_evals_generation.md) 381 - [Api Pydantic Graph Beta Join](reference/api_pydantic_graph_beta_join.md) 382 - [Api Pydantic Graph Beta Node](reference/api_pydantic_graph_beta_node.md) 383 - [Api Pydantic Graph Beta Step](reference/api_pydantic_graph_beta_step.md) 384 - [Api Pydantic Graph Exceptions](reference/api_pydantic_graph_exceptions.md) 385 - [Api Pydantic Graph Mermaid](reference/api_pydantic_graph_mermaid.md) 386 - [Api Pydantic Graph Nodes](reference/api_pydantic_graph_nodes.md) 387 - [Api Retries](reference/api_retries.md) 388 - [Api Settings](reference/api_settings.md) 389 - [Cli](reference/cli.md) 390 - [Common Tools](reference/common-tools.md) 391 - [Contributing](reference/contributing.md) 392 - [Deferred Tools](reference/deferred-tools.md) 393 - [Dependencies](reference/dependencies.md) 394 - [Direct](reference/direct.md) 395 - [Durable Execution Dbos](reference/durable_execution_dbos.md) 396 - [Durable Execution Overview](reference/durable_execution_overview.md) 397 - [Durable Execution Prefect](reference/durable_execution_prefect.md) 398 - [Durable Execution Temporal](reference/durable_execution_temporal.md) 399 - [Embeddings](reference/embeddings.md) 400 - [Evals](reference/evals.md) 401 - [Evals Core Concepts](reference/evals_core-concepts.md) 402 - [Evals Evaluators Built In](reference/evals_evaluators_built-in.md) 403 - [Evals Evaluators Custom](reference/evals_evaluators_custom.md) 404 - [Evals Evaluators Llm Judge](reference/evals_evaluators_llm-judge.md) 405 - [Evals Evaluators Overview](reference/evals_evaluators_overview.md) 406 - [Evals Evaluators Report Evaluators](reference/evals_evaluators_report-evaluators.md) 407 - [Evals Evaluators Span Based](reference/evals_evaluators_span-based.md) 408 - [Evals Examples Simple Validation](reference/evals_examples_simple-validation.md) 409 - [Evals How To Concurrency](reference/evals_how-to_concurrency.md) 410 - [Evals How To Dataset Management](reference/evals_how-to_dataset-management.md) 411 - [Evals How To Dataset Serialization](reference/evals_how-to_dataset-serialization.md) 412 - [Evals How To Logfire Integration](reference/evals_how-to_logfire-integration.md) 413 - [Evals How To Metrics Attributes](reference/evals_how-to_metrics-attributes.md) 414 - [Evals How To Multi Run](reference/evals_how-to_multi-run.md) 415 - [Evals How To Retry Strategies](reference/evals_how-to_retry-strategies.md) 416 - [Evals Quick Start](reference/evals_quick-start.md) 417 - [Examples Ag Ui](reference/examples_ag-ui.md) 418 - [Examples Bank Support](reference/examples_bank-support.md) 419 - [Examples Chat App](reference/examples_chat-app.md) 420 - [Examples Data Analyst](reference/examples_data-analyst.md) 421 - [Examples Flight Booking](reference/examples_flight-booking.md) 422 - [Examples Pydantic Model](reference/examples_pydantic-model.md) 423 - [Examples Question Graph](reference/examples_question-graph.md) 424 - [Examples Rag](reference/examples_rag.md) 425 - [Examples Setup](reference/examples_setup.md) 426 - [Examples Slack Lead Qualifier](reference/examples_slack-lead-qualifier.md) 427 - [Examples Sql Gen](reference/examples_sql-gen.md) 428 - [Examples Stream Markdown](reference/examples_stream-markdown.md) 429 - [Examples Stream Whales](reference/examples_stream-whales.md) 430 - [Examples Weather Agent](reference/examples_weather-agent.md) 431 - [Gateway](reference/gateway.md) 432 - [Graph Beta](reference/graph_beta.md) 433 - [Graph Beta Decisions](reference/graph_beta_decisions.md) 434 - [Graph Beta Joins](reference/graph_beta_joins.md) 435 - [Graph Beta Parallel](reference/graph_beta_parallel.md) 436 - [Graph Beta Steps](reference/graph_beta_steps.md) 437 - [Help](reference/help.md) 438 - [Index](reference/index.md) 439 - [Input](reference/input.md) 440 - [Install](reference/install.md) 441 - [Logfire](reference/logfire.md) 442 - [Mcp Client](reference/mcp_client.md) 443 - [Mcp Fastmcp Client](reference/mcp_fastmcp-client.md) 444 - [Mcp Overview](reference/mcp_overview.md) 445 - [Mcp Server](reference/mcp_server.md) 446 - [Message History](reference/message-history.md) 447 - [Models Anthropic](reference/models_anthropic.md) 448 - [Models Bedrock](reference/models_bedrock.md) 449 - [Models Cerebras](reference/models_cerebras.md) 450 - [Models Cohere](reference/models_cohere.md) 451 - [Models Google](reference/models_google.md) 452 - [Models Groq](reference/models_groq.md) 453 - [Models Mistral](reference/models_mistral.md) 454 - [Models Openai](reference/models_openai.md) 455 - [Models Openrouter](reference/models_openrouter.md) 456 - [Models Outlines](reference/models_outlines.md) 457 - [Models Overview](reference/models_overview.md) 458 - [Models Xai](reference/models_xai.md) 459 - [Multi Agent Applications](reference/multi-agent-applications.md) 460 - [Retries](reference/retries.md) 461 - [Testing](reference/testing.md) 462 - [Thinking](reference/thinking.md) 463 - [Third Party Tools](reference/third-party-tools.md) 464 - [Tools Advanced](reference/tools-advanced.md) 465 - [Tools](reference/tools.md) 466 - [Troubleshooting](reference/troubleshooting.md) 467 - [Ui Ag Ui](reference/ui_ag-ui.md) 468 - [Ui Overview](reference/ui_overview.md) 469 - [Ui Vercel Ai](reference/ui_vercel-ai.md) 470 - [Version Policy](reference/version-policy.md) 471 - [Web](reference/web.md) 472 473 ## 🤖 Agent Usage Guide 474 475 - When the user asks anything about **Pydantic Ai Docs**, consult the reference files. 476 - Prefer exact quotes and direct links to the relevant file/section. 477 - The hierarchical TOC above makes navigation fast and intuitive. 478 - All images and assets are preserved so links work perfectly.
commit bbc56a9bdf
Frequently asked questions How do I install the Pydantic AI Docs skill? Run npx skillmds@latest add knuckles-team/pydantic-ai-docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Pydantic AI Docs skill do? Comprehensive reference documentation for Pydantic Ai Docs. It is listed under Docs & Writing on SkillMD.
Is Pydantic AI Docs safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Pydantic AI Docs? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Pydantic AI Docs free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Pydantic AI Docs? Knuckles-Team (@knuckles-team) published this skill. Their other Agent Skills are listed on their SkillMD profile.
Knuckles-Team