LangChain
构建和调试 LangChain 应用的 Python 技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：构建和调试 LangChain 应用的 Python 技能 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
例如，
对AI说：‘我的 LangChain 智能体在执行工具调用时一直循环直到 GraphRecursionError，我该如何限制递归深度？’ AI 会分析你的代码，建议在 LangGraph 中设置 recursion_limit 参数，并检查工具调用逻辑是否导致无限循环。再如，
对AI说：‘with_structured_output 返回了 None，但 JSON 解析是合法的，怎么修复？’ AI 会检查 parser 配置和输出 schema 是否匹配，并给出调整建议。
介绍
LangChain 是一个专为 Python 开发者设计的 AI 辅助技能，用于快速构建、调试和优化基于 LangChain 框架的应用。它覆盖了 LCEL 链、智能体、工具、检索器、流式输出和结构化输出等核心场景，能有效解决开发过程中常见的 Prompt 变量缺失、流式数据传输异常、智能体陷入死循环或工具调用失败、聊天历史丢失、上下文窗口溢出、结构化输出解析错误、检索结果不准确、LangSmith 追踪为空、重试/限流/Token 成本失控以及升级后导入报错等问题。该技能还深入支持 LangGraph 的状态管理、检查点机制和中间件配置，帮助开发者快速定位并修复复杂的工作流故障。
使用时，你只需在特定场景下向 AI 描述遇到的问题或需求，例如“我的智能体在执行工具调用时反复报 validation error”或“with_structured_output 返回了 None 但 JSON 是合法的”，AI 便会基于 LangChain 的最佳实践给出诊断建议和修复方案。它能够帮助你分析代码逻辑、检查配置参数、优化 Prompt 模板、调试流式输出和事件监听，甚至在处理 LangGraph 递归错误时提供状态回滚或循环终止策略。
该技能最适合智能体开发者、后端开发者和全栈开发者，尤其是那些正在使用 LangChain 构建复杂 AI 应用，需要频繁调试链、智能体、检索器和结构化输出模块的工程师。对于希望快速排除 LangChain 开发中常见故障、提升开发效率的团队或个人，它也是一个高效的辅助工具。
使用建议：建议在遇到具体 LangChain 运行错误或行为异常时调用，不要将其用于框架无关的通用智能体架构设计（推荐使用“agents”技能）或检索系统设计（推荐使用“rag”技能），也不适用于分块调优（推荐使用“rag-chunking”技能）。对于大型项目，建议结合 LangSmith 追踪日志一起使用，以更全面地定位问题。
核心特点
与同类技能相比，LangChain 专注于 LangChain 框架本身的调试和优化，覆盖了从 LCEL 链到 LangGraph 状态管理的全链路常见故障，而其他通用智能体技能则更偏向框架无关的架构设计。
注意事项
不适用于框架无关的智能体架构设计、检索系统设计或分块调优场景。
常见问题
为什么我的 prompt 报 KeyError 或 missing variables？
检查 prompt 模板中的变量名是否与传入的变量一致，确保没有拼写错误或遗漏。
流式输出时只得到一个 blob，astream_events 没有返回事件？
确认使用了正确的流式方法和回调，检查是否设置了 stream_mode 参数，并确保 LangChain 版本支持该功能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-9/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-9/raw/index.md（查看排版版本）