快速结论:这不是一个运行时崩溃报错,而是 LangChain 文档中仍在用已废弃的 initialize_agent(自 0.1 起弃用)的规范性问题;凡是照着文档里 initialize_agent 示例复制代码、出现弃用提示或示例无法与新版本对齐时,优先把示例改为 langgraph.prebuilt.create_react_agent 的用法。
适用环境:Issue 中确认的只有工具与范围:LangChain(docs/ 目录下的集成文档)与 langgraph.prebuilt.create_react_agent;未给出确认的操作系统、Python、CUDA、显卡或具体依赖版本信息。
最快修复方案:暂无确认的一步修复方案。Issue 中要求的是按页面逐个替换 initialize_agent 为 langgraph.prebuilt.create_react_agent,并保证替换后的示例代码可运行;维护者明确说明该 Issue 不要求单个 PR 完成,可增量推进。
注意事项:这是文档类跟踪 Issue,没有给出统一的自动化命令或一次性修复脚本;不同集成页面(如 Gmail、AINetwork、AWS Lambda、NASA、EdenAI 等)的依赖与模型调用方式不同,替换后需逐页自行运行验证。评论中提到的为 agent.run(...) 增加 print(response) 属于建议性改动,未获确认,不应视为必要修复。
问题场景
用户在阅读或复制 LangChain 文档(langchain/docs 下 tools 与 integrations 页面)中的示例时,示例使用了 initialize_agent。该函数自 0.1 版本起已被弃用,文档应改为用 LangGraph 的基础用法做演示,例如 langgraph.prebuilt.create_react_agent。Issue 指出 Gmail 集成页已提供使用 create_react_agent 的示例,可作为参照。该问题涉及多个页面,可由不同贡献者分批处理。
报错原文
docs: Replace `initialize_agent` use with langgraph.prebuilt.create_react_agent
原因分析
最可能的原因是:文档示例长期未随 API 演进更新,仍引用已弃用的 initialize_agent,导致读者照抄后得到弃用提示或与当前推荐写法不一致。Issue 将其定性为文档规范与迁移问题,而非某个具体运行时异常,因此没有单一堆栈可对照;若用户实际运行中看到弃用警告,也属于同一根因。
环境排查
- 确认 LangChain 版本是否为 0.1 及以上:Issue 明确
initialize_agent自 0.1 起弃用。 - 确认所查看的文档页面是否位于
langchain/docs下,并检索其中是否仍含initialize_agent。 - 确认目标示例是否已按
langgraph.prebuilt.create_react_agent写法替换,以及替换后示例所用模型、工具依赖是否齐全。 - Issue 未提供确认的 Python、CUDA、PyTorch、显卡或节点版本,这部分需按各集成页面自身依赖单独核对,不要套用统一版本。
解决步骤
- 在
langchain/docs中检索initialize_agent,列出仍使用该函数的 tools 与 integrations 页面(评论中示例包括 AINetwork Toolkit、AWS Lambda、Gmail、NASA ToolKit、EdenAI 等)。 - 参考 Gmail 集成页中「Use within an agent」一节的
create_react_agent示例写法,作为替换模板。 - 逐页把
initialize_agent的调用改为langgraph.prebuilt.create_react_agent的基础用法,保持该页面原有的工具与模型配置语义。 - 替换后实际运行修改过的示例代码,按维护者要求确认「文档中更新的代码运行不报错」。
- 统一清理说明文字中遗留的「deprecated / initialize_agent」表述,避免读者继续按旧写法复制。
- 按页面或集成拆分为多个 PR 并引用 #29277 跟踪,Issue 明确允许增量提交,不必等全部页面完成再合入。
验证方法
在 langchain/docs 下再次检索 initialize_agent,确认目标页面已无残留引用;同时逐页运行更新后的示例,确认无弃用提示、无导入或调用错误,且示例能正常输出工具调用结果。若仅完成部分页面,应确认改动页面可独立运行,其余页面仍由该 Issue 继续跟踪。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。
![[Bug]: #67743 — LLaVA-OneVision crashes when videos have different frame counts](https://www.chat-gpts.plus/wp-content/uploads/2026/11/68004-44174f4e-768x403.jpg)

![issue: [regression] [dev] closing a tab in an unsent new chat removes it from the chat you just left](https://www.chat-gpts.plus/wp-content/uploads/2026/11/34303-6ea572a8-768x403.jpg)