Se usó la API de Cloud Translation para traducir esta página.

Configura el autocompletado avanzado

En esta página, se describe la función de autocompletado avanzada de la Búsqueda de Vertex AI.

Al igual que el autocompletado básico, el autocompletado avanzado genera sugerencias de consulta según los primeros caracteres ingresados para la consulta.

Antes de leer esta página, familiarízate con la función de autocompletado básica de Vertex AI Search. Consulta Configura la función de autocompletar.

Funciones clave del autocompletado avanzado

Las funciones clave del autocompletado avanzado que lo distinguen del básico son las siguientes:

Búsqueda combinada: El autocompletado avanzado se puede usar con apps de búsqueda combinada, que son apps de búsqueda genéricas conectadas a más de un almacén de datos.
Control de acceso: La función de autocompletar avanzada respeta los controles de acceso. (Los controles de acceso también se denominan LCA, listas de control de acceso). El autocompletado avanzado solo sugiere búsquedas relacionadas con los documentos a los que el buscador tiene acceso. Para obtener información sobre el control de acceso, consulta Cómo usar el control de acceso a la fuente de datos.
Fortalecimiento del idioma: El autocompletado avanzado se puede configurar para que fortalezca las sugerencias en uno o más idiomas. Por ejemplo, si el idioma del navegador es holandés, se podrían mejorar las sugerencias de autocompletado en ese idioma. Para obtener más información, consulta Cómo enviar una solicitud de autocompletado con un aumento de idioma.
Consultas recientes: Con el autocompletado avanzado, en lugar de sugerencias de consultas de autocompletado normales, los usuarios pueden obtener sus consultas recientes que coinciden con el prefijo de las letras que escriben. Para obtener más información, consulta Cómo enviar una solicitud de autocompletado y mostrar consultas recientes.

Antes de comenzar

Revisa y, de manera opcional, edita la configuración de autocompletado de tu app. Consulta Cómo actualizar la configuración de autocompletado.

En particular, cuando realices pruebas, para almacenes de datos más pequeños, te recomendamos que configures Habilitar autocompletado en Ahora. Esto se debe a que los almacenes de datos pequeños pueden no contener suficientes datos para proporcionar sugerencias precisas.

Envía solicitudes de Autocomplete

A continuación, se muestra cómo enviar solicitudes de autocompletado avanzadas con el método completionConfig.completeQuery.

REST

Para enviar una solicitud de autocompletado con la API, sigue estos pasos:

Busca el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.
1. En la consola de Google Cloud , ve a la página Agent Builder.
  
  Ve a Apps.
2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

Realiza una llamada al método completionConfig.completeQuery.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

PROJECT_ID: El ID de tu proyecto de Google Cloud .
APP_ID: El ID de la app de Vertex AI Search.
QUERY_STRING: Es la entrada de la función de escritura anticipada que se usa para recuperar sugerencias.

Envía una solicitud de autocompletar con un aumento de idioma

Puedes aumentar o disminuir las sugerencias de autocompletar según el código de idioma. Por ejemplo, puedes hacer que las sugerencias de autocompletar en algunos idiomas sean más o menos probables de aparecer.

El valor de aumento debe estar entre -1 y 1. Si estableces un número negativo, se “ocultan” las sugerencias de autocompletado en ese idioma, y un número positivo lo potencia.

Usa etiquetas de idioma de dos letras definidas por el BCP 47, por ejemplo, en, fr, hi y zh.

REST

Para enviar una solicitud de autocompletado que incluya un valor de aumento de idioma, sigue estos pasos:

Busca el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.
1. En la consola de Google Cloud , ve a la página Agent Builder.
  
  Ve a Apps.
2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

Realiza una llamada al método completionConfig.completeQuery.

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "boostSpec": {
         "conditionBoostSpecs": [{
           "condition": "(langCode: ANY(LANG_CODE))",
           "boost": BOOST_VALUE
         }]
      }
    }'

