# LangChain v0.2 迁移指南
## 引言
LangChain v0.2 于 2024 年 5 月发布,这次更新带来了许多重大改变和弃用功能。对于依赖 LangChain 进行 AI 应用开发的开发者而言,及时迁移到新版本至关重要。这篇文章将引导您如何从旧版本迁移至 LangChain v0.2,帮助您解决升级过程中遇到的常见问题。
## 主要内容
### 1. 准备工作
在开始迁移之前,请确保您已经安装了以下组件的 0.2.x 版本:
- `langchain-core`
- `langchain`
- 相关的其它包(如 `langgraph`, `langchain-community`, `langchain-openai` 等)
务必运行单元测试以验证您的代码在新版本中的正确性。
### 2. 使用迁移工具
LangChain 提供了 `langchain-cli` 工具,帮助开发者自动替换旧的导入路径。请注意,该工具仍在 beta 阶段,并不能涵盖所有场景。
```bash
pip install langchain-cli
langchain-cli --version # 确保版本至少为 0.0.22
使用迁移脚本:
在执行迁移脚本前,请确保备份您的代码。该工具需要运行两次才能完成所有替换。
# 第一次运行
langchain-cli migrate --diff [