LangGraph 03：持久化、Interrupt、恢复与时间旅行
1、本篇任务：让退款流程暂停一天后还能继续 审批可能几秒后完成，也可能第二天才处理。HTTP 请求不能一直挂着，所以图必须保存状态、结束当前请求，并在新请求中从相同 thread 恢复。 2、Checkpoint、Thread、Store 的关系 checkpointer 在每个 super step 保存 state snapshot；thread ID 把一系列 checkpoint 组织成一次持续运行；store 保存跨 thre...
LangGraph 04：流式、调试与生产运行
1、本篇任务：让图在用户和开发者眼中都可见 用户关心“正在检索、等待审批、答案到哪了”；开发者关心“哪个节点慢、state 如何变化、为何走了这条边”。两者需要不同流。不要把完整 state 或内部 trace 直接发给用户。 2、理解常用 stream mode | 模式 | 看到什么 | 适用场景 | | | | | | | 每步后的完整 state | 本地调试，小 state | | | 节点产生的局部更新 | 调试状态变化、构...
LangSmith 01：追踪——让 Agent 运行过程可见
1、本篇任务：从一次错误回答找到具体失败步骤 应用日志常只告诉你请求失败；Agent 却可能在路由、检索、工具、模型或输出校验任一层出错。LangSmith Trace 用父子 run 记录完整调用树，使一次用户请求可以沿步骤检查。 本课为退款助手建立 的追踪层级。 2、Run 与 Trace 的关系 一个 run 表示一个工作单元，多个父子 run 组成 trace： 根 run 对应用户可见结果；子 run 对应可独立计时、失败和评...
LangSmith 02：观测、调试与反馈闭环
1、本篇任务：把“用户说答错了”变成可重复诊断 Trace 是原始运行记录，Observability 是用 trace 回答运营问题：哪类请求在失败；从哪个版本开始；影响谁；应由哪个团队处理。 2、一次投诉的固定排查顺序 收到 request ID 后： 1. 确认 environment、release、模型/prompt/index 版本。 2. 检查路由是否选择正确流程。 3. 检查 retriever 的 filter、chu...
LangSmith 03：离线与在线评测
1、本篇任务：证明新版本比旧版本更好 LLM 输出非确定，不能靠“手工聊几句”发布。LangSmith Evaluation 的基本循环是：创建 Dataset；定义 Evaluator；运行 Experiment；比较结果；把线上失败回灌 Dataset。 离线评测在发布前使用参考答案；在线评测在生产 trace 上监控格式、安全与质量模式。两者作用不同，不能互相替代。 2、先拆分“好”的维度 退款助手至少有：意图分类、检索命中、答案...
LangSmith 04：部署与上线治理
1、本篇任务：发布一个可恢复、可回滚的 Agent 服务 LangSmith 的观测和评测可以独立使用；Deployment/Agent Server 用于运行和管理长期、有状态 Agent。是否采用 Cloud、Hybrid、Self hosted 或 Standalone，取决于数据边界、规模和运维能力，而不是功能越多越好。 2、先判断是否需要 Agent Server 简单 CLI 或 webhook 可以直接调用应用 worke...
实战 01：简易 OpenCode——产品边界与架构
1、这一系列最终要做出什么 目标是一个真正可使用的本地编码 Agent，而不只是“模型生成 Patch”的示例。完成后应支持： 启动本地 Server，TUI/CLI 作为独立客户端连接。 一个项目有多个 Session；Session 中保存用户消息、模型文本、推理/工具 Part、费用和状态。 Plan 模式默认只读，Build 模式按权限执行读取、搜索、编辑、测试。 运行过程通过 SSE 发送增量事件；客户端断开后 Session...
实战 02：简易 OpenCode——Python 编码 Agent
1、本篇交付物 使用 Python、FastAPI、SQLite、Pydantic 和 LangGraph 完成一个最小 Server：创建 Session、发送 Prompt、SSE 订阅事件、执行只读工具、产生编辑权限请求、批准后恢复并应用 Patch。真实模型最后接入，开发阶段先用 FakeModel 保证测试确定。 2、项目结构 3、核心合同 API、数据库 JSON 和 SSE 都使用这些 schema。数据库读取出的 JSO...
实战 03：简易 OpenCode——TypeScript 编码 Agent
1、本篇交付物 TypeScript 版采用 Fastify、Zod、SQLite、LangGraph.js 和 Ink/React：Server 负责项目、Session、模型、工具与权限；TUI 只调用 HTTP/SSE。重点不是翻译 Python，而是利用 discriminated union 和 reducer 保证端到端事件一致。 2、Monorepo 结构 不依赖 Server/TUI，防止循环依赖。所有网络输入、数据库...