精通之路:生产化部署、流式与调试
走完最后一公里:多级流式输出、LangSmith 调试、LangGraph Platform 部署与生产检查清单。
流式:让图的执行过程"直播"
# 逐节点状态更新
for ev in app.stream(inputs, config, stream_mode="updates"): ...
# 逐 token(LLM 层)
for chunk in app.stream(inputs, config, stream_mode="messages"): ...
# 双通道:values + messages 同时开
app.stream(inputs, config, stream_mode=["updates", "messages"])
面向 C 端的 Agent 界面标准做法:节点执行过程实时展示(本站聊天页的步骤轨迹就是同款思路)+ 答案逐 token 输出。
调试与可观察
- LangSmith:每个节点/边的输入输出、token、延迟全量 trace;
- Checkpointer 回溯:坏 case 取存档、改状态、局部重跑(time travel);
- get_graph().draw_mermaid():拓扑核对。
部署形态
- 自托管:图编译产物就是普通 Python 对象,FastAPI 包一层即可(注意 Checkpointer 换持久化存储);
- LangGraph Platform:官方托管运行时,内置持久化、Cron、流式与人机审批 API;
- 队列化:长任务异步提交 + thread_id 轮询/推送结果。
生产检查清单
- State 最小化;每个节点幂等、异常不吞;
- 危险工具前
interrupt审批;工具调用全留痕; - 步数/token 预算熔断(recursion_limit 与自定义计数);
- 评测集回归(承接《评测 Harness》方法论)后再发版。
毕业路线:本模块 + 《Harness 架构》 + 《智能体编排》,你已经具备设计与运维生产级多智能体系统的完整知识栈。
📝 课后练习
quiz-1 调试生产级 LangGraph 智能体的推荐组合是?