用途:为应用添加 LangSmith 追踪,并查询、导出 trace 数据。适用于 LangChain/LangGraph 应用、使用 OpenTelemetry 的框架,以及无框架应用的手动埋点。
主要能力:LangChain/LangGraph 应用设置 LANGSMITH_TRACING=true、LANGSMITH_API_KEY 等环境变量即可自动追踪;非 LangChain 应用可用 OpenTelemetry 集成,或用 traceable 装饰器/包装器并 wrap_openai/wrapOpenAI 包装 LLM 客户端,支持嵌套追踪。CLI 提供 trace、run、dataset、example、evaluator、experiment、thread、project 等命令组。trace 针对根 run 过滤并返回完整层级,run 针对任意 run 过滤并返回扁平列表;trace export 每个 trace 一个 JSONL 文件,run export 输出单个扁平 JSONL 文件。
使用方式:认证必需,设置 LANGSMITH_API_KEY 或向 CLI 传 --api-key。安装:curl -sSL https://raw.githubusercontent.com/langchain-ai/langsmith-cli/main/scripts/install.sh | sh。常用命令如 langsmith trace list --limit 10 --project my-project --api-key $LANGSMITH_API_KEY、langsmith trace get <trace-id>、langsmith trace export ./traces --limit 20 --full。支持时间、错误、延迟、token、标签及 --filter 原始查询等筛选。查询前应检查 LANGSMITH_PROJECT。
限制:CLI 反馈功能需 v0.2.58 及以上,且仅面向 LangSmith Cloud(含 BYOC 中继),独立自托管跳过;反馈不得包含密钥、客户数据、trace 载荷、提示词、完整堆栈、命令输出、原始参数、环境变量值、本地路径或资源标识。其余平台、收费与效果信息暂未提供。