Skip to main content

LangSmith 导出器

🌐 LangSmith Exporter

LangSmith 是 LangChain 用于监控和评估大语言模型（LLM）应用的平台。LangSmith 导出工具会将你的追踪数据发送到 LangSmith，从而提供模型性能的洞察、调试功能以及评估工作流程。

安装
Direct link to 安装

🌐 Installation

npm install @mastra/langsmith@latest

配置
Direct link to 配置

🌐 Configuration

先决条件
Direct link to 先决条件

🌐 Prerequisites

  1. LangSmith 账户：在 smith.langchain.com 注册
  2. API密钥：在LangSmith设置 → API密钥中生成API密钥
  3. 环境变量：设置你的凭据
.env
# Required
LANGSMITH_API_KEY=ls-xxxxxxxxxxxx

# Optional
LANGCHAIN_PROJECT=my-project  # Default project for traces
LANGSMITH_BASE_URL=https://api.smith.langchain.com  # For self-hosted

零配置设置
Direct link to 零配置设置

🌐 Zero-Config Setup

设置环境变量后，使用无配置的导出器：

🌐 With environment variables set, use the exporter with no configuration:

src/mastra/index.ts
import { Mastra } from "@mastra/core";
import { Observability } from "@mastra/observability";
import { LangSmithExporter } from "@mastra/langsmith";

export const mastra = new Mastra({
  observability: new Observability({
    configs: {
      langsmith: {
        serviceName: "my-service",
        exporters: [new LangSmithExporter()],
      },
    },
  }),
});

显式配置
Direct link to 显式配置

🌐 Explicit Configuration

你也可以直接传递凭据（优先于环境变量）：

🌐 You can also pass credentials directly (takes precedence over environment variables):

src/mastra/index.ts
import { Mastra } from "@mastra/core";
import { Observability } from "@mastra/observability";
import { LangSmithExporter } from "@mastra/langsmith";

export const mastra = new Mastra({
  observability: new Observability({
    configs: {
      langsmith: {
        serviceName: "my-service",
        exporters: [
          new LangSmithExporter({
            apiKey: process.env.LANGSMITH_API_KEY,
          }),
        ],
      },
    },
  }),
});

配置选项
Direct link to 配置选项

🌐 Configuration Options

完成配置
Direct link to 完成配置

🌐 Complete Configuration

new LangSmithExporter({
  // Required credentials
  apiKey: process.env.LANGSMITH_API_KEY!,

  // Optional settings
  apiUrl: process.env.LANGSMITH_BASE_URL, // Default: https://api.smith.langchain.com
  projectName: "my-project", // Project to send traces to (overrides LANGCHAIN_PROJECT env var)
  callerOptions: {
    // HTTP client options
    timeout: 30000, // Request timeout in ms
    maxRetries: 3, // Retry attempts
  },
  logLevel: "info", // Diagnostic logging: debug | info | warn | error

  // LangSmith-specific options
  hideInputs: false, // Hide input data in UI
  hideOutputs: false, // Hide output data in UI
});

环境变量
Direct link to 环境变量

🌐 Environment Variables

变量描述
LANGSMITH_API_KEY你的 LangSmith API 密钥（必填）
LANGCHAIN_PROJECT跟踪的默认项目名称（可选，默认值为“default”）
LANGSMITH_BASE_URL自建实例的 API URL（可选）

projectName 配置选项优先于 LANGCHAIN_PROJECT 环境变量，使你能够通过编程方式将追踪路由到不同的项目。

🌐 The projectName config option takes precedence over the LANGCHAIN_PROJECT environment variable, allowing you to programmatically route traces to different projects.

🌐 Related

目录