Skip to content

Commit 7c42e10

Browse files
committed
added headings to result composition
1 parent 6f6e334 commit 7c42e10

File tree

1 file changed

+12
-2
lines changed

1 file changed

+12
-2
lines changed

articles/search/vector-search-how-to-query.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,15 +81,25 @@ The expected response is 202 for a successful call to the deployed model. The bo
8181

8282
## Configure a query response
8383

84-
When you're setting up the vector query, think about the response structure. Search results are composed of either all "retrievable" fields (a REST API default) or the fields explicitly listed in a "select" parameter on the query. In the examples that follow, each one includes a "select" statement that specifies text (non-vector) fields to include the response.
84+
When you're setting up the vector query, think about the response structure. You can control the shape of the response by choosing which fields are in the results and how many results are included. The search engine ranks the results. Ranking algorithms aren't generally configurable.
85+
86+
### Fields in a response
87+
88+
Search results are composed of either all "retrievable" fields (a REST API default) or the fields explicitly listed in a "select" parameter on the query. In the examples that follow, each one includes a "select" statement that specifies text (non-vector) fields to include the response.
8589

8690
Vectors aren't designed for readability, so avoid returning them in the response. Instead, choose non-vector fields that are representative of the search document. For example, if the query targets a "descriptionVector" field, return an equivalent text field if you have one ("description") in the response.
8791

88-
Size of the results is determined by the query parameters "k" and "top". Maximum results in a response are either:
92+
### Number of results
93+
94+
A query might match to any number of documents, up to all of them in the search index if the search criteria is weak. However, the size of the results sent back in the response is determined by the query parameters "k" and "top". Maximum results in a response are either:
8995

9096
+ `"k": n` results for vector-only queries
9197
+ `"top": n` results for hybrid queries
9298

99+
Both "k" and "top" are optional. Unspecified, the default number of results in a response is 50. You can set "top" and "skip" to [page through more results](search-pagination-page-layout.md#paging-results).
100+
101+
### Ranking
102+
93103
Ranking of results is computed by either:
94104

95105
+ The similarity metric specified in the index `vectorConfiguration` for a vector-only query.

0 commit comments

Comments
 (0)