LangSmith 生产 trace 排障手册 - LangSmith / LangChain Skill | AIasdf

将 LangSmith 可观测文档落成可重复的线上故障流程：从失败 run 或 thread 出发，用 UI 或 MCP（fetch_runs、get_thread_history）还原 Prompt、工具调用与错误，再用文档中的 FQL 过滤缩小范围；强调字符预算分页，并区分 Cloud OAuth Remote MCP 与自建 LANGSMITH_ENDPOINT。

分类调试与排障

平台 LangSmith / LangChain

发布时间 2026-05-19

langsmithtracingdebugging

使用场景

RAG 路由 5xx 或空回复
单会话违反政策
Prompt 变更后延迟升高
工具调用越权评审
trace 计费审计

主要功能

记录项目、run UUID、thread、版本与时间窗
用 fetch_runs 或 UI 打开根 run
分页拉全 thread/trace 载荷
按 span 归因到检索、工具、模型或下游
对比 Prompt Hub 最近良好 revision
写明缓解与 eval 防回归计划

相关推荐

相关推荐

3 收录条目

生产环境故障排查

调试与排障

在线上故障诊断的结构化方法，涵盖日志分类、指标峰值关联、发布窗口过滤和安全复现步骤。

使用 LLM 结构化输出做契约设计

先列出业务必须的字段并写成 schema（类型、required、枚举等），按厂商文档开启结构化输出；每次返回在服务端用同一 schema 校验后再进业务逻辑；对拒答或校验失败打日志并迭代提示词或拆分 schema。适用于抽取、向导状态、工具参数序列化等场景。

事故复盘写作

在故障后沉淀时间线、影响面、促成因素与可跟踪的后续项，让团队从事故里学习，而不是重复同一种意外。