迁移

LangChain v0.2 于 2024 年 5 月发布。此版本包含若干破坏性变更和弃用。本文档提供了升级到 0.2.x 版本的指南。

参考

迁移

这份文档将帮助您将代码升级到 LangChain 0.2.x.。为了准备迁移，我们首先建议您执行以下步骤：

安装 langchain-core、langchain 的 0.2.x 版本，并升级你正在使用的其他包到最新版本。（例如 langgraph、langchain-community、langchain-openai 等。）
验证您的代码在新包下能否正常运行（例如，单元测试通过）。
安装 langchain-cli 的最新版本，并使用该工具将代码中使用的旧导入替换为新的导入。（参见下面的说明。）
手动解决任何剩余的弃用警告。
重新运行单元测试。
如果您正在使用 astream_events，请查阅如何迁移到 astream 事件 v2。

升级到新的导入

我们创建了一个工具来帮助您迁移代码。此工具目前仍处于测试阶段，可能无法涵盖所有情况，但我们希望它能帮助您更快地完成代码迁移。

迁移脚本具有以下限制：

它仅限于帮助用户从旧的导入方式迁移到新的导入方式。它不涉及解决其他已弃用的问题。
它无法处理涉及 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

安装

pip install langchain-cli
langchain-cli --version # <-- Make sure the version is at least 0.0.22

使用

由于迁移脚本并不完美，你应该先确保你的代码已有备份（例如，使用版本控制工具，如 git）。

您需要运行迁移脚本两次，因为它每次只应用一个导入替换。

例如，假设你的代码仍然使用 from langchain.chat_models import ChatOpenAI：

首次运行后，您将得到： from langchain_community.chat_models import ChatOpenAI 第二次运行后，您将得到： from langchain_openai import ChatOpenAI

# Run a first time
# Will replace from langchain.chat_models import ChatOpenAI
langchain-cli migrate --diff [path to code] # Preview
langchain-cli migrate [path to code] # Apply

# Run a second time to apply more import replacements
langchain-cli migrate --diff [path to code] # Preview
langchain-cli migrate [path to code] # Apply

其他选项

# See help menu
langchain-cli migrate --help
# Preview Changes without applying
langchain-cli migrate --diff [path to code]
# Run on code including ipython notebooks
# Apply all import updates except for updates from langchain to langchain-core
langchain-cli migrate --disable langchain_to_core --include-ipynb [path to code]

迁移

升级到新的导入​

安装​

使用​

其他选项​

升级到新的导入

安装

使用

其他选项