随着 LangChain v0.2 的发布，开发人员面临着一系列重要的变更和弃用警告。本文将详细指导您如何平滑地从 v0.1 迁移至 v0.2，并解决在此过程中可能遇到的问题。

技术背景介绍

LangChain v0.2 在 2024 年 5 月发布，相较于之前的版本，它包括了一些重要的破坏性变更和弃用更新。为了确保您的项目在新版本中正常运行，需要对代码进行适当的升级和调整。

核心原理解析

破坏性变更和弃用

以下是一些需要特别注意的变更：

• 旧版链条迁移到 LCEL。
• Astream Events 升级到 v2。

升级到新导入路径

新版本对包的导入路径进行了变更。例如：

• 从 langchain.vectorstores 到 langchain_community.vectorstores。
• 从 langchain_community.chat_models 到 langchain_openai。

代码实现演示

安装新版本

首先，确保安装和升级相关包：

pip install langchain-core langchain langgraph langchain-community langchain-openai

使用 langchain-cli 迁移代码

为了辅助快速迁移，我们推荐使用 langchain-cli，一个自动化迁移工具。以下是工具的使用步骤：

1. 安装工具：

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

2. 运行迁移脚本：
   记得在迁移前备份代码（e.g., 使用 Git）。

   • 第一次运行:

     langchain-cli migrate --diff [path to code] # 预览变更
     langchain-cli migrate [path to code] # 应用变更
     

   • 第二次运行（应用更多导入替换）:

     langchain-cli migrate --diff [path to code] # 再次预览
     langchain-cli migrate [path to code] # 应用
     

   • 其他选项:

     langchain-cli migrate --help # 查看帮助菜单
     langchain-cli migrate --diff [path to code] # 预览不应用
     langchain-cli migrate --disable langchain_to_core --include-ipynb [path to code] # 运行在代码包括 ipython 笔记本中，但排除某些迁移
     

应用场景分析

很多开发者在迁移过程中可能会遇到导入路径和函数调用的变更，特别是对于大规模项目。这时候，借助工具进行自动迁移，可以显著减少人力投入和错误发生的概率。

实践建议

• 确保在迁移前有完整的代码版本备份。
• 借助 langchain-cli 工具，逐步完成导入路径的更换。
• 手动检查并解决任何残留的弃用警告。
• 运行完迁移后，务必执行单元测试，验证代码是否正常工作。

如果遇到问题欢迎在评论区交流。

—END—