Nota: Este conjunto de documentación es para las ediciones Standard, Plus, de pago por uso y Frontline de Gemini Enterprise. Para obtener la documentación de la edición Business, consulta el Centro de ayuda de Gemini Enterprise Business.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Conéctate a Knowledge Catalog

En este documento, se describe cómo Gemini Enterprise se integra con Knowledge Catalog para brindarles a los agentes herramientas de solo lectura que les permitan buscar datos a los que un usuario tiene acceso y consultar el contexto técnico y comercial.

No es necesario que crees un almacén de datos independiente para conectarte a Knowledge Catalog. En cambio, la integración de Knowledge Catalog se habilita automáticamente cuando conectas un almacén de datos de BigQuery, Spanner, Cloud SQL o AlloyDB para PostgreSQL en modo de consulta federada a tu app de Gemini Enterprise. En lugar de aparecer como un almacén de datos, Knowledge Catalog es una opción de configuración en la pestaña Assistant de tu app de Gemini Enterprise. También puedes activar o desactivar manualmente la integración en cualquier momento, incluso fuera de los conectores complementarios de Data Cloud.

Cómo funcionan en conjunto Knowledge Catalog y los conectores de Data Cloud

En Knowledge Catalog, cada recurso de datos catalogado en tu entorno deGoogle Cloud se almacena como un registro de metadatos llamado entrada. Dado que los conectores de Data Cloud en el modo de consulta federada tienen acceso amplio a todos los recursos que puede ver un usuario autenticado (en lugar de estar restringidos a un solo conjunto de datos o tabla), el agente no sabe inicialmente dónde residen los datos pertinentes.

Cuando Knowledge Catalog está habilitado para tu app de Gemini Enterprise (ya sea automáticamente cuando adjuntas un conector federado de Data Cloud o manualmente en la pestaña Asistente), la integración proporciona al agente habilidades integradas y herramientas de solo lectura para hacer lo siguiente:

Buscar datos accesibles: Busca en los recursos de datos catalogados en Knowledge Catalog a los que el usuario autenticado tiene permiso para acceder.
Buscar contexto técnico y empresarial: Recupera metadatos enriquecidos, incluidos esquemas de tablas, descripciones de columnas, términos del glosario empresarial y consultas de muestra verificadas previamente (consultas de referencia). Cuando se vincula con un conector complementario de Data Cloud, el agente usa estas consultas de oro para evitar alucinaciones de unión en esquemas complejos y pasa este contexto al conector para generar y ejecutar una consulta precisa.

Ejemplo de flujo de trabajo

En el siguiente diagrama, se ilustra cómo Knowledge Catalog y un conector federado de Data Cloud trabajan en conjunto para responder la pregunta de un usuario:

Diagrama que muestra el flujo de trabajo de cuatro pasos, desde una pregunta del usuario hasta la búsqueda semántica y la recuperación de contexto de Knowledge Catalog, y la ejecución de la consulta en SQL de BigQuery.

En este flujo de trabajo, Gemini Enterprise completa los siguientes pasos:

Pregunta del usuario: Un usuario hace una pregunta en lenguaje natural en Gemini Enterprise:
```
"How many sales did we have this month for all cold weather products?"
```
Descubrimiento de búsqueda semántica: El agente raíz de Gemini Enterprise busca en Knowledge Catalog con los términos de búsqueda extraídos de la pregunta del usuario:
```
["cold weather", "products", "orders", "sales"]
```
Recuperación de contexto: Para las entradas coincidentes a las que el usuario tiene acceso, el agente busca contexto enriquecido en Knowledge Catalog (derivado de metadatos técnicos, patrones de uso, glosarios empresariales y la inferencia de LLM):
```
simpleName: my-project.ecomm.products
type: BigQuery Table
terms: "Cold Weather Products; category IN ('Sweaters', 'Coats & Jackets')"
```

Ejecución de la consulta: Con los metadatos de la tabla y la definición de la empresa recuperados, el agente formula y ejecuta una consulta en SQL de solo lectura a través del conector federado de BigQuery:

-- Execute BigQuery read-only SQL
SELECT COUNT(order_id) FROM `my-project.ecomm.orders`
WHERE product_id IN (
  SELECT id FROM `my-project.ecomm.products`
  WHERE category IN ('Sweaters', 'Coats & Jackets')
);

Antes de comenzar

La integración de Knowledge Catalog es de solo lectura y usa APIs internas, por lo que no es necesario que habilites la API de Dataplex ni que otorgues permisos a la herramienta de MCP, y los usuarios no necesitan permisos para crear o modificar recursos en Knowledge Catalog.

Dado que la integración autentica las solicitudes con credenciales de usuario final, el agente solo puede encontrar y descubrir los activos de datos que el usuario autenticado tiene permiso de Identity and Access Management (IAM) para ver:

Separación del acceso a los metadatos y los datos con el recorte de los resultados de la búsqueda: Knowledge Catalog aplica el recorte de los resultados de la búsqueda en función de los permisos del usuario autenticado en la fuente de datos subyacente. Si un usuario no tiene permisos de lectura (como roles/bigquery.dataViewer o roles/bigquery.metadataViewer) en un conjunto de datos o una tabla, ese recurso se filtra automáticamente de los resultados de la búsqueda del catálogo y el asistente no lo puede detectar.
Fuentes de datos Google Cloud propias: Los permisos para las fuentes de datos propias, como BigQuery, AlloyDB para PostgreSQL, Spanner y Cloud SQL, se heredan automáticamente. Por ejemplo, si le otorgas a un usuario el rol de visualizador de datos de BigQuery (roles/bigquery.dataViewer), le das acceso para buscar y descubrir los metadatos correspondientes de la tabla y el conjunto de datos en Knowledge Catalog.
Metadatos adicionales y fuentes de datos de terceros: En el caso de los metadatos personalizados, los glosarios empresariales o los recursos de datos de terceros que se agreguen a Knowledge Catalog, asegúrate de que los usuarios tengan los permisos de visualización necesarios en Knowledge Catalog (como roles/dataplex.dataDomainEntryReader o roles/dataplex.catalogViewer) para que el agente pueda descubrir esos datos. Para obtener más información, consulta Administra el acceso con IAM en la documentación de Knowledge Catalog.

Habilita o inhabilita Knowledge Catalog en tu app

Cuando conectas un almacén de datos de BigQuery, Spanner, Cloud SQL o AlloyDB para PostgreSQL en el modo de consulta federada a una app de Gemini Enterprise, Knowledge Catalog y sus habilidades para agentes integradas se habilitan automáticamente para la app.

También puedes activar o desactivar manualmente la integración de Knowledge Catalog en cualquier momento, incluso fuera de los conectores complementarios de Data Cloud (por ejemplo, para habilitar Knowledge Catalog sin adjuntar un conector de Data Cloud o para desactivarlo mientras mantienes activo un conector de Data Cloud), en la pestaña Assistant de la página Configurations de tu app:

En la consola de Google Cloud , ve a la página Gemini Enterprise.

Gemini Enterprise
Haz clic en el nombre de la app que quieres configurar.
Haz clic en Configurations y, luego, selecciona la pestaña Assistant.
En la sección Habilitar Knowledge Catalog, usa el botón de activación para habilitar o inhabilitar la integración de Knowledge Catalog.
Haz clic en Guardar y publicar.

Para obtener más información sobre la configuración del asistente, consulta Cómo configurar el asistente.

Próximos pasos

Conecta una fuente de datos de Data Cloud en el modo de consulta federada:
Obtén información sobre las prácticas recomendadas para los conectores de Data Cloud que usan análisis conversacionales.