Pydantic
Pydantic 是一个基于 Python 类型提示的数据验证与数据解析库。它允许开发者通过定义数据模型类来声明数据结构，并在运行时自动完成类型检查、数据转换与校验，若数据不符合预期则抛出结构化错误。Pydantic 广泛应用于 API 开发、配置管理和数据处理场景，是 FastAPI 等主流框架的核心依赖之一，具有高性能、易用性强和与 Python 生态深度集成的特点。
核心事实
时间轴 (近 90 天)
在Agent场景中，可用Pydantic的model_validate_json对模型返回字符串做严格解析，字段缺失、类型不符、多余字段会抛出结构化异常，配合model_json_schema()可将schema作为function calling入参声明。
传统结构化输出与重试机制依赖LLM逐token生成文本，再通过解析器提取结构化结果，格式错误时需重试，导致成倍增加token消耗与端到端延迟。
在Pydantic模型定义中使用Field(description=...)为每个字段添加说明，能显著降低模型输出格式错误的概率。
在LLM应用场景中，Pydantic常被用作结构化输出的校验层，模型返回的JSON先经过模型验证再交给下游工具执行。
Pydantic的ValidationError包含每个出错字段的loc（位置路径）、type（错误类型，如missing、int_parsing）和msg（人类可读描述）。
Pydantic错误往往出现在工具调用边界，可以使用model_validate_json配合容错模式，或为可选字段设置默认值来避免整体失败。
Pydantic错误本质上是循环的症状而非原因，它表明Agent收到的数据结构不符合预期。
在 OpenAI Agents SDK 中，可以通过输出结构化模型（如 Pydantic BaseModel）并设置 Agent 的 output_type 来获得结构化输出，返回的 final_output 即为该类型实例。
FastAPI 基于 Starlette 处理 Web 底层（路由、中间件、异步支持），并基于 Pydantic 进行数据校验与序列化。
升级前可将配置改为 extra='ignore' 或 .passthrough()，或同步更新类型定义，以保证平滑过渡。
还有 40 条时间轴事件
全部知识事实 (20)
FastAPI基于Starlette和Pydantic构建，天然支持异步处理，基于ASGI（Asynchronous Server Gateway Interface）
80%已验证FastAPI底层基于Starlette框架
80%已验证Pydantic 是 Python 生态中主流的数据验证库，通过类型注解在运行时强制校验数据结构
75%已验证FastAPI 通过叠加 Pydantic 实现数据验证与类型注解
75%已验证LangGraph中的State通常以TypedDict或Pydantic模型的形式定义
75%已验证Pydantic v2版本使用Rust重写了核心验证逻辑，性能相比v1提升了5-50倍
75%已验证FastAPI内置Pydantic模型，能将Python对象与JSON字符串无缝互转
70%已验证工具错误消息应作为普通工具结果返回给模型，包含平实语言的问题说明和该怎么做，'Do not retry'能阻止模型反复重试无望的调用。
65%已验证模式强制校验通常通过JSON Schema验证、类型系统或专用工具调用拦截层实现，在函数调用参数执行前插入与模型推理解耦的确定性验证步骤
65%已验证Cython 是将 Python 代码编译为 C 扩展的工具
65%已验证Pydantic 基于 Python 类型注解，能在运行时自动完成 JSON 数据的反序列化、类型校验并生成符合 JSON Schema 标准的接口文档
65%已验证MCP Python SDK利用Python的类型注解和Pydantic的Field描述符，通过反射机制自动生成符合规范的JSON Schema
65%已验证LangChain的StructuredTool依赖Pydantic来定义工具的输入参数结构，通过Pydantic BaseModel描述每个参数的类型和含义
65%待验证LangChain的@tool装饰器通过Python的inspect模块提取函数签名，结合Pydantic进行类型验证，生成符合OpenAI Function Calling规范的JSON Schema
85%待验证LangChain的with_structured_output方法在底层将Pydantic模型转换为JSON Schema，注入到模型的system prompt或function calling参数中
85%待验证V3版本引入了强类型的数据类（dataclass）或Pydantic模型来封装每种事件，支持mypy、pyright等类型检查器
80%待验证UV在2024年下半年迅速获得FastAPI、Pydantic等主流开源项目的官方推荐
80%部分验证Pydantic/JSON类型化Schema消除92%的工具调用失败
65%待验证Schema validation 是对数据结构的显式声明和逐项比对，常见实现包括 JSON Schema、Pydantic、Zod、TypeBox 等
60%待验证PyAgent 指基于 Python 构建的 AI Agent 框架，负责将自然语言任务拆解为浏览器操作指令序列并调用 EgoLite 接口执行
60%