You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[DOC-12715] Document New Search Request Params for Search Fine-Tuning (#291)
* [quickfix]: quickfix: strange font problem on diagram (#274)
Seems to have been caused by extra space in the label.
* [DOC-12610]: Document `nprobe` tweaking
* [DOC=12610]: Moved fine-tuning menu entry.
[DOC=12610]: Moved the stem declaration; wasn't working in the old position.
* [DOC=12610]:
Moved and reworded the sections for clarity.
Adding link to search-index-params.adoc
* [DOC-12715] Add documentation to the JSON search request example and topics around the new added memory-efficient setting and the params object for probe and centroid tuning
* [DOC-12715] Adding on to Ray's documentation to provide a link to Search Request Params.
* [DOC-12715] Comments from peer review
---------
Co-authored-by: Ray Offiah <[email protected]>
Co-authored-by: Ray Offiah <[email protected]>
Copy file name to clipboardExpand all lines: modules/search/pages/search-request-params.adoc
+34Lines changed: 34 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -281,6 +281,40 @@ If you reduce your `ivf_max_codes_pct` value, the Search Service accesses fewer
281
281
In the example, the Search Service searches only `0.2%` of the available centroids in your vector data.
282
282
|====
283
283
284
+
[#knn-params]
285
+
=== Knn params Object
286
+
287
+
Use the `params` object inside a `knn` object to fine tune the probes and centroids the Search Services uses and searches while running a Vector Search request.
288
+
289
+
The `params` object can contain the following properties:
290
+
291
+
[cols="1,1,1,4"]
292
+
|====
293
+
|Property |Type |Required? |Description
294
+
295
+
|ivf_nprobe_pct |Number (percentage) |No a|
296
+
297
+
Set the `ivf_nprobe_pct` value to control the percentage of probes, or the percentage of clusters, that the Search Service searches during a single Vector Search query.
298
+
299
+
The Search Service automatically calculates a default `nprobe` percentage based on the vectors in a given partition of your Vector Search index.
300
+
For more information about this calculation, see xref:vector-search:fine-tune-vector-search.adoc[].
301
+
302
+
If you set the value of `ivf_nprobe_pct` higher than this default calculated value, the Search Service will search a higher percentage of clusters in your processed vectors.
303
+
This can increase your accuracy and recall for Vector Search, but requires more compute time for each query.
304
+
305
+
In the example, the Search Service searches only `1%` of the total available clusters.
306
+
307
+
|ivf_max_codes_pct |Number (percentage out of 100) |No a|
308
+
309
+
Set the `ivf_max_codes_pct` value to control the maximum number of centroids that the Search Service accesses during a single Vector Search query.
310
+
311
+
By default, this value is always 100%.
312
+
313
+
If you reduce your `ivf_max_codes_pct` value, the Search Service accesses fewer centroids, which reduces your Vector Search accuracy and recall, but gives faster compute times for your search.
314
+
315
+
In the example, the Search Service searches only `0.2%` of the available centroids in your vector data.
0 commit comments