Skip to main content

Interface: RagRetrievalDiagnostics

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:182

Diagnostics emitted by retrieval operations.

Properties​

dataSourceHits?​

optional dataSourceHits: Record<string, number>

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:188


effectiveDataSourceIds?​

optional effectiveDataSourceIds: string[]

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:189


embeddingTimeMs?​

optional embeddingTimeMs: number

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:183


hyde?​

optional hyde: object

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:200

HyDE-specific diagnostics, populated when HyDE retrieval is active.

  • hypothesis: The generated (or pre-supplied) hypothetical answer.
  • hypothesisLatencyMs: Time spent generating the hypothesis via LLM.
  • effectiveThreshold: Final similarity threshold after adaptive stepping.
  • thresholdSteps: Number of times the threshold was lowered before results were found (0 means the initial threshold succeeded).

effectiveThreshold​

effectiveThreshold: number

hypothesis​

hypothesis: string

hypothesisLatencyMs​

hypothesisLatencyMs: number

thresholdSteps​

thresholdSteps: number


messages?​

optional messages: string[]

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:190


policy?​

optional policy: object

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:206

confidence​

confidence: RetrievalConfidenceSummary

escalations​

escalations: string[]

profile​

profile: MemoryRetrievalProfile


rerankingTimeMs?​

optional rerankingTimeMs: number

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:185


retrievalTimeMs?​

optional retrievalTimeMs: number

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:184


strategyUsed?​

optional strategyUsed: "hybrid" | "similarity" | "mmr"

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:187


totalTokensInContext?​

optional totalTokensInContext: number

Defined in: packages/agentos/src/cognition/rag/IRetrievalAugmentor.ts:186