LangChain
构建和调试LangChain应用的Python助手
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：LangChain。 它的用途是：构建和调试LangChain应用的Python助手 完整的 Skill 内容见：https://321skill.com/skills/langchain-x-6/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我调试这个LangChain代理，它一直在循环调用tool_A直到GraphRecursionError，代码在attachment中。'，它会首先分析代理的循环条件，检查tool_A的返回是否被正确处理，然后建议添加一个最大迭代次数限制或修改代理的停止条件，最后输出修改后的代码片段和测试建议。
介绍
这个Skill专门解决LangChain/LangGraph应用开发中的常见痛点，包括LCEL链、代理、工具、检索器、流式输出和结构化输出的构建与调试。当你的Prompt引发KeyError或’缺少变量’、流式输出变成单个数据块、astream_events不返回任何内容、代理陷入死循环或重复调用同一工具、工具调用验证失败或提供者拒绝tool_call_id、聊天历史丢失或上下文窗口溢出、with_structured_output返回None、解析器在有效JSON上崩溃、检索结果错误、LangSmith跟踪为空、需要限制重试/速率限制/Token成本、或者升级后导入失败时，都可以使用它来快速定位和修复问题。
使用方法：在AI编码助手中激活此Skill，然后描述你遇到的LangChain相关问题。它会自动分析你的代码，检查链结构、代理逻辑、检索器配置、流式处理等，并提供修复建议。例如，你可以直接问’为什么我的代理一直重复调用同一个工具？‘，它将检查代理的循环逻辑、工具调用参数和递归限制，并给出优化方案。
适合的用户包括：使用LangChain构建AI应用的智能体开发人员、需要调试复杂链和后端服务的后端开发人员、以及希望快速排查LangGraph状态和检查点问题的全栈开发者。无论你是刚入门LangChain的新手还是经验丰富的开发者，都能从中受益，尤其是在处理流式输出、结构化输出和代理行为时。
使用建议：建议在编写或审查链、代理、工具、检索器、Prompt模板时主动启用此Skill。如果你遇到LangGraph状态管理、检查点或中间件问题，也可以使用它。注意，这个Skill专注于LangChain/LangGraph生态，不适用于框架无关的代理架构设计、通用检索系统设计或分块调优场景。
核心特点
与通用Python调试技能不同，它深度理解LangChain/LangGraph的内部机制，能直接定位LCEL链的变量缺失、代理的GraphRecursionError、流式输出合并不完整、with_structured_output解析失败等LangChain特有错误，并提供针对性的修复方案。
注意事项
不适用于框架无关的代理架构设计、检索系统设计或分块调优等非LangChain/LangGraph生态的场景。
常见问题
LangChain版本升级后导入失败怎么办？
使用此Skill，它会自动检查导入路径变更，建议更新import语句或安装兼容版本。
with_structured_output返回None如何解决？
它会检查你的Pydantic模型定义、LLM输出格式以及解析器配置，找出匹配失败的原因并修复。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langchain-x-6/raw/index.md 读取 LangChain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langchain-x-6/raw/index.md（查看排版版本）