Interface RAGAuditTrail

Aggregated audit trail for a complete RAG request.

interface RAGAuditTrail {
    trailId: string;
    requestId: string;
    seedId?: string;
    sessionId?: string;
    query: string;
    timestamp: string;
    operations: RAGOperationEntry[];
    summary: {
        totalOperations: number;
        totalLLMCalls: number;
        totalEmbeddingCalls: number;
        totalTokens: number;
        totalPromptTokens: number;
        totalCompletionTokens: number;
        totalEmbeddingTokens: number;
        totalCostUSD: number;
        totalDurationMs: number;
        operationTypes: string[];
        sourceSummary: {
            uniqueDocuments: number;
            uniqueCollections: number;
            uniqueDataSources: number;
        };
    };
}

Properties

trailId requestId seedId? sessionId? query timestamp operations summary

Properties

trailId

trailId: string

requestId

requestId: string

Correlates with the conversation turn or API request.

Optional seedId

seedId?: string

Wunderland agent seed ID.

Optional sessionId

sessionId?: string

Conversation session ID.

query

query: string

The user query that triggered RAG.

timestamp

timestamp: string

ISO 8601 timestamp.

operations

operations: RAGOperationEntry[]

Per-operation breakdown.

summary

summary: {
    totalOperations: number;
    totalLLMCalls: number;
    totalEmbeddingCalls: number;
    totalTokens: number;
    totalPromptTokens: number;
    totalCompletionTokens: number;
    totalEmbeddingTokens: number;
    totalCostUSD: number;
    totalDurationMs: number;
    operationTypes: string[];
    sourceSummary: {
        uniqueDocuments: number;
        uniqueCollections: number;
        uniqueDataSources: number;
    };
}

Aggregated summary across all operations.

Type declaration

  • totalOperations: number
  • totalLLMCalls: number
  • totalEmbeddingCalls: number
  • totalTokens: number
  • totalPromptTokens: number
  • totalCompletionTokens: number
  • totalEmbeddingTokens: number
  • totalCostUSD: number
  • totalDurationMs: number
  • operationTypes: string[]

    Unique operation types used (e.g. ['embedding', 'vector_query', 'rerank']).

  • sourceSummary: {
        uniqueDocuments: number;
        uniqueCollections: number;
        uniqueDataSources: number;
    }
    • uniqueDocuments: number
    • uniqueCollections: number
    • uniqueDataSources: number

Settings

Member Visibility

Theme

On This Page

trailIdrequestIdseedIdsessionIdquerytimestampoperationssummary