LangChain
专为Python LangChain应用构建与调试设计的智能体技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：专为Python LangChain应用构建与调试设计的智能体技能 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的LangChain智能体一直在重复调用同一个搜索工具，直到抛出GraphRecursionError，帮我看看链的定义和工具调用的条件逻辑哪里有问题。’ 它会分析你的代码，指出可能导致循环的智能体执行逻辑或工具调用条件设置不当之处。或者当你说：‘with_structured_output方法返回了None，但模型返回的JSON看起来是有效的。’ 它会帮你检查解析器配置、输出模式定义，以及模型响应与预期结构的匹配情况。
介绍
本技能专门解决开发者在构建和调试基于LangChain的Python应用时遇到的各种棘手问题。它覆盖了从LCEL链、智能体、工具、检索器到流式输出和结构化输出的全流程，能有效应对开发中的常见陷阱。
当你在编写或审查链、智能体、工具、检索器或提示模板时，它可以提供实时辅助。当提示词抛出KeyError或“缺少变量”错误，流式输出变成一团乱码，或者astream_events没有产出时，它能帮你快速定位问题。
它非常适合后端开发、全栈开发和智能体开发者，特别是那些正在使用LangChain/LangGraph框架构建复杂AI应用，并频繁遭遇上述调试难题的工程师。
使用建议是，将其作为开发过程中的“贴身调试助手”，在遇到具体错误或不确定最佳实践时即时调用。需要注意的是，它深度绑定LangChain生态，对于框架无关的智能体架构设计、检索系统（RAG）设计或分块优化等更宏观或跨框架的问题，可能不是最佳选择。
核心特点
与通用AI编程助手不同，它深度聚焦于LangChain/LangGraph生态内的具体调试场景，能精准识别并解决如GraphRecursionError、工具调用验证失败、LangSmith追踪为空等框架特有难题，而非提供泛泛的编程建议。
注意事项
不适合用于设计框架无关的智能体架构、进行通用的RAG检索设计或进行文本分块策略调优。
常见问题
这个技能能帮我解决LangChain升级后导入报错吗？
可以，它专门处理因LangChain版本升级导致的导入中断或API变更问题。
当我的LangChain智能体陷入死循环或重复调用工具时怎么办？
这正是本技能的核心场景之一，它能帮你分析智能体状态，排查导致GraphRecursionError或工具重复调用的逻辑问题。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-4/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-4/raw/index.md（查看排版版本）