Una vez que hayas creado y, además, implementado el índice, puedes ejecutar consultas para obtener los vecinos más cercanos.
Estos son algunos ejemplos de una consulta de coincidencia para encontrar los vecinos más cercanos mediante el algoritmo de k-vecinos más cercanos (k-NN).
Ejemplos de consultas para el extremo público
Python
Python
Curl
El publicEndpointDomainName
que se muestra a continuación se puede encontrar en Implementar y tiene el formato <number>.<region>-<number>.vdb.vertexai.goog
.
$ curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer `gcloud auth print-access-token`" https://1957880287.us-central1-181224308459.vdb.vertexai.goog/v1/projects/181224308459/locations/us-central1/indexEndpoints/3370566089086861312:findNeighbors -d '{deployed_index_id: "test_index_public1", queries: [{datapoint: {datapoint_id: "0", feature_vector: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]}, neighbor_count: 5}]}'
En este ejemplo de curl, se muestra cómo llamar desde clientes de http(s)
, aunque el extremo público admite el protocolo doble para RESTful y grpc_cli
.
$ curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer `gcloud auth print-access-token`" https://1957880287.us-central1-181224308459.vdb.vertexai.goog/v1/projects/${PROJECT_ID}/locations/us-central1/indexEndpoints/${INDEX_ENDPOINT_ID}:readIndexDatapoints -d '{deployed_index_id:"test_index_public1", ids: ["606431", "896688"]}'
En este ejemplo con curl, se muestra cómo realizar consultas con restricciones numéricas y de token.
$ curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer `gcloud auth print-access-token`" https://${PUBLIC_ENDPOINT_DOMAIN}/v1/projects/${PROJECT_ID}/locations/${LOCATION}/indexEndpoints/${INDEX_ENDPOINT_ID}:findNeighbors -d '{deployed_index_id:"${DEPLOYED_INDEX_ID}", queries: [{datapoint: {datapoint_id:"x", feature_vector: [1, 1], "sparse_embedding": {"values": [111.0,111.1,111.2], "dimensions": [10,20,30]}, numeric_restricts: [{namespace: "int-ns", value_int: -2, op: "GREATER"}, {namespace: "int-ns", value_int: 4, op: "LESS_EQUAL"}, {namespace: "int-ns", value_int: 0, op: "NOT_EQUAL"}], restricts: [{namespace: "color", allow_list: ["red"]}]}}]}'
Console
Usa estas instrucciones para consultar un índice implementado en un extremo público desde la consola.
- En la sección de Vertex AI de la consola de Google Cloud, ve a la sección Implementación y uso. Elige Vector Search
- Selecciona el índice que deseas consultar. Se abrirá la página Index info.
- Desplázate hacia abajo hasta la sección Índices implementados y selecciona el índice implementado que deseas consultar. Se abrirá la página Deployed index info.
- En la sección Índice de consulta, selecciona si quieres consultar por un valor de incorporación denso, un valor de incorporación disperso, un valor de incorporación híbrido (incorporaciones densas y dispersas) o un dato específico.
- Ingresa los parámetros de búsqueda del tipo de consulta que seleccionaste. Por ejemplo, si haces consultas por una incorporación densa, ingresa el vector de incorporación que deseas consultar.
- Ejecuta la consulta con el comando curl proporcionado o a través de la ejecución con Cloud Shell.
- Si usas Cloud Shell, selecciona Ejecutar en Cloud Shell.
- Ejecuta en Cloud Shell.
- Los resultados muestran los vecinos más cercanos.
Para ver un ejemplo de extremo a extremo sobre cómo crear un índice, cómo implementarlo en un extremo público y cómo realizar consultas, visita el notebook oficial Usa Vertex Vector Search y Vertex AI Embeddings for Text para preguntas de StackOverflow.
Configuración del tiempo de consulta que afecta el rendimiento
Los siguientes parámetros de tiempo de consulta pueden afectar la latencia, la disponibilidad y el costo cuando se usa Vector Search. Esta guía se aplica en la mayoría de los casos. Sin embargo, siempre experimenta con tus opciones de configuración a fin de asegurarte de que funcionen para tu caso de uso.
Para ver las definiciones de parámetros, consulta Parámetros de configuración de índices.
Parámetro | Acerca de | Impacto en el rendimiento |
---|---|---|
approximateNeighborsCount |
Indica al algoritmo la cantidad de resultados aproximados que se recuperarán de cada fragmentación.
El valor de |
Aumentar el valor de
Disminuir el valor de
|
setNeighborCount |
Especifica la cantidad de resultados que deseas que muestre la consulta. |
Los valores inferiores o iguales a 300 siguen teniendo un rendimiento en la mayoría de los casos de uso. Para valores más altos, prueba tu caso de uso específico. |
fractionLeafNodesToSearch |
Controla el porcentaje de nodos de hoja que se visitarán cuando se busquen vecinos más cercanos. Esto se relaciona con leafNodeEmbeddingCount , ya que cuantas más incorporaciones por nodo de hoja, más datos se examinan por hoja.
|
Aumentar el valor de
Disminuir el valor de
|
¿Qué sigue?
- Obtén más información sobre cómo actualizar y volver a compilar el índice.
- Obtén información sobre cómo filtrar coincidencias de vectores.
- Obtén más información sobre cómo supervisar un índice.