Skip to content

Commit 4e7f594

Browse files
committed
Removing tech-preview header and documentation for retrievers and RRF
1 parent 7ad1a0c commit 4e7f594

File tree

4 files changed

+6
-25
lines changed

4 files changed

+6
-25
lines changed

docs/reference/search/retriever.asciidoc

Lines changed: 1 addition & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
[[retriever]]
22
=== Retriever
33

4-
preview::["This functionality is in technical preview and may be changed or removed in a future release. The syntax will likely change before GA. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features."]
5-
64
A retriever is a specification to describe top documents returned from a
75
search. A retriever replaces other elements of the <<search-search, search API>>
86
that also return top documents such as <<query-dsl, `query`>> and
@@ -75,7 +73,7 @@ Collapses the top documents by a specified key into a single top document per ke
7573
===== Restrictions
7674

7775
When a retriever tree contains a compound retriever (a retriever with two or more child
78-
retrievers) *only* the query element is allowed.
76+
retrievers) the <<search-after, search after>> parameter is not supported.
7977

8078
[discrete]
8179
[[standard-retriever-example]]
@@ -245,12 +243,6 @@ include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=rrf-rank-window-size]
245243

246244
include::{es-ref-dir}/rest-api/common-parms.asciidoc[tag=rrf-filter]
247245

248-
===== Restrictions
249-
250-
An RRF retriever is a compound retriever. Child retrievers may not use
251-
elements that are restricted by having a compound retriever as part of
252-
the retriever tree.
253-
254246
[discrete]
255247
[[rrf-retriever-example-hybrid]]
256248
==== Example: Hybrid search
@@ -413,10 +405,6 @@ Applies the specified <<query-dsl-bool-query, boolean query filter>> to the chil
413405
If the child retriever already specifies any filters, then this top-level filter is applied in conjuction
414406
with the filter defined in the child retriever.
415407

416-
===== Restrictions
417-
418-
A text similarity re-ranker retriever is a compound retriever. Child retrievers may not use elements that are restricted by having a compound retriever as part of the retriever tree.
419-
420408
[discrete]
421409
[[text-similarity-reranker-retriever-example-cohere]]
422410
==== Example: Cohere Rerank

docs/reference/search/rrf.asciidoc

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
[[rrf]]
22
=== Reciprocal rank fusion
33

4-
preview::["This functionality is in technical preview and may be changed or removed in a future release. The syntax will likely change before GA. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features."]
5-
64
https://plg.uwaterloo.ca/~gvcormac/cormacksigir09-rrf.pdf[Reciprocal rank fusion (RRF)]
75
is a method for combining multiple result sets with different relevance indicators into a single result set.
86
RRF requires no tuning, and the different relevance indicators do not have to be related to each other to achieve high-quality results.
@@ -99,13 +97,8 @@ The `rrf` retriever supports:
9997
The `rrf` retriever does not currently support:
10098

10199
* <<search-api-scroll-query-param, scroll>>
102-
* <<search-api-pit, point in time>>
103100
* <<search-sort-param, sort>>
104101
* <<rescore, rescore>>
105-
* <<search-suggesters, suggesters>>
106-
* <<highlighting, highlighting>>
107-
* <<collapse-search-results, collapse>>
108-
* <<profiling-queries, profiling>>
109102

110103
Using unsupported features as part of a search with an `rrf` retriever results in an exception.
111104

docs/reference/search/search-your-data/retrievers-overview.asciidoc

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,7 @@
11
[[retrievers-overview]]
22
=== Retrievers
33

4-
preview::[]
5-
6-
A retriever is an abstraction that was added to the Search API in *8.14.0*.
4+
A retriever is an abstraction that was added to the Search API in *8.14.0* and has been made GA in *8.16.0*.
75
This abstraction enables the configuration of multi-stage retrieval pipelines within a single `_search` call.
86
This simplifies your search application logic, because you no longer need to configure complex searches via multiple {es} calls or implement additional client-side logic to combine results from different queries.
97

@@ -32,8 +30,7 @@ with different relevance indicators into a single result set.
3230
An RRF retriever is a *compound retriever*, where its `filter` element is
3331
propagated to its sub retrievers.
3432
+
35-
Sub retrievers may not use elements that are restricted by having a compound retriever as part of the retriever tree.
36-
See the <<rrf-using-multiple-standard-retrievers,RRF documentation>> for detailed examples and information on how to use the RRF retriever.
33+
3734
* <<text-similarity-reranker-retriever,*Text Similarity Re-ranker Retriever*>>. Used for <<semantic-reranking,semantic reranking>>.
3835
Requires first creating a `rerank` task using the <<put-inference-api,{es} Inference API>>.
3936

server/src/main/java/org/elasticsearch/search/retriever/CompoundRetrieverBuilder.java

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,9 @@ public ActionRequestValidationException validate(
194194
validationException
195195
);
196196
}
197+
for (RetrieverSource innerRetriever : innerRetrievers) {
198+
validationException = innerRetriever.retriever().validate(source, validationException, allowPartialSearchResults);
199+
}
197200
return validationException;
198201
}
199202

0 commit comments

Comments
 (0)