Skip to main content

Interface: RAGOperationEntry

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:9

A single RAG operation within a request pipeline.

Properties​

collectionIds?​

optional collectionIds: string[]

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:57

Collection IDs involved in this operation.


costUSD​

costUSD: number

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:45

Estimated cost in USD for this operation.


dataSourceIds?​

optional dataSourceIds: string[]

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:54

Data source IDs queried by this operation.


durationMs​

durationMs: number

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:23

Duration in milliseconds.


graphDetails?​

optional graphDetails: object

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:60

Graph-specific details (for graph_local / graph_global operations).

communitiesSearched​

communitiesSearched: number

entitiesMatched​

entitiesMatched: number

traversalTimeMs​

traversalTimeMs: number


hydeDetails?​

optional hydeDetails: object

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:74

HyDE-specific details (for hyde operations).

effectiveThreshold​

effectiveThreshold: number

Final similarity threshold after adaptive stepping.

hypothesis​

hypothesis: string

The generated hypothetical answer used for embedding.

thresholdSteps​

thresholdSteps: number

Number of adaptive threshold steps taken.


operationId​

operationId: string

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:10


operationType​

operationType: "embedding" | "rerank" | "hyde" | "vector_query" | "graph_local" | "graph_global" | "ingest"

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:11


relevanceScores?​

optional relevanceScores: object

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:51

Relevance score statistics across results.

avg​

avg: number

max​

max: number

min​

min: number


rerankDetails?​

optional rerankDetails: object

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:67

Reranking-specific details (for rerank operations).

documentsReranked​

documentsReranked: number

modelId​

modelId: string

providerId​

providerId: string


resultsCount​

resultsCount: number

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:48

Number of results returned by this operation.


retrievalMethod?​

optional retrievalMethod: object

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:26

Retrieval strategy details (for vector_query operations).

hybridAlpha?​

optional hybridAlpha: number

mmrLambda?​

optional mmrLambda: number

strategy​

strategy: "hybrid" | "similarity" | "mmr"

topK?​

optional topK: number


sources​

sources: RAGSourceAttribution[]

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:34

Source documents/chunks that contributed to this operation's results.


startedAt​

startedAt: string

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:21

ISO 8601 timestamp when the operation started.


tokenUsage​

tokenUsage: object

Defined in: packages/agentos/src/cognition/rag/audit/RAGAuditTypes.ts:37

Token usage breakdown for this operation.

embeddingTokens​

embeddingTokens: number

llmCompletionTokens​

llmCompletionTokens: number

llmPromptTokens​

llmPromptTokens: number

totalTokens​

totalTokens: number