LangChain
专为Python LangChain应用开发的构建与调试助手
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：专为Python LangChain应用开发的构建与调试助手 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在用LangChain写一个客服Agent，但它调用完工具后，聊天历史就消失了，导致下一轮对话没有上下文。”，它会分析你的链式结构，检查可能是记忆（Memory）组件未正确集成或会话状态未被保留，并给出修复代码示例。或者
对AI说：“我的LCEL链在流式输出时，所有token都是一下子涌出来的，而不是逐个单词流式返回。”，它会帮你检查是否错误地使用了同步接口而非异步的astream，或输出解析器阻塞了流式过程。
介绍
这个Skill专为解决LangChain应用开发中的各类棘手问题而设计。当你在使用Python构建基于LangChain的智能体、工具链或检索增强生成（RAG）应用时，经常会遇到诸如链式调用（LCEL）出错、智能体陷入死循环、流式输出异常、结构化输出解析失败、工具调用验证不通过、上下文窗口溢出、LangSmith追踪为空，或是升级后导入错误等一系列令人头疼的调试难题。
它通过深度集成LangChain和LangGraph框架，能够理解你的代码上下文，并提供精准的诊断和修复建议。你可以直接描述遇到的问题现象，例如“我的agent一直在重复调用同一个工具”，Skill会分析可能的成因，如状态管理错误或工具定义问题，并给出具体的代码修改方案或配置调整建议。
这个Skill非常适合正在或计划使用LangChain进行AI应用开发的工程师，包括后端开发、全栈开发和智能体开发者。无论是编写新的链、调试复杂的多智能体交互，还是优化现有的检索与输出流程，它都能提供专业级的支持。
使用建议是，在遇到问题时，尽可能详细地提供错误信息、相关代码片段以及你的预期行为。注意事项是，它主要聚焦于LangChain框架本身的使用和调试，对于完全框架无关的智能体架构设计、底层的RAG检索算法优化或文本分块策略（chunking）调优，可能不是最佳选择。
核心特点
与通用AI编程助手相比，它深度聚焦于LangChain/LangGraph生态，能精准诊断框架特有的错误（如GraphRecursionError、工具调用ID验证失败、astream_events无输出等），并提供针对性的修复方案，而非泛泛的Python调试建议。
注意事项
不适合进行与LangChain框架无关的通用智能体架构设计、RAG检索系统底层设计或文本分块策略的调优。
常见问题
如何解决LangChain智能体无限循环的问题？
可以检查智能体执行器的max_iterations参数、工具返回结果格式，或使用本Skill分析是否存在GraphRecursionError及状态检查点（checkpointer）配置问题。
为什么我的with_structured_output返回None？
可能是输出解析器（Parser）与模型返回的JSON格式不匹配，或模型响应未包含所需字段。可使用本Skill检查解析器定义和模型原始输出。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-7/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-7/raw/index.md（查看排版版本）