[KNN] Add query vector builder (#2028) (#2029)

* Add query_vector_builder to the knn search object

* Add contrib update

* Move QueryVector type to knn types, change its type to float

* Make QueryVectorBuilder a container to reflect its nature server-side

* make contrib

* Add deprecation notice for knn_search.Request

Co-authored-by: Laurent Saint-Félix <[email protected]>

Author: github-actions[bot]

output/schema/schema.json

@@ -27,6 +27,7 @@ import { FieldAndFormat } from '@_types/query_dsl/abstractions'
 /**
  * @rest_spec_name knn_search
  * @since 8.0.0
+ * @deprecated 8.4.0
  * @stability experimental
  */
 export interface Request extends RequestBase {

output/schema/validation-errors.json

@@ -18,9 +18,8 @@
  */
 
 import { Field } from '@_types/common'
-import { long, double } from '@_types/Numeric'
-
-export type QueryVector = double[]
+import { long, float } from '@_types/Numeric'
+import { QueryVector } from '@_types/Knn'
 
 export interface Query {
   /** The name of the vector field to search against */

output/typescript/types.ts

@@ -21,11 +21,15 @@ import { Field } from '@_types/common'
 import { long, double, float } from '@_types/Numeric'
 import { QueryContainer } from './query_dsl/abstractions'
 
+export type QueryVector = float[]
+
 export interface KnnQuery {
   /** The name of the vector field to search against */
   field: Field
   /** The query vector */
-  query_vector: double[]
+  query_vector?: QueryVector
+  /** The query vector builder. You must provide a query_vector_builder or query_vector, but not both. */
+  query_vector_builder?: QueryVectorBuilder
   /** The final number of nearest neighbors to return as top hits */
   k: long
   /** The number of nearest neighbor candidates to consider per shard */
@@ -35,3 +39,13 @@ export interface KnnQuery {
   /** Filters for the kNN search query */
   filter?: QueryContainer | QueryContainer[]
 }
+
+/** @variants container */
+export interface QueryVectorBuilder {
+  text_embedding?: TextEmbedding
+}
+
+export interface TextEmbedding {
+  model_id: string
+  model_text: string
+}