LangChain
专为Python LangChain应用构建与调试设计的AI助手技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：专为Python LangChain应用构建与调试设计的AI助手技能 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的LangChain智能体一直在重复调用同一个工具，直到抛出GraphRecursionError，该怎么解决？’，它会分析你的智能体配置和工具定义，指出可能缺少停止条件或状态更新逻辑的问题，并给出修改建议。或者
对AI说：‘我用with_structured_output包装的链，有时会返回None，即使输入是有效的JSON，如何调试？’，它会引导你检查解析器（parser）的实现、模型的响应格式以及错误处理机制。
介绍
本技能专门用于解决开发者在构建和调试基于LangChain的Python应用时遇到的各种棘手问题。无论是编写LCEL链、智能体、工具、检索器，还是处理流式输出、结构化输出，它都能提供针对性帮助。
当你在开发中遇到提示词报KeyError、流式输出不完整、智能体陷入循环、工具调用失败、聊天历史丢失、上下文窗口溢出、结构化输出解析失败、检索结果不准确、LangSmith追踪为空、升级后导入错误等问题时，可以直接向它提问。它覆盖了LangGraph的状态管理、检查点和中间件等高级主题。
该技能非常适合正在使用LangChain框架进行AI应用开发的前后端工程师、全栈开发者以及智能体开发者。无论是新手入门时理解概念，还是资深开发者在复杂项目中排查疑难杂症，它都能成为得力的助手。
建议在使用时，尽可能清晰地描述你遇到的问题现象、错误信息以及相关的代码片段。对于涉及LangGraph等高级功能的问题，提供状态或配置的详细信息有助于获得更精准的解答。注意，它主要聚焦于LangChain框架本身的使用和调试，而非通用的智能体架构设计或RAG方案设计。
核心特点
与通用编程助手不同，它深度聚焦于LangChain框架的特定问题，能精准诊断如`GraphRecursionError`、`astream_events`无输出、`with_structured_output`返回None等框架特有错误，并提供基于LCEL和LangGraph的解决方案。
注意事项
不适合进行与LangChain框架无关的通用智能体架构设计、检索系统（RAG）方案设计或文本分块策略优化。
常见问题
如何解决LangChain智能体无限循环的问题？
检查工具调用逻辑和停止条件，使用本技能分析`GraphRecursionError`并提供调整智能体配置或状态管理的建议。
LangChain的流式输出为什么是一整块而不是逐步返回？
可能是链的配置或调用方式问题，使用本技能可帮你检查LCEL链的流式设置和`astream_events`的正确用法。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-3/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-3/raw/index.md（查看排版版本）