Questo documento descrive come Gemini Enterprise si integra con Knowledge Catalog per fornire agli agenti strumenti di sola lettura per cercare i dati a cui un utente ha accesso e consultare il contesto tecnico e aziendale.
Non è necessario creare un datastore separato per connetterti a Knowledge Catalog. L'integrazione di Knowledge Catalog viene invece attivata automaticamente quando colleghi un datastore BigQuery, Spanner, Cloud SQL o AlloyDB per PostgreSQL in modalità query federata alla tua app Gemini Enterprise. Anziché apparire come datastore, Knowledge Catalog è un'opzione di configurazione nella scheda Assistente della tua app Gemini Enterprise. Puoi anche attivare o disattivare manualmente l'integrazione in qualsiasi momento, anche al di fuori dei connettori Data Cloud associati.
Come funzionano insieme i connettori Knowledge Catalog e Data Cloud
In Knowledge Catalog, ogni asset di dati catalogato nel tuo ambienteGoogle Cloud viene archiviato come record di metadati chiamato voce. Poiché i connettori Data Cloud in modalità query federata hanno un ampio accesso a tutte le risorse che un utente autenticato può visualizzare, anziché essere limitati a un singolo set di dati o a una singola tabella, l'agente non sa inizialmente dove si trovano i dati pertinenti.
Quando Knowledge Catalog è abilitato per la tua app Gemini Enterprise, automaticamente quando colleghi un connettore Data Cloud federato o manualmente nella scheda Assistente, l'integrazione fornisce all'agente competenze integrate e strumenti di sola lettura per:
- Cerca dati accessibili: cerca tra gli asset di dati catalogati in Knowledge Catalog a cui l'utente autenticato ha l'autorizzazione di accedere.
- Cerca il contesto tecnico e aziendale: recupera i metadati arricchiti, inclusi schemi di tabelle, descrizioni di colonne, termini del glossario aziendale e query di esempio pre-verificate (query di riferimento). Se associato a un connettore Data Cloud complementare, l'agente utilizza queste query di riferimento per evitare allucinazioni di join su schemi complessi e passa questo contesto al connettore per generare ed eseguire una query accurata.
Esempio di workflow
Il seguente diagramma illustra l'interazione tra Knowledge Catalog e un connettore Data Cloud federato per rispondere alla domanda di un utente:
In questo workflow, Gemini Enterprise completa i seguenti passaggi:
Domanda dell'utente: un utente pone una domanda in linguaggio naturale in Gemini Enterprise:
"How many sales did we have this month for all cold weather products?"Rilevamento della ricerca semantica: l'agente principale di Gemini Enterprise esegue ricerche nel Knowledge Catalog utilizzando i termini di ricerca estratti dalla domanda dell'utente:
["cold weather", "products", "orders", "sales"]Recupero del contesto: per le voci corrispondenti a cui l'utente ha accesso, l'agente cerca il contesto arricchito in Knowledge Catalog (derivato da metadati tecnici, pattern di utilizzo, glossari aziendali e inferenza LLM):
simpleName: my-project.ecomm.products type: BigQuery Table terms: "Cold Weather Products; category IN ('Sweaters', 'Coats & Jackets')"Esecuzione della query: utilizzando i metadati della tabella e la definizione aziendale recuperati, l'agente formula ed esegue una query SQL di sola lettura tramite il connettore BigQuery federato:
-- 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') );
Prima di iniziare
L'integrazione di Knowledge Catalog è in sola lettura e utilizza API interne, quindi non è necessario abilitare l'API Dataplex o concedere le autorizzazioni dello strumento MCP e gli utenti non hanno bisogno delle autorizzazioni per creare o modificare risorse in Knowledge Catalog.
Poiché l'integrazione autentica le richieste utilizzando le credenziali dell'utente finale, l'agente può trovare e scoprire solo gli asset di dati per i quali l'utente autenticato dispone dell'autorizzazione di Identity and Access Management (IAM) per la visualizzazione:
- Separazione dell'accesso ai metadati e ai dati con il trimming dei risultati di ricerca:
Knowledge Catalog applica il trimming dei risultati di ricerca in base alle autorizzazioni dell'utente autenticato nell'origine dati sottostante. Se un utente non dispone delle autorizzazioni in lettura (ad esempio
roles/bigquery.dataVieweroroles/bigquery.metadataViewer) su un set di dati o una tabella, l'asset viene filtrato automaticamente dai risultati di ricerca del catalogo e non può essere rilevato dall'assistente. - Origini dati Google Cloud proprietarie: le autorizzazioni per le origini dati proprietarie, come BigQuery, AlloyDB per PostgreSQL, Spanner e Cloud SQL, vengono ereditate automaticamente. Ad esempio, se concedi a un utente il ruolo Visualizzatore dati BigQuery (
roles/bigquery.dataViewer), questo potrà cercare e scoprire i metadati della tabella e del set di dati corrispondenti in Knowledge Catalog. - Metadati aggiuntivi e origini dati di terze parti: per i metadati personalizzati, i glossari aziendali o gli asset di dati di terze parti aggiunti a Knowledge Catalog, assicurati che gli utenti dispongano delle autorizzazioni di visualizzazione richieste in Knowledge Catalog (ad esempio
roles/dataplex.dataDomainEntryReaderoroles/dataplex.catalogViewer) in modo che l'agente possa rilevare i dati. Per saperne di più, consulta Gestisci l'accesso con IAM nella documentazione di Knowledge Catalog.
Attiva o disattiva Knowledge Catalog nella tua app
Quando colleghi un datastore BigQuery, Spanner, Cloud SQL o AlloyDB per PostgreSQL in modalità di query federata a un'app Gemini Enterprise, Knowledge Catalog e le relative competenze dell'agente integrate vengono abilitate automaticamente per l'app.
Puoi anche attivare o disattivare manualmente l'integrazione di Knowledge Catalog in qualsiasi momento, anche al di fuori dei connettori Data Cloud associati (ad esempio, per attivare Knowledge Catalog senza collegare un connettore Data Cloud o per disattivarlo mantenendo attivo un connettore Data Cloud), nella scheda Assistant della pagina Configurazioni dell'app:
Nella console Google Cloud , vai alla pagina Gemini Enterprise.
Fai clic sul nome dell'app che vuoi configurare.
Fai clic su Configurazioni, quindi seleziona la scheda Assistente.
Nella sezione Abilita Knowledge Catalog, utilizza l'opzione per attivare o disattivare l'integrazione di Knowledge Catalog.
Fai clic su Save and publish (Salva e pubblica).
Per ulteriori informazioni sulle impostazioni dell'assistente, consulta Configura l'assistente.
Passaggi successivi
- Collega un'origine dati Data Cloud in modalità query federata:
- Scopri le best practice per i connettori Data Cloud che utilizzano l'analisi conversazionale.