《LangChain编程：从入门到实践》全书总复习

为什么先冻结依赖、数据流与trace

、、、、、共同构成本页坐标。以同一trace串起Model I/O、Runnable链、RAG、代理、记忆、回调和Slack多模态机器人，完成正常与故障路径重放。

LangChain是快速演进的框架，本书首版记录的是2023至2024年前后的模块和接口。学习时必须分开原书的架构脉络、首版代码形状和后来版本的迁移方式。类名废弃不会让Runnable、schema、检索、工具权限、记忆隔离和事件追踪失效；实现应以端口与契约测试隔离具体版本。

每次运行保存Python版本、依赖锁摘要、代码提交、环境配置名、输入、节点图、模型与工具版本、事件trace、原始错误、输出校验和回退动作。只保存最终回答无法区分模板、模型、检索、记忆、工具或回调中的首个错误，也无法证明升级前后语义相同。

数学与执行骨架

公式用于固定比较对象：组合必须说明函数方向，检索必须说明分母，代理必须有预算，事件必须有父子关系。框架生成的图或trace只是观测结果，仍需用输入输出断言和故障样本证明业务语义。

三段可运行骨架

def freeze_run(code_version, dependency_lock, config, inputs):
    return {"code": code_version, "lock": dependency_lock, "config": config, "inputs": inputs}

def record(trace, node, expected, actual):
    trace.append({"node": node, "expected": expected, "actual": actual, "ok": expected == actual})
    return trace

def first_divergence(trace):
    return next((item for item in trace if not item["ok"]), None)

代码通过普通Python表达核心合同，可在没有外部模型、LangSmith或LangServe时运行。接入真实LangChain版本时，由薄适配器映射到相应Runnable、模型、检索器或回调API；契约测试不随类名变化，从而可以精确定位迁移差异。

固定样例与手算

先用三个节点构造管道：模板节点接收字典并输出消息，模型假对象接收消息并输出固定结构，解析节点验证必需字段。分别调用单次、两项批量和逐块流式接口，聚合后的业务结果应一致；若事件数量或顺序不同，差异必须在trace中可解释。

再取查询向量q=(1,0)、文档向量d1=(0.8,0.6)、d2=(0,1)，余弦相似度分别为0.8和0。检索top-1应返回d1，但这只证明向量邻近，不证明d1支持答案。生成前仍需核对文档ID、嵌入版本、文本范围和引用；空召回必须拒答。

代理实验注册read与write两个工具，普通权限只允许read。模型若选择write，schema可以正确但权限门禁仍应拒绝；工具超时不得被改写成“执行成功”。记忆实验再写入两名用户的同名事实，读取必须按租户隔离，并在过期时间后删除。

最后注入三个故障：依赖版本改变输出字段、检索器返回失效文档ID、回调处理器抛出异常。系统应分别在解析、引用校验和观察端口报告首个分叉；回调失败不篡改已完成的业务结果，解析与引用失败则阻断发布。

常见失败与回退

本章回顾

以同一trace串起Model I/O、Runnable链、RAG、代理、记忆、回调和Slack多模态机器人，完成正常与故障路径重放。 掌握标准不是记住快速变化的API，而是能重建节点、合同、trace、失败和回退。通过标准为：能从冻结事件重放完整应用，在依赖、模型、检索、工具、记忆或回调故障时定位首个分叉并回退。

前后导航

• 第10章 社区和资源