# 探索LangChain在不同Pydantic版本中的应用：突破与挑战
## 引言
Pydantic v2于2023年6月发布，带来了大量的变更[参考文档](https://docs.pydantic.dev/2.0/blog/pydantic-v2-final/)。然而，这些变更可能会影响到依赖Pydantic的项目，如LangChain。本文旨在帮助开发者了解如何在项目中使用不同版本的Pydantic，尤其是在LangChain中的应用。
## 主要内容
### LangChain与Pydantic的兼容性
LangChain从`0.0.267`版本开始允许用户安装Pydantic V1或V2。然而，LangChain内部仍依赖Pydantic V1，通过v2的v1命名空间使用。对于用户来说，需要特别注意混用v1和v2对象可能带来的问题。
### 如何将Pydantic对象传递给LangChain API
大多数LangChain的API已经更新，以便接受Pydantic V1或V2对象。开发者可以根据自己使用的Pydantic版本选择合适的API调用方式。例如，在LangChain核心版本`>=0.2.23`后，API可以接受两种版本的对象。
### 子类化LangChain模型
由于LangChain内部使用Pydantic V1，如果您正在子类化LangChain模型，应该使用V1的基础模型。混用不同版本的Pydantic基类可能会导致难以排查的错误。
### 在Pydantic V2模型中禁用运行时验证
如果在Pydantic V2中使用LangChain对象（如`ChatOpenAI`），可以通过使用`SkipValidation`来禁用运行时验证。
### 使用LangServe生成OpenAPI文档
在使用Pydantic 2时，LangServe无法生成OpenAPI文档。如果需要此功能，可以选择安装Pydantic 1或手动创建API路径。
## 代码示例
### 实例：将Pydantic对象传递给LangChain API
```python
# 使用 API 代理服务提高访问稳定性
from langchain_openai import ChatOpenAI
from pydantic.v1 import BaseModel # 使用v1命名空间
class Person(BaseModel):
"""个人信息"""
name: str
model = ChatOpenAI()
model = model.with_structured_output(Person)
model.invoke('Bob is a person.')
常见问题和解决方案
-
混用Pydantic版本导致错误：确保在使用LangChain时，子类化和对象传递都使用相同版本的Pydantic。
-
无法生成OpenAPI文档：考虑使用Pydantic 1，或者使用LangChain的APIHandler手动生成API路径。
总结和进一步学习资源
随着Pydantic版本的升级，开发者需要灵活调整项目中的依赖版本。适应这些变化不仅能够保证项目的稳定性，也有助于利用最新的功能提升开发效率。更多关于LangChain的使用，可以查阅LangChain文档。
参考资料
如果这篇文章对你有帮助，欢迎点赞并关注我的博客。您的支持是我持续创作的动力！
---END---
