Skip to main content

Interface: RAGOperationEntry

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

A single RAG operation within a request pipeline.

Properties​

collectionIds?​

optional collectionIds: string[]

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

Collection IDs involved in this operation.

costUSD​

costUSD: number

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

Estimated cost in USD for this operation.

dataSourceIds?​

optional dataSourceIds: string[]

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

Data source IDs queried by this operation.

durationMs​

durationMs: number

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

Duration in milliseconds.

graphDetails?​

optional graphDetails: object

Defined in: packages/agentos/src/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/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/rag/audit/RAGAuditTypes.ts:10

operationType​

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

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

relevanceScores?​

optional relevanceScores: object

Defined in: packages/agentos/src/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/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/rag/audit/RAGAuditTypes.ts:48

Number of results returned by this operation.

retrievalMethod?​

optional retrievalMethod: object

Defined in: packages/agentos/src/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/rag/audit/RAGAuditTypes.ts:34

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

startedAt​

startedAt: string

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

ISO 8601 timestamp when the operation started.

tokenUsage​

tokenUsage: object

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

Token usage breakdown for this operation.

embeddingTokens​

embeddingTokens: number

llmCompletionTokens​

llmCompletionTokens: number

llmPromptTokens​

llmPromptTokens: number

totalTokens​

totalTokens: number