DeepEvalExporter

추적 데이터를 다음으로 보냅니다.Confident AI평가 및 Observability을 위해. 수출자@mastra/deepeval, DeepEval SDK를 기반으로 구축되었습니다.

설정 및 사용법은 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- 로거 인스턴스
• 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 관리형 Prompt 링크입니다.

debug?:

boolean

exporter 구성 및 내보내기 오류를 콘솔에 기록합니다.

traceCaptureSink?:

(trace: Trace) => void

완료된 Trace를 Confident AI에 게시하지 않고 로컬에서 수신합니다. 오프라인 평가에 사용하세요.

logLevel?:

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

로거 레벨(기본값: 'info')

행동 양식

exportTracingEvent

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

추적 이벤트를 Confident AI로 내보냅니다. Mastra 범위 스트림에서 추적 트리를 구축하고 루트 범위가 끝나면 추적을 게시합니다.

flush

async flush(): Promise<void>

내보내기를 종료하지 않고 진행 중인 추적 게시물이 정착될 때까지 기다립니다.

shutdown

async shutdown(): Promise<void>

열려 있는 모든 추적을 마무리하고 보류 중인 게시물을 플러시합니다.

용법

Zero-Config(환경 변수 사용)

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',
})

스팬 유형 매핑

마스트라 스팬 유형	자신 있는 AI 스팬 유형
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
내보낸 기타 모든 범위 유형	CUSTOM

이벤트 span(예: MODEL_CHUNK)은 삭제됩니다.