LangChain v0.2
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 events 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 # <-- 确保版本至少为 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
其他选项
# 查看帮助菜单
langchain-cli migrate --help
# 预览更改而不应用
langchain-cli migrate --diff [path to code]
# 在代码上运行，包括 ipython 笔记本
# 应用所有导入更新，除了从 langchain 到 langchain-core 的更新
langchain-cli migrate --disable langchain_to_core --include-ipynb [path to code]