`agrag.retrieval`

Retrieval package: search engine, fusion, reranking, and retrievers.

Modules:

community_context – Community-report enrichment: local-search-style budget-capped context.
errors – Errors that the retrieval layer raises.
filters – Constraints applied across every retrieval method in one call.
fusion – Reciprocal Rank Fusion: combine ranked results from multiple methods.
methods – Low-level search method helpers shared by retrievers.
recipes – Named, data-only configurations of what SearchEngine runs.
rerank – Rerankers that reorder fused search results.
resolved_entities – Loading helpers for resolved entities.
retrievers – Retriever implementations for entity, chunk, BFS, and text2cypher search.
search_engine – Retrieval's public entry point, independent of Graph.
settings – Env-backed configuration for retrieval methods and fusion.
tracing – Span helpers shared by the retrieval spans.

Classes:

AllRetrievalMethodsFailedError – Every retrieval method a Recipe named failed.
BFSRetriever – Graph traversal from seed entity ids.
ChunkRetriever – Dense chunk search via vector similarity.
CommunityRetriever – Dense search over community reports, for direct thematic questions.
EntityRetriever – Dense entity search via vector similarity.
Recipe – A named configuration of what SearchEngine runs for a query.
RetrievalError – The base class for every retrieval error.
RetrievalSettings – Configuration for retrieval methods and fusion.
Retriever – One retrieval method: given a query, return SearchResults.
ScopeDeniedError – A request asked for data outside the caller's permitted scope.
SearchEngine – Retrieval's public entry point, independent of Graph.
SearchFilters – Constraints applied across every retrieval method in one call.
Text2CypherRetriever – Let the agent ask structured questions via generated Cypher.
UnknownRecipeMethodError – A Recipe named a method SearchEngine does not know how to run.

Attributes: