你的LangChain Agent报错了？一行命令从LangSmith拉trace排查根因

你的 LangChain Agent 报错了，但日志里只有一行 “Error”？

做 AI 应用的开发者，大概都遇到过这种崩溃感：Agent 明明跑了、结果却不对，打开 LangSmith Studio 刷了半天，手动复制 trace ID、再粘进去，效率感人。

今天挖到一个 CLI 工具——LangSmith Fetch，专门解决这个痛点。装上之后，在终端里敲几个命令，LangSmith 上的 traces 和 threads 全部拉回来，还能直接做根因分析。

它能做什么

LangSmith Fetch 是 LangChain 官方出的 CLI，通过简单的命令直接从 LangSmith Studio 批量拉取 traces 和 threads，省去在网页上来回点。

核心场景：

• 🐛 快速排错：Agent 报错了？一行命令拉最近 5 分钟的 traces，工具会按「成功/失败」分类列出每个 trace 的工具调用、耗时、token 消耗。
• 🔍 单条深挖：给一个 trace ID，直接拿到完整执行流——Agent 试图做什么、哪个工具失败了、root cause 在哪一步，全部结构化输出。
• 📊 性能分析：批量导出 traces 并附带 metadata，分析耗时分布、token 消耗、慢操作瓶颈。
• 💾 会话导出：把一次调试会话的所有 traces 和 threads 打包导出，方便归档或发给同事。

安装和使用

pip install langsmith-fetch

export LANGSMITH_API_KEY="lsv2_..."
export LANGSMITH_PROJECT="your-project-name"

常用命令：

# 拉最近 traces（推荐用法，自动存文件）
langsmith-fetch traces ./my-traces --limit 10

# 查单条 trace
langsmith-fetch trace <trace-id> --format json

# 按时间过滤（比如只看最近 30 分钟）
langsmith-fetch traces --last-n-minutes 30 --limit 50

# 导出完整调试会话
langsmith-fetch traces ./debug-session --last-n-minutes 30 --limit 50 --include-metadata

输出的格式支持 pretty（默认，带颜色的人类可读格式）、json（语法高亮 JSON）和 raw（紧凑单行，适合 pipe 给 jq 之类工具）。

注意事项

⚠️ 官方已标注 deprecated：LangChain 官方维护的 langsmith-fetch 仓库已停止更新，官方推荐迁移到 langsmith-skills。不过 CLI 本身功能完整且独立维护，暂时没有强制迁移的必要。

适合谁用：日常在 LangSmith 上调试 LangChain/LangGraph Agent 的工程师，以及需要频繁导出 traces 做离线分析的团队。

GitHub: https://github.com/langchain-ai/langsmith-fetch（CLI 核心包）| Skill 文件: https://github.com/ComposioHQ/awesome-claude-skills/tree/master/langsmith-fetch（Claude Code 集成版）

GitHub: https://github.com/langchain-ai/langsmith-fetch