讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

LangChain 升级后 agent_toolkits 导入报错的解决方案

老婷酱_9781

老婷酱_9781

发布时间:2026-02-14 10:58:12

|

895人浏览过

|

来源于php中文网

原创

LangChain 升级后 agent_toolkits 导入报错的解决方案

LangChain v0.1+ 版本将部分代理工具(如 create_python_agent 和 PythonREPLTool)迁移至独立包 langchain_experimental,直接导入旧路径会触发路径校验异常;需安装新包并更新导入语句。

langchain v0.1+ 版本将部分代理工具(如 `create_python_agent` 和 `pythonrepltool`)迁移至独立包 `langchain_experimental`,直接导入旧路径会触发路径校验异常;需安装新包并更新导入语句。

自 2023 年 10 月起,LangChain 进行了模块架构重构:原位于 langchain.agents.agent_toolkits 下的实验性代理工具(包括 create_python_agent、PythonREPLTool 等)被正式移出核心包,统一归入新发布的独立子包 —— langchain_experimental。该变更旨在解耦稳定 API 与仍在迭代中的高级功能,提升核心库的稳定性与可维护性。

当你执行 conda install conda-forge::langchain 升级至 v0.1.x 或更高版本后,若仍沿用旧导入方式:

from langchain.agents.agent_toolkits import create_python_agent  # ❌ 已废弃
from langchain.tools.python.tool import PythonREPLTool             # ❌ 已废弃

Python 在解析 __init__.py 中的动态导入逻辑时,会调用 langchain_core._api.path.get_relative_path() 校验模块路径关系。由于 langchain/agents/agent_toolkits 与 langchain_core 不再属于同一逻辑子树(前者已实质“断连”),便抛出经典错误:

ValueError: '.../langchain/agents/agent_toolkits' is not in the subpath of '.../langchain_core'

✅ 正确做法如下:

1. 安装实验性模块包

pip install langchain_experimental

⚠️ 注意:conda-forge 当前暂未同步提供 langchain_experimental 的稳定构建,强烈建议使用 pip 安装,避免环境不一致问题。

AI舌诊面诊问诊医疗系统+诊疗商城系统源码
AI舌诊面诊问诊医疗系统+诊疗商城系统源码

AI 舌诊面诊问诊医疗系统 + 诊疗商城系统源码是一套结合 AI 辅助诊断与商品转化的健康类程序,基于浩创云、ThinkPHP(PHP)开发,支持微信服务号与 H5 端,适合做中医舌诊面诊问答、健康建议推送以及配套诊疗商品的运营。

下载

2. 更新导入语句

功能 新导入路径 说明
创建 Python 代理 from langchain_experimental.agents.agent_toolkits import create_python_agent ✅ 替代原 langchain.agents.agent_toolkits.create_python_agent
Python 执行工具 from langchain_experimental.tools.python.tool import PythonREPLTool ✅ 替代原 langchain.tools.python.tool.PythonREPLTool
基础 Python REPL from langchain.python import PythonREPL ✅ 仍保留在 langchain 主包中,无需改动
通用代理初始化 from langchain.agents import load_tools, initialize_agent, AgentType ✅ 这些核心代理类未迁移,保持原路径

完整示例(可直接运行)

# ✅ 正确导入(LangChain ≥ 0.1.0)
from langchain_experimental.agents.agent_toolkits import create_python_agent
from langchain_experimental.tools.python.tool import PythonREPLTool
from langchain.llms.openai import OpenAI  # 注意:v0.1+ 中 OpenAI LLM 已移至 langchain_openai(见下方提示)
from langchain.agents import AgentType

# 初始化工具与 LLM(以 OpenAI 为例)
tool = PythonREPLTool()
llm = OpenAI(temperature=0, api_key="your-api-key")  # 若使用新版,推荐改用 langchain_openai.OpenAI

agent = create_python_agent(
    llm=llm,
    tool=tool,
    verbose=True,
    agent_type=AgentType.ZERO_SHOT_REACT_DESCRIPTION,
)

? 重要补充说明

  • OpenAI 模块变更:langchain.llms.openai.OpenAI 在 v0.1+ 中已被弃用,官方推荐迁移到独立包 langchain_openai:

    pip install langchain_openai
    from langchain_openai import OpenAI  # ✅ 新标准路径
  • 版本兼容性检查:运行以下命令确认关键包版本:

    pip show langchain langchain-experimental langchain-openai

    建议组合版本参考:langchain>=0.1.16, langchain-experimental>=0.1.10, langchain-openai>=0.1.4

  • 避免混用 Conda/Pip 安装:若环境由 Conda 创建,仍建议对 langchain_experimental 和 langchain_openai 使用 pip 安装,因其在 Conda Forge 中更新滞后,易引发路径或依赖冲突。

该调整并非 Bug,而是 LangChain 向模块化、渐进式演进的关键一步。及时更新导入路径与依赖,不仅能解决当前报错,更能确保后续平滑接入更多 experimental 功能(如 CSV Agent、Pandas Agent 等)。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
Python 时间序列分析与预测
Python 时间序列分析与预测

本专题专注讲解 Python 在时间序列数据处理与预测建模中的实战技巧,涵盖时间索引处理、周期性与趋势分解、平稳性检测、ARIMA/SARIMA 模型构建、预测误差评估,以及基于实际业务场景的时间序列项目实操,帮助学习者掌握从数据预处理到模型预测的完整时序分析能力。

360

2025.12.04

Python 数据清洗与预处理实战
Python 数据清洗与预处理实战

本专题系统讲解 Python 在数据清洗与预处理中的核心技术,包括使用 Pandas 进行缺失值处理、异常值检测、数据格式化、特征工程与数据转换,结合 NumPy 高效处理大规模数据。通过实战案例,帮助学习者掌握 如何处理混乱、不完整数据,为后续数据分析与机器学习模型训练打下坚实基础。

272

2026.01.31

Python数据分析与Pandas高级实战
Python数据分析与Pandas高级实战

本专题围绕 Python 数据分析展开,系统讲解 Pandas 的高级用法,包括数据清洗、透视表、时间序列分析以及多表合并与分组操作。通过实战案例,帮助开发者掌握高效处理与分析数据的方法,提高数据处理效率与分析能力。

871

2026.04.13

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

3530

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

7983

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

9682

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

5087

2025.07.23

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

20

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn