LangChain
专为Python LangChain应用提供的构建与调试工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：专为Python LangChain应用提供的构建与调试工具 完整的 Skill 内容见：https://321skill.com/skills/langchain-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的LangChain智能体一直在重复调用同一个工具，直到抛出GraphRecursionError，请帮我分析可能的原因。’ 它会引导你检查智能体的状态图、工具调用的条件逻辑以及可能存在的循环依赖。或者，当你说：‘我的LCEL链的with_structured_output方法总是返回None，但模型返回了有效的JSON。’ 它会帮你检查解析器配置、JSON结构匹配以及中间步骤的输出格式。
介绍
这个Skill专门用于解决在Python中开发和调试LangChain应用时遇到的各种棘手问题。无论是编写LCEL链、智能体、工具、检索器，还是处理流式输出和结构化输出，它都能提供关键支持。
当您遇到提示词报错（如KeyError或变量缺失）、流式输出异常（如一次性返回或astream_events无输出）、智能体行为异常（如无限循环或重复调用工具）、工具调用失败（如验证错误或provider拒绝）、上下文窗口溢出、结构化输出返回None、检索返回错误片段、LangSmith跟踪为空等问题时，可以使用此Skill进行诊断和修复。
它非常适合正在使用LangChain框架进行AI应用开发的Python开发者，特别是那些在构建复杂链、智能体或处理与LLM交互相关问题时需要深度调试支持的工程师。
建议在开发或代码审查阶段就使用此Skill，以提前发现潜在问题。注意，它主要覆盖LangChain和LangGraph的具体实现细节，对于框架无关的智能体架构设计或检索增强生成（RAG）的系统性设计，可能需要结合其他Skill。
核心特点
与通用的AI开发或Python调试工具不同，它深度集成了LangChain框架的特定错误模式和调试场景，能精准定位如`GraphRecursionError`、`astream_events`无输出、`with_structured_output`返回None等LangChain特有的问题，并提供针对性的解决方案。
注意事项
不适合进行与LangChain框架无关的通用智能体架构设计、RAG系统设计或文本分块策略优化。
常见问题
这个Skill能帮我解决LangChain升级后导入错误吗？
可以，它专门处理因LangChain版本升级导致的导入中断或API变更问题。
当我的LangChain智能体陷入无限循环时怎么办？
使用此Skill可以帮助诊断循环原因，例如检查状态管理或工具调用逻辑，解决`GraphRecursionError`等问题。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x/raw/index.md（查看排版版本）