BraintrustExporter

将跟踪数据发送到 Braintrust 进行评估和监控。

🌐 Sends Tracing data to Braintrust for eval and observability.

构造函数

🌐 Constructor

new BraintrustExporter(config: BraintrustExporterConfig)

BraintrustExporterConfig

interface BraintrustExporterConfig extends BaseExporterConfig {
  apiKey?: string;
  endpoint?: string;
  projectName?: string;
  tuningParameters?: Record<string, any>;
}

扩展自 BaseExporterConfig，包括：

🌐 Extends BaseExporterConfig, which includes:

• logger?: IMastraLogger - 记录器实例
• logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error' - 日志级别（默认：INFO）

方法

🌐 Methods

exportTracingEvent

async exportTracingEvent(event: TracingEvent): Promise<void>

将跟踪事件导出到 Braintrust。

🌐 Exports a tracing event to Braintrust.

export

async export(spans: ReadOnlySpan[]): Promise<void>

批量导出跨度到 Braintrust。

🌐 Batch exports spans to Braintrust.

flush

async flush(): Promise<void>

强制将任何缓冲的跨度刷新到 Braintrust，而不关闭导出器。在无服务器环境中非常有用，因为你需要确保在运行时终止之前导出跨度。

🌐 Force flushes any buffered spans to Braintrust without shutting down the exporter. Useful in serverless environments where you need to ensure spans are exported before the runtime terminates.

shutdown

async shutdown(): Promise<void>

刷新待处理的数据并关闭客户端。

🌐 Flushes pending data and shuts down the client.

用法

🌐 Usage

零配置（使用环境变量）

🌐 Zero-Config (using environment variables)

import { BraintrustExporter } from "@mastra/braintrust";

// Reads from BRAINTRUST_API_KEY, BRAINTRUST_ENDPOINT
const exporter = new BraintrustExporter();

显式配置

🌐 Explicit Configuration

import { BraintrustExporter } from "@mastra/braintrust";

const exporter = new BraintrustExporter({
  apiKey: process.env.BRAINTRUST_API_KEY,
  projectName: "my-ai-project",
});

跨度类型映射

🌐 Span Type Mapping

跨度类型	Braintrust 类型
MODEL_GENERATION	llm
MODEL_CHUNK	llm
TOOL_CALL	tool
MCP_TOOL_CALL	tool
WORKFLOW_CONDITIONAL_EVAL	function
WORKFLOW_WAIT_EVENT	function
其他所有	task