mcpField
L
langsmith-fetch

langsmith-fetch

github.com/langchain-aiAgent 工作流3950 次安装36 周前更新
代码仓库

关于 langsmith-fetch

langsmith-fetch 是用于将 LangSmith 跟踪记录保存到本地的命令行技能，面向排查 Agent 执行过程的开发者。它可获取近期记录或指定 ID 的记录，供检查执行细节。

主要功能

  1. 01获取近期跟踪记录
  2. 02按 ID 获取单条记录
  3. 03以 JSON 或可读文本保存
  4. 04检查工具调用及返回结果

适用场景

  1. 01排查 Agent 行为异常
  2. 02检查工具调用和返回数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/langchain-ai/lca-skills --skill langsmith-fetch

安装后在 Claude Code 中输入/langsmith-fetch确认已加载。

详细介绍

获取 LangSmith 跟踪记录

需要在项目依赖项中添加 langsmith-fetch，并在 .env 文件中设置 LANGSMITH_API_KEY。

设置

首先，找到包含 LANGSMITH_API_KEY 的 .env 文件：

find . -name ".env" -type f 2>/dev/null | head -5

命令

所有命令都使用 --env-file <path-to-.env>：

# Fetch recent traces (uses LANGSMITH_PROJECT from .env, or specify --project-uuid)
uv run --env-file <path> langsmith-fetch traces ./traces --limit 10
uv run --env-file <path> langsmith-fetch traces ./traces --project-uuid <uuid> --limit 10

# Fetch single trace by ID
uv run --env-file <path> langsmith-fetch trace <trace-id>

# Include metadata (timing, tokens, costs)
uv run --env-file <path> langsmith-fetch trace <trace-id> --include-metadata

输出格式

  • --format pretty - 人类可读（默认）
  • --format json - 美化格式的 JSON
  • --format raw - 适合管道传输的紧凑 JSON

故障排查工作流

  1. 查找 .env：find . -name ".env" -type f 2>/dev/null
  2. 获取近期跟踪记录：uv run --env-file <path> langsmith-fetch traces ./debug --limit 10
  3. 在保存的 JSON 文件中查找相关跟踪记录
  4. 检查：调用了哪些工具？它们返回了什么？结果是否正确／符合预期？

评论

支持 Markdown