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 Gemini Enterprise.

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 Gemini Enterprise. Consulta Configurar 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 que estén 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 (LCA). 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 Identidad y permisos.

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.

Diferentes tipos de sugerencias: con la función Autocompletar avanzada, en lugar de las sugerencias de consulta de Autocompletar normales, puedes especificar que quieres diferentes tipos de sugerencias:
- Sugerencias enriquecidas: los usuarios reciben información sobre los documentos cuyos títulos coinciden con las letras que escriben como sugerencias de autocompletado. Para obtener más información, consulta Enviar una solicitud de autocompletar y devolver sugerencias enriquecidas.
- Consultas recientes: como sugerencias de autocompletado, los usuarios reciben sus consultas recientes que coinciden con el prefijo de las letras que escriben. Para obtener más información, consulta Enviar una solicitud de autocompletar 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 la 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 avanzadas 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 Gemini Enterprise.
  
  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.
APP_ID: el ID de la aplicación.
QUERY_STRING: la entrada de escritura anticipada 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 Gemini Enterprise.
  
  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.
APP_ID: el ID de la aplicación.
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 degradan (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": "hol",
     "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 destacan (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 Autocompletar y devolver sugerencias enriquecidas

La función de autocompletar enriquecida devuelve contenido (documentos) cuyos títulos contienen palabras que empiezan por la consulta.

Además del título del documento, la solicitud de autocompletar devuelve source_type y entity_type, así como las propiedades clave uri, create_time y update_time, si están disponibles. Puede ver y editar las asignaciones de propiedades clave en la pestaña Esquema de la página de almacén de datos.

Al igual que con todas las sugerencias de autocompletado avanzadas, se respetan las listas de control de acceso de los documentos sugeridos.

Ejemplo

Un empleado está consultando el sitio de la intranet de su empresa para buscar información técnica sobre permisos de acceso.

El empleado empieza a escribir tec y se pueden devolver los siguientes documentos: Data technicians handbook, Access technology guide y Techniques for troubleshooting access issues.

Con las sugerencias enriquecidas, puedes mostrar la siguiente información sobre cada uno de los documentos sugeridos:

El título del documento (title) y un enlace al documento (uri)
cuándo se actualizó por última vez (update_time)
la fuente (source_type), por ejemplo, si el documento se ha encontrado en Confluence Cloud o Slack.

Saber cuándo se actualizó un documento por última vez y cuál es su fuente ayuda al empleado a elegir qué documento consultar primero.

Limitaciones

El autocompletado enriquecido solo se aplica a conectores de terceros y solo a determinados almacenes de datos de entidades de esos conectores de terceros. En la siguiente tabla se muestra qué entidades se admiten en cada conector.

Conector de terceros	Entidades admitidas
Box	Archivo
Confluence Cloud	Página	Espacio
Dropbox	Archivo
Jira Cloud	Problema	Espacio
OneDrive	Archivo
Salesforce	Cuenta	Guiar	Oportunidad
ServiceNow	Incidente	Conocimiento
SharePoint Online	Archivo adjunto	Evento	Archivo	Página
Slack	Mensaje

Procedimiento

Para enviar una solicitud de autocompletar que devuelva una sugerencia enriquecida, 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 Gemini Enterprise.
  
  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": ["CONTENT"]
    }'

Haz los cambios siguientes:

PROJECT_ID: el ID de tu proyecto.
APP_ID: el ID de la aplicación.
QUERY_STRING: la entrada de escritura anticipada que se usa para obtener sugerencias.

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/1234/locations/global/collections/default_collection/engines/my_app/completionConfig:completeQuery" \
- d {
      "query": "C",
      "suggestionTypes": ["CONTENT"]
    }'

{
  "contentSuggestions": [{
    "suggestion": "critical crash in payment module",
    "document": {
      "name": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store/branches/0/documents/10000",
      "derivedStructData": {
        "title": "Critical Crash in Payment Module",
        "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
        "source_type": "jira",
        "entity_type": "issue"
      }
    },
    "dataStore": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store"
  }]
}

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 proporcionar el ID de usuario pseudoanónimo.

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 Gemini Enterprise.
  
  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.
APP_ID: el ID de la aplicación.
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 denegación de 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

Puedes proporcionar tu 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 Autocompletar y devolver sugerencias enriquecidas

Ejemplo

Limitaciones

Procedimiento

REST

Ejemplo de comando y resultado

Enviar una solicitud de autocompletado y devolver consultas recientes

Ejemplo

Procedimiento

REST

Ejemplo de comando y resultado

Usar una lista de denegación de autocompletar

Usar una lista importada de sugerencias de autocompletar

Configurar la función Autocompletar avanzada