DeepEvalExporter

将 Tracing 数据发送到 Confident AI，用于评估和可观测性。由基于 DeepEval SDK 构建的 @mastra/deepeval 导出。

有关设置和用法，请参阅 Confident AI exporter。

构造函数

new DeepEvalExporter(config?: DeepEvalExporterConfig)

DeepEvalExporterConfig

interface DeepEvalExporterConfig extends BaseExporterConfig {
  apiKey?: string
  environment?: string
  name?: string
  tags?: string[]
  metadata?: Record<string, any>
  threadId?: string
  userId?: string
  testCaseId?: string
  turnId?: string
  metricCollection?: string
  traceMetricCollection?: string
  llmMetricCollection?: string
  agentMetricCollection?: string
  toolMetricCollectionMap?: Record<string, string>
  prompt?: Prompt
  debug?: boolean
  traceCaptureSink?: (trace: Trace) => void
}

扩展 BaseExporterConfig，其中包含：

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

apiKey?:

string

Confident AI API key。未设置时使用 CONFIDENT_API_KEY 环境变量。找不到 key 时，Exporter 会自行禁用。

environment?:

string

Trace 环境。依次使用 CONFIDENT_TRACE_ENVIRONMENT 和 'development' 作为默认值。

name?:

string

应用到每条 Trace 的名称。默认使用 Mastra serviceName。

tags?:

string[]

应用到每条 Trace 的 tag。

metadata?:

Record<string, any>

应用到每条 Trace 的元数据。

threadId?:

string

应用到每条 Trace 的 thread ID。根 Span 元数据中的 threadId 会按请求覆盖此值。

userId?:

string

应用到每条 Trace 的 user ID。根 Span 元数据中的 userId 会按请求覆盖此值。

testCaseId?:

string

应用到每条 Trace 的 test case ID。根 Span 元数据中的 testCaseId 会按请求覆盖此值。

turnId?:

string

应用到每条 Trace 的 turn ID。根 Span 元数据中的 turnId 会按请求覆盖此值。

metricCollection?:

string

Trace 级指标集合。

traceMetricCollection?:

string

Trace 级指标集合。优先级高于 metricCollection。

llmMetricCollection?:

string

应用到 LLM Span 的指标集合。

agentMetricCollection?:

string

应用到 Agent Span 的指标集合。

toolMetricCollectionMap?:

Record<string, string>

按 Tool 名称应用的指标集合。

prompt?:

Prompt

附加到 LLM Span 的 Confident AI 托管 prompt 关联信息。

debug?:

boolean

将 Exporter 配置和导出错误记录到控制台。

traceCaptureSink?:

(trace: Trace) => void

在本地接收已完成的 Trace，而不将其发送到 Confident AI。用于离线评估。

logLevel?:

'debug' | 'info' | 'warn' | 'error'

logger 级别（默认值：'info'）

方法

exportTracingEvent

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

将 Tracing 事件导出到 Confident AI。根据 Mastra Span 流构建 Trace 树，并在根 Span 结束时发送 Trace。

flush

async flush(): Promise<void>

等待所有正在发送的 Trace 完成，而不关闭 Exporter。

shutdown

async shutdown(): Promise<void>

完成所有未结束的 Trace，并刷新待发送数据。

用法

零配置（使用环境变量）

import { DeepEvalExporter } from '@mastra/deepeval'

// Reads from CONFIDENT_API_KEY, CONFIDENT_TRACE_ENVIRONMENT
const exporter = new DeepEvalExporter()

显式配置

import { DeepEvalExporter } from '@mastra/deepeval'

const exporter = new DeepEvalExporter({
  apiKey: process.env.CONFIDENT_API_KEY,
  environment: 'production',
})

Span 类型映射

Mastra Span 类型	Confident AI Span 类型
AGENT_RUN, WORKFLOW_RUN	AGENT
MODEL_GENERATION	LLM
TOOL_CALL, MCP_TOOL_CALL, PROVIDER_TOOL_CALL, CLIENT_TOOL_CALL	TOOL
RAG_EMBEDDING, RAG_VECTOR_OPERATION	RETRIEVER
所有其他导出的 Span 类型	CUSTOM

事件 Span（例如 MODEL_CHUNK）会被丢弃。