LangSmith Agent 调试
通过 LangSmith 追踪记录排查 LangChain/LangGraph Agent 的错误、工具调用、记忆和性能问题。
技能说明
适合 Agent 运行复盘、故障定位和性能分析。需要 langsmith-fetch CLI、LANGSMITH_API_KEY 和 LANGSMITH_PROJECT；追踪可能含敏感提示词与业务数据，分享前必须脱敏。
关于此技能
来自 ComposioHQ/awesome-claude-skills，专注 LangChain 与 LangGraph Agent 运行追踪和故障排查的可复用流程。
核心能力
近期追踪排查
查看最近 traces，整理错误、工具调用、执行时长和 Token 使用情况。
单次追踪深挖
根据 trace ID 还原执行顺序、工具结果、失败点、根因和修复建议。
批量导出与统计
导出 traces 或 threads，统计错误类型、出现频率、时长和资源使用。
问题定位报告
把原始运行记录整理成可读的故障摘要和下一步排查建议。
适用场景
LangChain/LangGraph Agent 失败排查
快速查看最近运行记录，定位报错发生在哪个工具或步骤。
检查工具调用、记忆与 Token 使用
分析 Agent 的工具链、记忆操作、执行时间和成本信号。
导出调试会话
保存一段时间内的 traces 和 threads，供团队复盘或后续分析。
使用步骤
- 01
准备环境
安装 langsmith-fetch，设置 LANGSMITH_API_KEY 和 LANGSMITH_PROJECT，并确认有目标项目访问权。
- 02
快速扫描
查询最近一段时间的 traces，先列出错误、工具调用和性能异常。
- 03
单次深挖
提供 trace ID，按执行顺序检查工具结果、错误消息和可能的根因。
- 04
导出与修复
需要复盘时导出带元数据的记录，再由人工决定修复方案和发布范围。
常见问题
需要 API Key 吗？+
需要。API Key 和项目名称通过环境变量提供，不能写进公开文档或提交到代码仓库。
会自动修改线上 Agent 吗？+
不会。技能只读取或导出追踪并提出建议，修复和上线仍需人工执行。
其他 Agent 框架也能用吗？+
它主要面向 LangChain/LangGraph；只有当其他框架的运行记录进入 LangSmith 且字段兼容时，分析才可能有效。
追踪内容有隐私风险吗？+
有。trace 可能包含提示词、工具结果和业务数据，分享前应脱敏，并只连接获授权的项目。
pip install langsmith-fetch；设置 LANGSMITH_API_KEY 和 LANGSMITH_PROJECT；将 langsmith-fetch 技能目录放入 Agent Skills 目录