LangGraph 如何与 LangSmith 集成实现可观测性？

1. 自动追踪机制

启用 LangSmith 追踪非常简单，只需设置三个环境变量：LANGSMITH_TRACING=true、LANGSMITH_API_KEY 和 LANGSMITH_PROJECT。此后图中每一次 LLM 调用、工具执行和节点转换都会被自动记录为结构化 trace。每个节点对应一个 span，包含输入输出状态、延迟、token 消耗等详细信息。

2. 结构化调试能力

与简单的日志不同，LangSmith 提供的 trace 是高度结构化的：可以看到 Agent 的完整执行路径、每个节点的 state 快照、模型的中间推理步骤。排查问题时，可以通过 thread_id 重现失败的运行，逐节点检查 state 何时偏离预期，将故障定位时间从小时级缩短到分钟级。

3. LangSmith Studio 可视化调试

Studio 是 LangGraph 的可视化开发环境，以交互式图表渲染图的结构，支持单步执行、状态检查和 checkpoint 回放。开发者可以在 Studio 中查看条件边的实际路由决策、编辑 prompt 后即时 replay、对比不同版本的执行轨迹。对于包含循环和分支的复杂图，Studio 的可视化能力显著降低了调试难度。

4. 评估与持续改进

LangSmith 还提供数据集管理、自动化评估和 A/B 实验功能。可以将生产 trace 转化为测试用例，使用 LLM-as-judge 自动评分，量化不同版本 Agent 的性能差异。2026 年新增的多轮评估（Multi-turn evals）可以衡量端到端的对话质量，包括语义意图、语义结果和 Agent 轨迹。