LangChain 架构指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/langchain-architecture。
技能介绍
你在解决什么问题
用 LLM 做「多步推理 + 调工具 + 记上下文」时,如果全靠手写胶水代码,很快会在记忆膨胀、链式步骤编排和文档检索上踩坑。LangChain 把智能体、链、记忆、文档流水线抽象成可组合模块,但框架面大,选型(ReAct 还是 Functions、哪种 Memory、RAG 怎么拆块)需要一张清晰的架构地图。
技能覆盖的核心能力
本技能围绕 LangChain 的五块骨架展开:
- 智能体 (Agents):ReAct、OpenAI Functions、Structured Chat 等类型,以及「LLM 决定下一步动作」的边界
- 链式调用 (Chains):从
LLMChain到RouterChain、MapReduceChain的串联与路由 - 记忆 (Memory):Buffer、Summary、滑动窗口、
VectorStoreMemory等如何维持多轮状态 - 文档处理:Loader、Splitter、Vector Store、Retriever 组成的 RAG 流水线
- 回调 (Callbacks):日志、Token 用量、延迟与自定义指标
并给出常见架构模式(RAG、带工具的智能体、多步骤链)及记忆选型、测试与性能(缓存、批量、流式)等可操作要点;更细的实现可对照技能内的 implementation-playbook 与 references/、assets/ 示例。
适用边界与注意点
- 任务与 LangChain 架构无关,或依赖本技能范围外的领域/工具时,不必强行套用。
- 生产上要警惕:对话历史未裁剪、工具描述含糊导致选错工具、上下文超窗、智能体异常未处理、向量检索未调优;技能中的生产检查清单(错误处理、超时、限流、可观测性、降级与配置版本化)可作为上线前对照项。
使用场景
- 内部知识库已入库向量库,需要按 LangChain 的 Loader、Retriever 搭一条可维护的问答 RAG 流水线
- 业务要 LLM 自主选 API 与数据库查询工具,需按 ReAct 或 Functions 模式设计智能体与工具描述
- 多步审批或研报生成流程要用 SequentialChain、RouterChain 编排,并在多轮对话里用 Summary 或滑动窗口记忆控上下文
- 上线前要接 Callback 打 Token 与延迟日志,并对智能体超时、检索慢和上下文超窗做错误处理与降级
适合人员
- 负责把企业文档检索问答从 PoC 迁到可观测、可限流的生产服务的后端工程师
- 需要在同一产品里组合多工具调用与多轮状态、避免对话历史撑爆上下文的 LLM 应用开发者
- 设计 RAG 分块、索引与检索策略,并要对齐 LangChain 文档处理组件的数据工程师
- 评估智能体架构选型(链式 vs 路由 vs MapReduce)并写实施清单的技术负责人或架构师