Esta página se ha traducido con Cloud Translation API.

Configurar la función Autocompletar avanzada

En esta página se describe la función de autocompletar avanzada de Aplicaciones de IA.

Al igual que la función de autocompletar básica, la función de autocompletar avanzada genera sugerencias de consulta en función de los primeros caracteres introducidos en la consulta.

Antes de leer esta página, familiarízate con la función de autocompletar básica de Aplicaciones de IA. Consulta cómo configurar la función de autocompletar.

Funciones principales de la función de autocompletar avanzada

Estas son las principales funciones de la función Autocompletar avanzada que la diferencian de la básica:

Búsqueda combinada: la función de autocompletar avanzada se puede usar con aplicaciones de búsqueda combinada, que son aplicaciones de búsqueda personalizadas 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 listas de control de acceso (LCAs). La función de autocompletar avanzada solo sugiere consultas de búsqueda relacionadas con documentos a los que tiene acceso el usuario que realiza la búsqueda. Para obtener información sobre el control de acceso, consulta Usar el control de acceso a fuentes de datos.

Mejora del idioma: la función Autocompletar avanzado se puede configurar para mejorar las sugerencias en uno o varios idiomas. Por ejemplo, si el idioma del navegador es el neerlandés, se podrían potenciar las sugerencias de autocompletar en ese idioma. Para obtener más información, consulta Enviar una solicitud de autocompletado con un refuerzo de idioma.

Consultas recientes: con la función de autocompletar avanzada, en lugar de recibir sugerencias de consulta de autocompletar normales, los usuarios pueden ver sus consultas recientes que coincidan con las letras que escriben. Para obtener más información, consulta Enviar una solicitud de autocompletado y devolver consultas recientes.

Antes de empezar

Antes de empezar a usar la función de autocompletar avanzada, haz lo siguiente:

Revisa y edita (opcionalmente) los ajustes de autocompletar de tu aplicación. Consulta Actualizar los ajustes de autocompletar.
En los almacenes de datos más pequeños, selecciona Habilitar autocompletar y, a continuación, Ahora. Te recomendamos que lo hagas porque es posible que los almacenes de datos pequeños no contengan suficientes datos para ofrecer sugerencias precisas.
Si tus almacenes de datos contienen información personal identificable (IPI) o si usas el modelo de sugerencias de consultas del historial de búsqueda o de eventos de usuario, consulta el artículo Protección contra filtraciones de IPI y configura las protecciones de prevención de pérdida de datos (DLP) que puedan ser necesarias para evitar filtraciones de IPI.

Enviar solicitudes de autocompletado

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

REST

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

Busca el ID de tu aplicación. Si ya tienes el ID de tu aplicación, ve al siguiente paso.
1. En la Google Cloud consola, ve a la página Aplicaciones de IA.
  
  Ir a Aplicaciones
2. En la página Aplicaciones, busca el nombre de tu aplicación y consulta su ID en la columna ID.

Llama 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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

Haz los cambios siguientes:

PROJECT_ID: el ID de tu proyecto de Google Cloud .
APP_ID: el ID de la aplicación Vertex AI Search.
QUERY_STRING: la entrada de escritura predictiva que se usa para obtener sugerencias.

Enviar una solicitud de autocompletado con un refuerzo de idioma

Puedes destacar o ocultar sugerencias de autocompletar según el código de idioma. Por ejemplo, puedes hacer que las sugerencias de autocompletar en algunos idiomas tengan más o menos probabilidades de aparecer.

El valor de impulso debe estar comprendido entre -1 y 1. Si se asigna un número negativo, las sugerencias de autocompletar en ese idioma se "ocultan", mientras que si se asigna un número positivo, se potencian.

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

REST

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

Busca el ID de tu aplicación. Si ya tienes el ID de tu aplicación, ve al siguiente paso.
1. En la Google Cloud consola, ve a la página Aplicaciones de IA.
  
  Ir a Aplicaciones
2. En la página Aplicaciones, busca el nombre de tu aplicación y consulta su ID en la columna ID.

Llama 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/v1/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
         }]
      }
    }'

Haz los cambios siguientes:

