Skip to main content

Braintrust 导出器

🌐 Braintrust Exporter

Braintrust 是一个评估和监控平台，帮助你衡量和提升大型语言模型（LLM）应用的质量。Braintrust 导出器会将你的追踪数据发送到 Braintrust，从而实现系统化的评估、评分和实验。

安装
Direct link to 安装

🌐 Installation

npm install @mastra/braintrust@latest

配置
Direct link to 配置

🌐 Configuration

先决条件
Direct link to 先决条件

🌐 Prerequisites

  1. Braintrust 账户：在 braintrust.dev 注册
  2. 项目：创建或选择一个项目以存储你的跟踪
  3. API 密钥：在 Braintrust 设置 → API 密钥 中生成
  4. 环境变量：设置你的凭据：
.env
BRAINTRUST_API_KEY=sk-xxxxxxxxxxxxxxxx

# Optional
BRAINTRUST_ENDPOINT=https://api.braintrust.dev  # Custom endpoint if needed

零配置设置
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 { BraintrustExporter } from "@mastra/braintrust";

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

显式配置
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 { BraintrustExporter } from "@mastra/braintrust";

export const mastra = new Mastra({
  observability: new Observability({
    configs: {
      braintrust: {
        serviceName: "my-service",
        exporters: [
          new BraintrustExporter({
            apiKey: process.env.BRAINTRUST_API_KEY,
            projectName: "my-project",
          }),
        ],
      },
    },
  }),
});

完成配置
Direct link to 完成配置

🌐 Complete Configuration

new BraintrustExporter({
  // Required
  apiKey: process.env.BRAINTRUST_API_KEY!,

  // Optional settings
  projectName: "my-project", // Default: 'mastra-tracing'
  endpoint: "https://api.braintrust.dev", // Custom endpoint if needed
  logLevel: "info", // Diagnostic logging: debug | info | warn | error
});

🌐 Related

目录