LangSmithExporter

將 Tracing 資料傳送至 LangSmith，以進行可觀測性分析。

建構函式

new LangSmithExporter(config: LangSmithExporterConfig)

LangSmithExporterConfig

interface LangSmithExporterConfig extends ClientConfig, BaseExporterConfig {
  client?: Client
  projectName?: string
}

同時擴充 ClientConfig（來自 LangSmith SDK）與 BaseExporterConfig：

• 來自 BaseExporterConfig：logger?: IMastraLogger、logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'
• 來自 ClientConfig：apiKey、apiUrl、callerOptions、hideInputs、hideOutputs 等

方法

exportTracingEvent

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

將 tracing 事件匯出至 LangSmith。

flush

async flush(): Promise<void>

強制將所有待處理 span flush 至 LangSmith，而不關閉 exporter。這在 serverless 環境中特別實用，可確保 runtime 結束前已匯出 span。

shutdown

async shutdown(): Promise<void>

結束所有作用中的 span，並清除 trace map。

使用方式

import { LangSmithExporter } from '@mastra/langsmith'

const exporter = new LangSmithExporter({
  apiKey: process.env.LANGSMITH_API_KEY,
  projectName: 'my-project', // Optional: specify which project to send traces to
  apiUrl: 'https://api.smith.langchain.com',
  logLevel: 'info',
})

環境變數

變數	說明
LANGSMITH_API_KEY	您的 LangSmith API key
LANGCHAIN_PROJECT	Trace 的預設專案名稱（未指定 projectName 時使用）
LANGSMITH_BASE_URL	自行代管執行個體的 API URL

Span 類型對應

Span 類型	LangSmith 類型
MODEL_GENERATION	llm
MODEL_CHUNK	llm
TOOL_CALL	tool
MCP_TOOL_CALL	tool
PROVIDER_TOOL_CALL	tool
所有其他類型	chain

withLangsmithMetadata

用於將 LangSmith 專屬 metadata 新增至 tracing 選項的 helper 函式。

function withLangsmithMetadata(metadata: LangSmithMetadataInput): TracingOptionsUpdater

LangSmithMetadataInput

使用方式

import { buildTracingOptions } from '@mastra/observability'
import { withLangsmithMetadata } from '@mastra/langsmith'

// Route to a specific project
const tracingOptions = buildTracingOptions(withLangsmithMetadata({ projectName: 'my-project' }))

// Set multiple fields
const tracingOptions = buildTracingOptions(
  withLangsmithMetadata({
    projectName: 'my-project',
    sessionId: 'user-123',
  }),
)