用途：在开发中为应用添加 LangSmith 追踪，或查询、导出 LangSmith 的 trace 数据。
主要能力：一是接入追踪。对 LangChain/LangGraph 应用，追踪自动生效，只需设置环境变量，例如 export LANGSMITH_TRACING=true、LANGSMITH_API_KEY、OPENAI_API_KEY 等，可用 LANGSMITH_PROJECT 指定项目。其他框架需按对应 references 文件操作，路由顺序为：有专门参考文件则用其；有原生 OpenTelemetry 无专门文件则用 references/otel.md；无框架或不支持则用 references/traceable.md；无法运行 SDK 才用 references/api.md。二是查询数据。使用 langsmith CLI，命令分 trace（完整执行树，推荐优先）与 run（单个节点）。可 langsmith trace list 列表、get 获取层级、export 导出为 JSONL，支持 --limit、--project、--last-n-minutes、--since、--error、--min-latency、--min-tokens、--tags、--filter 等过滤，还可 --include-metadata、--show-hierarchy。导出需 --include-io 或 --full 才含输入输出。
使用方式：认证必需，设置 LANGSMITH_API_KEY 环境变量，或给 CLI 传 --api-key（推荐）。CLI 安装命令为 curl -sSL https://raw.githubusercontent.com/langchain-ai/langsmith-cli/main/scripts/install.sh | sh。查询前先检查 LANGSMITH_PROJECT，以确定相关 trace 所在项目。
限制与注意：查询 trace 时过滤器仅作用于根 run，run 则作用于任意匹配 run，且仅 run 支持 --run-type。不同框架接入方式差异大，选错模式会产生重复或缺失的 span。缺少的事实（如具体收费、配额、平台支持细节）暂未提供。