LangChain
专为Python LangChain应用提供的构建与调试工具集
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：专为Python LangChain应用提供的构建与调试工具集 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的LangChain智能体一直在重复调用同一个工具，直到抛出GraphRecursionError，这是为什么？'，它会分析你的智能体结构、工具定义和记忆机制，指出可能缺少停止条件或状态未更新，并提供修改LCEL链或调整AgentExecutor参数的代码示例。或者
对AI说：'我的with_structured_output调用返回了None，但模型返回的JSON看起来是有效的。'，它会帮你检查Pydantic模型定义、解析器配置以及模型响应格式，定位不匹配之处。
介绍
该Skill旨在解决开发者在构建和调试基于LangChain的Python应用时遇到的各种棘手问题。无论是编写LCEL链、智能体、工具、检索器，还是处理流式输出和结构化输出，它都能提供针对性帮助。
当你在开发中遇到提示词报错（如KeyError）、流式输出异常、智能体无限循环、工具调用失败、聊天历史丢失、上下文窗口溢出、结构化输出解析错误、检索结果不准、LangSmith跟踪为空等问题时，都可以使用此Skill来诊断和修复。
它特别适合使用LangChain框架进行AI应用开发的Python开发者，尤其是那些正在构建复杂链、智能体或需要处理流式、结构化输出的工程师。
使用建议：在遇到具体LangChain错误或不确定如何实现某个功能时，直接向AI描述你的代码、错误信息或预期行为，以获得具体解决方案。注意，它专注于LangChain框架内的调试，不涉及通用的智能体架构设计或RAG检索方案优化。
核心特点
与通用AI编程助手不同，它深度集成了LangChain框架的调试上下文，能精准识别LCEL链、LangGraph状态、检查点等框架特有组件的错误模式，并提供针对性的修复方案，而非泛泛的代码建议。
注意事项
不适合进行与LangChain框架无关的通用智能体架构设计、RAG检索方案设计或文本分块策略优化。
常见问题
如何解决LangChain智能体无限循环（GraphRecursionError）？
分析智能体配置、工具返回和状态更新逻辑，检查是否缺少终止条件或状态未正确更新。
LangChain流式输出（astream_events）不工作怎么办？
检查链的构建方式（是否使用LCEL）、异步上下文以及事件处理函数的正确性。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-8/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-8/raw/index.md（查看排版版本）