Skip to content

docs: correct hybrid prefetch-limit and rag search-top-k defaults #145

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
WilliamAGH merged 1 commit into from
Jul 29, 2026
Merged

docs: correct hybrid prefetch-limit and rag search-top-k defaults #145

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ See [pipeline-commands.md](pipeline-commands.md#hybrid-qdrant-setup) for the col
- `QDRANT_COLLECTION_PDFS` (default `java-chat-qwen3-embedding-4b-2560-pdfs`)
- `QDRANT_DENSE_VECTOR_NAME` (default `dense`) — named vector for dense embeddings
- `QDRANT_SPARSE_VECTOR_NAME` (default `bm25`) — named vector for BM25 sparse tokens
- `HYBRID_PREFETCH_LIMIT` (default `20`) — per-stage prefetch limit for RRF fusion queries
- `HYBRID_PREFETCH_LIMIT` (default `14`) — per-stage prefetch limit for RRF fusion queries
- `HYBRID_RRF_K` (default `60`) — reciprocal-rank-fusion k parameter used by Qdrant query fusion
- `HYBRID_QUERY_TIMEOUT` (default `10s`) — timeout for hybrid search queries
- `APP_QDRANT_ENSURE_PAYLOAD_INDEXES` (default `true`) — create payload indexes on startup
Expand Down
4 changes: 2 additions & 2 deletions docs/retrieval-pipeline.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -275,7 +275,7 @@ All properties are bound via `AppProperties` (`@ConfigurationProperties(prefix =
|---|---|---|
| `app.qdrant.dense-vector-name` | `dense` | Named vector key for dense embeddings |
| `app.qdrant.sparse-vector-name` | `bm25` | Named vector key for sparse BM25 tokens |
| `app.qdrant.prefetch-limit` | `20` | Per-stage candidate count for each dense/sparse prefetch before RRF fusion |
| `app.qdrant.prefetch-limit` | `14` | Per-stage candidate count for each dense/sparse prefetch before RRF fusion |
| `app.qdrant.rrf-k` | `60` | RRF k parameter: `score = Sum(1 / (k + rank))` |
| `app.qdrant.query-timeout` | `10s` | Timeout for hybrid search fan-out across all collections |
| `app.qdrant.ensure-payload-indexes` | `true` | Create payload indexes on startup for metadata filtering |
Expand All @@ -296,7 +296,7 @@ All four must be non-blank and distinct (validated on startup).

| Property | Default | Validation | Description |
|---|---|---|---|
| `app.rag.search-top-k` | `12` | Must be > 0 | Candidates fetched from hybrid search before reranking |
| `app.rag.search-top-k` | `8` | Must be > 0 | Candidates fetched from hybrid search before reranking |
| `app.rag.search-return-k` | `6` | Must be > 0, must be <= `search-top-k` | Results returned to the LLM after reranking |
| `app.rag.reranker-timeout` | `8s` | Must be positive and less than `20s` | Timeout for LLM reranking call |
| `app.rag.search-citations` | `3` | Must be >= 0 | Citation references included in the response |
Expand Down
Loading