用途：为应用添加 LangSmith 追踪，并查询、导出追踪数据。适用于 LangChain/LangGraph 应用、使用 OpenTelemetry 的框架，以及无框架或需手动埋点的应用。
主要能力：LangChain/LangGraph 应用设置环境变量即可自动追踪；非 LangChain 应用可用 OpenTelemetry 集成，或用 traceable 装饰器/包装器并包装 LLM 客户端（如 wrap_openai、wrapOpenAI）。CLI 支持 trace、run、dataset、example、evaluator、experiment、thread、project 等命令组，可列出、获取、导出 trace 与 run，并管理数据集、示例、评估器、实验和会话线程。
必要用法：设置 LANGSMITH_API_KEY（必填），可选 LANGSMITH_PROJECT、LANGSMITH_WORKSPACE_ID。查询前先检查环境变量或 .env 中的 LANGSMITH_PROJECT。安装 CLI：curl -sSL https://raw.githubusercontent.com/langchain-ai/langsmith-cli/main/scripts/install.sh | sh。常用命令如 langsmith trace list --limit 10 --project my-project、langsmith trace get <trace-id>、langsmith trace export ./traces --limit 20 --full。
关键区别：trace 是完整执行树（根 run 加所有子 run），run 是树中单个节点。trace 过滤仅作用于根 run，返回完整层级，导出为每 trace 一个文件的目录；run 过滤作用于任意匹配 run，返回扁平列表，导出为单个 JSONL 文件。导出字段含 run_id、trace_id、name、run_type、parent_run_id、inputs、outputs，需 --include-io 或 --full 才含输入输出。
限制：资料未提供收费、价格、平台支持范围及具体效果数据；使用前需自行准备 API Key 与项目信息。