Configura el autocompletado avanzado

En esta página, se describe la función avanzada de autocompletar de Agent Search.

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

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

Funciones clave de la función avanzada de autocompletar

Las funciones clave de la función avanzada de autocompletar que la distinguen de la función básica de autocompletar son las siguientes:

  • Búsqueda combinada: La función avanzada de autocompletar se puede usar con apps de búsqueda combinada, es decir, apps de búsqueda personalizadas que están conectadas a más de un almacén de datos.

  • Control de acceso: La función avanzada de autocompletar respeta los controles de acceso. (Los controles de acceso también se conocen como LCA o listas de control de acceso). La función avanzada de autocompletar solo sugiere consultas de búsqueda relacionadas con documentos a los que el buscador tiene acceso. Para obtener información sobre el control de acceso, consulta Usa el control de acceso a la fuente de datos.

  • Optimización de idioma: La función avanzada de autocompletar se puede configurar para optimizar las sugerencias en uno o más idiomas. Por ejemplo, si el idioma del navegador es neerlandés, se podrían optimizar las sugerencias de autocompletar en ese idioma. Para obtener más información, consulta Envía una solicitud de autocompletar con una optimización de idioma.
  • Consultas recientes: Con la función avanzada de autocompletar, en lugar de las sugerencias de consultas de autocompletar habituales, los usuarios pueden obtener sus consultas recientes que coincidan con el prefijo de las letras que escriben. Para obtener más información, consulta Envía una solicitud de autocompletar y muestra las consultas recientes.

Antes de comenzar

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

  • Revisa y, de manera opcional, edita la configuración de autocompletar de tu app. Consulta Actualiza la configuración de autocompletar.

  • Para los almacenes de datos más pequeños, establece Habilitar autocompletar en Ahora. Te recomendamos que lo hagas porque es posible que los almacenes de datos pequeños no contengan datos suficientes para proporcionar sugerencias precisas.

  • Si tus almacenes de datos contienen información de identificación personal (PII) o si usas el modelo de sugerencias de consultas de historial de búsqueda o eventos del usuario, revisa Protección contra filtraciones de PII y configura las protecciones de prevención de pérdida de datos (DLP) que podrían ser necesarias para evitar filtraciones de PII.

Envía solicitudes de autocompletar

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

REST

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

  1. Encuentra el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.

    1. En la Google Cloud consola de, ve a la página AI Applications.

      Ve a Apps.

    2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

  2. Realiza una llamada al completionConfig.completeQuery método.

    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"
    }'

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID de tu Google Cloud proyecto.

    • APP_ID: el ID de la app de Agent Search.

    • QUERY_STRING: la entrada de escritura anticipada que se usa para recuperar sugerencias.

Envía una solicitud de autocompletar con una optimización de idioma

Puedes optimizar o ocultar las 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 optimización debe estar entre -1 y 1. Si estableces un número negativo, se "ocultan" las sugerencias de autocompletar en ese idioma, y un número positivo optimiza el idioma.

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

REST

Para enviar una solicitud de autocompletar que incluya un valor de optimización de idioma, sigue estos pasos:

  1. Encuentra el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.

    1. En la Google Cloud consola de, ve a la página AI Applications.

      Ve a Apps.

    2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

  2. Realiza una llamada al completionConfig.completeQuery método.

    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
         }]
      }
    }'

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID de tu Google Cloud proyecto.

    • APP_ID: el ID de la app de Agent Search.

    • QUERY_STRING: la entrada de escritura anticipada que se usa para recuperar sugerencias.

    • LANG_CODE: el código de dos letras para uno o más idiomas, entre comillas de escape. Por ejemplo, \"fr\", \"es\" para aplicar el valor de optimización al español y al francés.

    • BOOST_VALUE: un número de punto flotante entre -1 y 1. Cuando el valor es negativo, las sugerencias automáticas en el idioma se degradan (aparecen más abajo en la lista de sugerencias). Cuando el valor es positivo, las sugerencias se promocionan (aparecen más arriba en la lista).

Envía una solicitud de autocompletar y muestra las consultas recientes

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

Las sugerencias de consultas coincidentes se enumeran 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, enumeradas 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 escriba 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 autocompletar que muestre las consultas más recientes del usuario, sigue estos pasos:

REST

  1. Encuentra el ID de tu app. Si ya tienes el ID de tu app, ve al siguiente paso.

    1. En la Google Cloud consola de, ve a la página AI Applications.

      Ve a Apps.

    2. En la página Apps, busca el nombre de tu app y obtén su ID de la columna ID.

  2. Realiza una llamada al completionConfig.completeQuery método.

    
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"
    }'

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID de tu Google Cloud proyecto.

    • APP_ID: el ID de la app de Agent Search.

    • QUERY_STRING: la entrada de escritura anticipada que se usa para recuperar sugerencias.

    • USER_PSEUDO_ID: un identificador seudonimizado del usuario. Puedes usar una cookie HTTP para este campo, que identifica de forma única a un visitante en un solo dispositivo. No establezcas este campo en el mismo identificador para varios usuarios. Esto combinaría sus historiales de consultas. No incluyas información de identificación personal (PII) en este campo.

Usa una lista de bloqueo para autocompletar

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

Si bien la función avanzada de autocompletar está a nivel de la app, las listas de bloqueo están a nivel del almacén de datos. Esto es importante si tu app es una app de búsqueda combinada. Crea una lista de bloqueo 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.

Usa una lista importada de sugerencias de autocompletar

Puedes proporcionar tu propia lista de sugerencias de autocompletar en lugar de usar las sugerencias de autocompletar generadas a partir de un modelo de datos de autocompletar.

Para obtener información sobre cómo importar una lista, consulta Usa una lista importada de sugerencias de autocompletar.