DeepEvalExporter

評価と Observability のために、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 キー。未指定の場合は CONFIDENT_API_KEY 環境変数を使用します。キーが見つからない場合、exporter は自身を無効にします。

environment?:

string

Trace の環境。未指定の場合は CONFIDENT_TRACE_ENVIRONMENT、次に 'development' を使用します。

name?:

string

すべての Trace に適用する名前。デフォルトは Mastra の serviceName です。

tags?:

string[]

すべての Trace に適用するタグ。

metadata?:

Record<string, any>

すべての Trace に適用するメタデータ。

threadId?:

string

すべての Trace に適用するスレッド ID。ルート Span のメタデータにある threadId は、リクエストごとにこの値を上書きします。

userId?:

string

すべての Trace に適用するユーザー ID。ルート Span のメタデータにある userId は、リクエストごとにこの値を上書きします。

testCaseId?:

string

すべての Trace に適用するテストケース ID。ルート Span のメタデータにある testCaseId は、リクエストごとにこの値を上書きします。

turnId?:

string

すべての Trace に適用するターン 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 管理プロンプトへのリンク。

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>

exporter をシャットダウンせず、処理中の Trace 送信が完了するまで待機します。

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 など）は破棄されます。