使用不同版本的Pydantic集成LangChain：完整指南

最新推荐文章于 2025-09-12 01:39:18 发布

原创

最新推荐文章于 2025-09-12 01:39:18 发布 · 835 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#langchain #java #服务器 #python

# 使用不同版本的Pydantic集成LangChain：完整指南

## 引言

在现代应用开发中，数据验证和结构化输出是至关重要的，Pydantic正是这一领域中的重要工具。随着Pydantic v2的发布和LangChain即将不再支持Pydantic v1，对开发者而言，了解如何在不同版本之间切换和集成尤为必要。本文将详细介绍如何在LangChain中使用不同版本的Pydantic，同时提供实用的代码示例和解决方案。

## 主要内容

### 1. Pydantic版本与LangChain的兼容性

LangChain从版本`0.0.267`开始，允许用户安装Pydantic V1或V2。虽然LangChain内部仍然使用Pydantic V1，但用户可以在某些API中使用Pydantic V2对象。对于大多数API，建议继续使用Pydantic V1，直到LangChain 0.3发布。

### 2. 在LangChain API中传递Pydantic对象

大多数LangChain的工具使用API已更新，可以接受Pydantic v1或v2对象。确保使用适当的Pydantic版本是关键，尤其是在调用诸如`BaseChatModel.bind_tools`等API时。

### 3. 子类化LangChain模型

由于LangChain内部使用Pydantic V1，因此在继承和子类化LangChain模型时，应使用Pydantic V1的基类和方法。混合使用不同版本的Pydantic类可能导致难以调试的错误。

### 4. 禁用Pydantic v2模型中的运行时验证

在Pydantic v2模型中使用LangChain对象时，需要禁用运行时验证以避免不兼容问题。

### 5. 使用LangServe生成OpenAPI文档

如果您使用Pydantic 2，LangServe将不能生成OpenAPI文档。建议安装Pydantic 1或手动使用`APIHandler`对象创建API路由。

## 代码示例

以下是如何在不同版本的Pydantic中使用LangChain的简单例子：

```python
# 示例1：使用Pydantic v1与LangChai