PROJECT_ID: el ID de tu proyecto de Google Cloud .
APP_ID: el ID de la aplicación Vertex AI Search.
QUERY_STRING: la entrada de escritura anticipada que se usa para obtener sugerencias.
LANG_CODE: el código de dos letras de uno o varios idiomas entre comillas de escape. Por ejemplo, \"fr\", \"es\" para aplicar el valor de impulso al español y al francés.
BOOST_VALUE: número de punto flotante entre -1 y 1. Si el valor es negativo, las sugerencias automáticas en el idioma se rebajan (aparecen más abajo en la lista de sugerencias). Si el valor es positivo, las sugerencias se promocionan (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 autocompletar de la consulta Co se potencian (se colocan más arriba en la lista de sugerencias automáticas) si están en francés o en español, y se ocultan (se colocan más abajo en la lista de sugerencias automáticas) si están en inglés.

Enviar una solicitud de autocompletado y devolver consultas recientes

Devuelve, como sugerencias, una lista de las consultas más recientes del usuario que coincidan con el prefijo de la consulta de la solicitud.

Las sugerencias de consulta coincidentes se muestran de la más reciente a la más antigua. Para usar la búsqueda reciente, debe proporcionarse el ID pseudo del usuario.

Ejemplo

Un empleado está consultando el sitio de la intranet de su empresa para obtener información sobre cómo pedir vacaciones. El empleado ha realizado las siguientes consultas, ordenadas 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, si el empleado escribe vac en el cuadro de búsqueda, las sugerencias de autocompletar 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 aplicación. Si ya tienes el ID de tu aplicación, ve al siguiente paso.
1. En la Google Cloud consola, ve a la página Aplicaciones de IA.
  
  Ir a Aplicaciones
2. En la página Aplicaciones, busca el nombre de tu aplicación y consulta su ID en la columna ID.

Llama 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/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

Haz los cambios siguientes:

PROJECT_ID: el ID de tu proyecto de Google Cloud .
APP_ID: el ID de la aplicación Vertex AI Search.
QUERY_STRING: la entrada de escritura anticipada que se usa para obtener sugerencias.
USER_PSEUDO_ID: identificador seudonimizado del usuario. Puede usar una cookie HTTP para este campo, que identifica de forma única a un visitante en un solo dispositivo. No asigne el mismo identificador a varios usuarios. De esta forma, se combinarían sus historiales de consultas. No incluya información personal identificable 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/v1/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": "2025-05-19T18:27:07.261698Z"
    },
    {
      "suggestion": "holiday freeze",
      "recentSearchTime": "2025-05-19T18:25:45.744021Z"
    },
    {
      "suggestion": "holiday",
      "recentSearchTime": "2025-05-19T18:20:08.916884Z"
    }
  ]
}

Usar una lista de elementos no permitidos para la función Autocompletar

Puedes usar una lista de denegación para evitar que aparezcan términos específicos como sugerencias de autocompletado.

Aunque la función Autocompletar avanzada se aplica a nivel de aplicación, las listas de denegación se aplican a nivel de almacén de datos. Esto es importante si tu aplicación es una aplicación de búsqueda combinada. Crea una lista de denegación para cada almacén de datos conectado a la aplicación.

Para obtener información sobre cómo crear y usar listas de denegación, consulta Usar una lista de denegación de autocompletar.

Usar una lista importada de sugerencias de autocompletar

Puede proporcionar su propia lista de sugerencias de Autocompletar en lugar de usar las sugerencias generadas a partir de un modelo de datos de Autocompletar.

Para obtener información sobre cómo importar una lista, consulta el artículo Usar una lista importada de sugerencias de autocompletado.

Configurar la función Autocompletar avanzada Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Funciones principales de la función de autocompletar avanzada

Antes de empezar

Enviar solicitudes de autocompletado

REST

Enviar una solicitud de autocompletado con un refuerzo de idioma

REST

Comando de ejemplo

Enviar una solicitud de autocompletado y devolver consultas recientes

Ejemplo

Procedimiento

REST

Ejemplo de comando y resultado

Usar una lista de elementos no permitidos para la función Autocompletar

Usar una lista importada de sugerencias de autocompletar

Configurar la función Autocompletar avanzada