用途:langsmith-fetch 用于调试 LangChain 与 LangGraph 智能体,通过命令行从 LangSmith Studio 拉取执行轨迹,在终端内排查智能体行为、错误、工具调用、内存操作、性能与 Token 用量。
主要能力:获取最近轨迹并汇总成功/失败数、调用的工具、执行时长与 Token 用量;对指定 trace ID 深度分析执行流、失败点与根因;将轨迹与会话(threads)导出到本地目录;按时间范围过滤;支持 pretty、json、raw 三种输出格式;支持包含元数据与并发抓取。
使用方式:先安装 pip install langsmith-fetch;设置环境变量 export LANGSMITH_API_KEY="your_langsmith_api_key" 和 export LANGSMITH_PROJECT="your_project_name",可用 echo 验证。常用命令包括:langsmith-fetch traces --last-n-minutes 5 --limit 5 --format pretty、langsmith-fetch trace <trace-id> --format json、langsmith-fetch traces ./debug-session --last-n-minutes 30 --limit 50、langsmith-fetch threads --limit 10。可通过 langsmith-fetch config show 和 langsmith-fetch config set project "your-project-name" 调整配置。
适用场景:智能体无响应、调用错误工具、内存不生效、性能变慢、需要检查报错与失败率,以及在提交代码前做健康检查或导出问题轨迹留存。
限制:依赖 LangSmith API Key 与项目名配置;若未启用追踪(如 LANGCHAIN_TRACING_V2=true)或时间范围内无活动,会找不到轨迹;错误排查时需自行结合输出做根因分析与修复建议。关于收费、价格与更多平台支持,资料暂未提供。