LangChain
专为Python LangChain应用设计的调试与构建工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：专为Python LangChain应用设计的调试与构建工具 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我正在开发一个LangChain智能体，但它陷入了无限循环，并抛出了GraphRecursionError，能帮我分析一下可能的原因吗？’ 它会引导你检查智能体的状态图配置、工具调用逻辑和停止条件，并提供具体的调试步骤和代码修改建议。或者，当你说：‘我的LCEL链的with_structured_output方法总是返回None，即使输入是有效的JSON。’ 它会帮你检查解析器（parser）的配置、输出模式（mode）的设置，并验证中间步骤的输出是否符合预期。
介绍
这个Skill旨在解决开发者在构建和调试基于LangChain的Python应用时遇到的各种棘手问题。无论是LCEL链、智能体、工具、检索器，还是流式输出、结构化输出，它都能提供针对性的帮助。
当你在编写或审查链、智能体、工具或提示模板时遇到困难，当提示词报出KeyError或“变量缺失”错误，当流式输出变成一团乱码或astream_events没有结果，当智能体陷入循环或重复调用工具时，这个Skill都能派上用场。它还能处理工具调用验证失败、聊天历史丢失、上下文窗口溢出、结构化输出返回None、检索返回错误片段、LangSmith追踪为空等复杂场景。
它非常适合正在使用LangChain（包括LangGraph）进行Python应用开发的后端开发、全栈开发和智能体开发者。无论是初学者在搭建第一个应用时遇到问题，还是有经验的开发者在处理生产环境中的复杂故障，都能从中受益。
建议在遇到具体错误时，将详细的错误信息、代码片段和相关配置提供给该Skill，以便获得最精准的解决方案。注意，它主要聚焦于LangChain框架本身的问题，对于框架无关的智能体架构设计、检索系统（RAG）设计或分块优化等更宏观或跨框架的问题，可能不是最佳选择。
核心特点
与通用的Python调试工具或AI开发助手不同，它深度集成了LangChain和LangGraph的特定概念、错误模式和调试流程，能精准定位如`GraphRecursionError`、`astream_events`无输出、`with_structured_output`返回None等框架特有的问题。
注意事项
不适合用于设计框架无关的智能体架构、通用的检索（RAG）系统设计或进行文本分块（chunking）优化。
常见问题
我的LangChain智能体一直循环调用同一个工具怎么办？
这可能是由于智能体状态管理或工具调用逻辑问题导致，可以检查智能体的停止条件、工具返回格式以及是否触发了`GraphRecursionError`。
为什么我的`astream_events`方法什么也yield不出来？
这通常与事件流订阅的设置或链的构造方式有关，需要检查是否正确启用了事件流，并确保链支持事件流输出。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-2/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-2/raw/index.md（查看排版版本）