Query

The query method is designed to retrieve the most similar vectors from the index, using the specific distance metric defined for your index. This method supports a variety of options to configure the query to your needs.

The dimension of the query vector must match the dimension of your index.

Arguments

Payload

QueryOptions

required

Hide child attributes

vector

number[]

required

The query vector

topK

number

required

The total number of the vectors that you want to recieve as a query result. The response will be sorted based on the distance metric score, and topK vectors will be returned.

includeMetadata

boolean

Whether to include the metadata of the vectors in the response. Setting this true would be the best practice, since it will make it easier to identify the vectors.

includeVectors

boolean

The metadata of the vector. This is used to make it easier to identify the vector on queries.

Response

QueryResponse

Vector[]

required

Hide child attributes

id

string | number

required

The ID of the resulting vector.

score

number

required

The score of the vector data, calculated based on the distance metric of your index.

vector

number[]

required

The resulting vector.

metadata

Record<string, unknown>

The metadata of the vector. This is used to make it easier to identify the vector on queries.