PROJECT_ID: El ID de tu proyecto de Google Cloud .
APP_ID: El ID de la app de Vertex AI Search.
QUERY_STRING: Es la entrada de la función de escritura anticipada que se usa para recuperar sugerencias.
LANG_CODE: Es el código de dos letras para uno o más idiomas, encerrado entre comillas. Por ejemplo, \"fr\", \"es\" para aplicar el valor de aumento al español y al francés.
BOOST_VALUE: Un número de punto flotante entre -1 y 1. Cuando el valor es negativo, se degradan las sugerencias automáticas en el idioma (aparecen más abajo en la lista de sugerencias). Cuando el valor es positivo, se promocionan las sugerencias (aparecen más arriba en la lista).

Comando de ejemplo

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
-d '{
     "query": { "text": "Co"}
     "boostSpec": {
        "conditionBoostSpecs": [{
          "condition": "(langCode: ANY(\"es\", \"fr\"))",
          "boost": 0.75 }, {
          "condition": "(langCode: ANY(\"en\"))",
          "boost": -1
        }]
      }
    }'

En este ejemplo, las sugerencias de autocompletado para la consulta Co se mejoran (se colocan más arriba en la lista de sugerencias automáticas) si están en francés o español, y se ocultan (se colocan más abajo en la lista de sugerencias automáticas) si están en inglés.

Envía una solicitud de autocompletado y muestra las búsquedas recientes

Muestra como sugerencias una lista de las consultas más recientes del usuario que coinciden con el prefijo de la consulta en la solicitud.

Las sugerencias de búsqueda que coinciden se muestran de la más reciente a la más antigua. Para usar la búsqueda reciente, se debe proporcionar el seudo-ID del usuario.

Ejemplo

Un empleado consulta el sitio de intranet de su empresa para obtener información sobre cómo tomar vacaciones. El empleado realizó las siguientes consultas, que se enumeran de la más reciente a la más antigua:

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences y Can I take unpaid time off?.

Ahora, en respuesta a que el empleado escribe vac en el cuadro de búsqueda, las sugerencias de autocompletado serían las siguientes:

Vacation blackout periods
How much vacation time do I have?
Vacation policy
Covering a vacant position during absences

Procedimiento

Para enviar una solicitud de autocompletado que devuelva las consultas más recientes del usuario, sigue estos pasos:

REST

Busca el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.
1. En la consola de Google Cloud , ve a la página Agent Builder.
  
  Ve a Apps.
2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

Realiza una llamada al método completionConfig.completeQuery.


curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

PROJECT_ID: El ID de tu proyecto de Google Cloud .
APP_ID: El ID de la app de Vertex AI Search.
QUERY_STRING: Es la entrada de escritura anticipada que se usa para recuperar sugerencias.
USER_PSEUDO_ID: Es un identificador seudónimo del usuario. Puedes usar una cookie HTTP para este campo, que identifica de forma única a un visitante en un solo dispositivo. No configures este campo con el mismo identificador para varios usuarios. Esto combinaría sus historiales de búsqueda. No incluyas información de identificación personal (PII) en este campo.

Ejemplo de comando y resultado

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
-d '{
      "query": "hol",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "test_user"
    }'

{
  "recentSearchSuggestions": [
    {
      "suggestion": "holiday readiness",
      "recentSearchTime": "2024-11-19T18:27:07.261698Z"
    },
    {
      "suggestion": "holiday freeze",
      "recentSearchTime": "2024-11-19T18:25:45.744021Z"
    },
    {
      "suggestion": "holiday",
      "recentSearchTime": "2024-11-19T18:20:08.916884Z"
    }
  ]
}

Usa una lista de bloqueo para autocompletar

Puedes usar una lista de bloqueo para evitar que términos específicos aparezcan como sugerencias de autocompletar.

Aunque el autocompletado avanzado se encuentra a nivel de la app, las listas de entidades bloqueadas se encuentran a nivel del almacén de datos. Esto es importante si tu app es una app de búsqueda combinada. Crea una lista de entidades rechazadas para cada almacén de datos conectado a la app.

Para obtener información sobre cómo crear y usar listas de bloqueo, consulta Usa una lista de bloqueo para autocompletar.