> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# DeepEvalExporter

評価と Observability のために、Tracing データを [Confident AI](https://www.confident-ai.com/) へ送信します。DeepEval SDK を基盤とする `@mastra/deepeval` からエクスポートされます。

セットアップと使用方法については、[Confident AI exporter](https://mastra.zisheng.pro/ja/docs/observability/integrations/exporters/confident-ai) を参照してください。

## コンストラクター

```typescript
new DeepEvalExporter(config?: DeepEvalExporterConfig)
```

## `DeepEvalExporterConfig`

```typescript
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`

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

Tracing イベントを Confident AI へエクスポートします。Mastra の Span ストリームから Trace ツリーを構築し、ルート Span の終了時に Trace を送信します。

### `flush`

```typescript
async flush(): Promise<void>
```

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

### `shutdown`

```typescript
async shutdown(): Promise<void>
```

開いている Trace を完了させ、保留中の送信をフラッシュします。

## 使用方法

### ゼロコンフィグ（環境変数を使用）

```typescript
import { DeepEvalExporter } from '@mastra/deepeval'

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

### 明示的な設定

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