Skip to main content

Class: RAGOperationHandle

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:52

Fluent handle for a single in-flight RAG operation. Call .complete(resultsCount) to finalize timing and add it to the collector.

Constructors

Constructor

new RAGOperationHandle(type, onComplete): RAGOperationHandle

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:58

Parameters

type

"embedding" | "vector_query" | "graph_local" | "graph_global" | "ingest" | "rerank"

onComplete

(entry) => void

Returns

RAGOperationHandle

Methods

addSources()

addSources(chunks): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:86

Parameters

chunks

object[]

Returns

this


complete()

complete(resultsCount, overrideDurationMs?): RAGOperationEntry

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:153

Finalizes the operation, records duration, computes relevance score stats, and adds the entry to the parent collector.

Parameters

resultsCount

number

Number of results this operation produced.

overrideDurationMs?

number

Optional override for duration (when timing is measured externally).

Returns

RAGOperationEntry


setCollectionIds()

setCollectionIds(ids): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:131

Parameters

ids

string[]

Returns

this


setCost()

setCost(costUSD): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:121

Parameters

costUSD

number

Returns

this


setDataSourceIds()

setDataSourceIds(ids): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:126

Parameters

ids

string[]

Returns

this


setGraphDetails()

setGraphDetails(details): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:136

Parameters

details
communitiesSearched

number

entitiesMatched

number

traversalTimeMs

number

Returns

this


setRerankDetails()

setRerankDetails(details): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:141

Parameters

details
documentsReranked

number

modelId

string

providerId

string

Returns

this


setRetrievalMethod()

setRetrievalMethod(method): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:81

Parameters

method

{ hybridAlpha?: number; mmrLambda?: number; strategy: "hybrid" | "similarity" | "mmr"; topK?: number; } | undefined

Returns

this


setTokenUsage()

setTokenUsage(usage): this

Defined in: packages/agentos/src/rag/audit/RAGAuditCollector.ts:116

Parameters

usage
embeddingTokens

number

llmCompletionTokens

number

llmPromptTokens

number

totalTokens

number

Returns

this