Skip to content

Adds weight parameter type definition for RRF retrievers. #5502

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Adds weight parameter type definition for RRF retrievers. #5502

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
846bcfa
Added weight to the documentation
mridula-s109 Oct 16, 2025
94d46eb
Merge branch 'main' into add-weighted-rrf-retriever-types
mridula-s109 Oct 22, 2025
127d4a8
Resolved PR comments
mridula-s109 Oct 22, 2025
98516a4
Update Retriever.ts
mridula-s109 Oct 22, 2025
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
13 changes: 11 additions & 2 deletions specification/_types/Retriever.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -134,8 +134,8 @@ export class KnnRetriever extends RetrieverBase {
}

export class RRFRetriever extends RetrieverBase {
/** A list of child retrievers to specify which sets of returned top documents will have the RRF formula applied to them. */
retrievers: RetrieverContainer[]
/** A list of child retrievers to specify which sets of returned top documents will have the RRF formula applied to them. Each retriever can optionally include a weight parameter. */
retrievers: RRFRetrieverContainer[]
/** This value determines how much influence documents in individual result sets per query have over the final ranked result set. */
rank_constant?: integer
/** This value determines the size of the individual result sets per query. */
Expand All @@ -144,6 +144,15 @@ export class RRFRetriever extends RetrieverBase {
fields?: string[]
}

/**
* RRF retriever container supporting both direct and weighted formats.
* @variants container
*/
export class RRFRetrieverContainer extends RetrieverContainer {
/** Weight multiplier for this retriever's contribution to the RRF score. Higher values increase influence. Defaults to 1.0 if not specified. Must be non-negative. */
weight?: float
}

export class TextSimilarityReranker extends RetrieverBase {
/** The nested retriever which will produce the first-level results, that will later be used for reranking. */
retriever: RetrieverContainer
Expand Down
Loading