Requisiti IAM per l'utilizzo di Gemini Cloud Assist

Questa pagina illustra i ruoli di Identity and Access Management necessari agli utenti per utilizzare correttamente Gemini Cloud Assist. Per informazioni sulla configurazione di Gemini Cloud Assist, consulta Configura Gemini Cloud Assist.

Panoramica

Per supportare domande e richieste relative alle tue risorse Google Cloud , Gemini Cloud Assist deve disporre delle autorizzazioni IAM appropriate per queste risorse. Gemini Cloud Assist ha le stesse autorizzazioni dell'utente che esegue query su Gemini Cloud Assist, quindi in molti casi le autorizzazioni IAM necessarie sono già concesse.

Ruoli IAM per l'utilizzo di Gemini Cloud Assist

I seguenti ruoli IAM sono consigliati per l'utilizzo generale di Gemini Cloud Assist:

Ruolo IAM Note
Gemini Cloud Assist User Questo ruolo concede agli utenti l'autorizzazione per utilizzare Gemini Cloud Assist, che include l'invocazione di agenti, la chat, la creazione di artefatti degli agenti e la condivisione di artefatti di proprietà dell'utente.
Cloud Asset Viewer Questo ruolo consente all'agente dell'utente di scoprire la topologia degli asset pertinenti alla domanda dell'utente, perché Cloud Asset Inventory gestisce gli asset Google Cloud e i metadati associati. Gli asset includono le risorse, le policy e le configurazioni Google Cloud .

Per concedere questi ruoli, segui i passaggi descritti in Configura Gemini Cloud Assist per un progetto. Per istruzioni generali, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Ruoli IAM disponibili per Gemini Cloud Assist

Nella maggior parte dei casi, il ruolo IAM consigliato per l'utilizzo di Gemini Cloud Assist è Gemini Cloud Assist User. In alcuni casi, potresti voler sostituire questo ruolo con un altro ruolo di Gemini Cloud Assist. La tabella seguente elenca i diversi ruoli di Gemini Cloud Assist che puoi utilizzare:

Ruolo IAM Funzione
Visualizzatore Gemini Cloud Assist Questo ruolo concede agli utenti l'autorizzazione per visualizzare gli artefatti degli agenti, come indagini o report, e le configurazioni degli agenti. Questo ruolo concede un accesso più limitato rispetto al ruolo Gemini Cloud Assist User; ad esempio, il ruolo Gemini Cloud Assist Viewer non concede l'autorizzazione per richiamare o chattare con l'agente.
Gemini Cloud Assist User Questo ruolo concede agli utenti l'autorizzazione per utilizzare Gemini Cloud Assist, che include l'invocazione di agenti, la chat, la creazione di artefatti degli agenti e la condivisione di artefatti di proprietà dell'utente.
Gemini Cloud Assist Editor Questo ruolo concede agli utenti le autorizzazioni di modifica per Gemini Cloud Assist. Oltre alle autorizzazioni contenute nel ruolo Utente Gemini Cloud Assist, il ruolo Editor contiene le autorizzazioni per eliminare gli argomenti della chat, eliminare gli artefatti dell'agente e aggiornare configurazioni specifiche dell'agente.
Gemini Cloud Assist Admin Questo ruolo concede agli utenti le autorizzazioni amministrative per Gemini Cloud Assist. Oltre alle autorizzazioni contenute nel ruolo Gemini Cloud Assist Editor, il ruolo di amministratore contiene autorizzazioni che consentono di configurare diverse policy di Gemini Cloud Assist, ad esempio l'abilitazione di agenti proattivi e la condivisione dei dati, la concessione di autorizzazioni agli agenti e la condivisione di artefatti a livello di progetto.

Autorizzazioni IAM specifiche

Di seguito sono riportate le autorizzazioni IAM specifiche importanti per il funzionamento di Gemini Cloud Assist. Utilizza queste informazioni quando crei ruoli IAM personalizzati.

Autorizzazioni IAM Funzione
geminicloudassist.agents.invoke Invio e ricezione di messaggi agli agenti di Gemini Cloud Assist.
cloudaicompanion.topics.create Avvio di una chat con Gemini Cloud Assist.
cloudaicompanion.geminiGcpEnablementSettings.update Configurazione delle impostazioni dell'amministratore per Gemini Cloud Assist.
mcp.tools.call Invio e ricezione di messaggi agli agenti Gemini Cloud Assist tramite MCP.

Autorizzazioni richieste per la chat

Il riquadro Chat di Gemini Cloud Assist utilizza una risorsa di backend chiamata argomento. Quando avvii una chat, Gemini Cloud Assist crea una risorsa argomento e ti concede il ruolo roles/cloudaicompanion.topicAdmin per quell'argomento, che include l'autorizzazione cloudaicompanion.topics.update. Questo comportamento significa che una chat è visualizzabile e aggiornabile solo dall'utente che ha creato l'argomento.

Se la tua organizzazione ha un vincolo personalizzato che impedisce a Gemini Cloud Assist di concedere roles/cloudaicompanion.topicAdmin agli utenti, il tentativo di avviare una sessione di chat non va a buon fine. Per risolvere il problema, chiedi all'amministratore di aggiornare i vincoli personalizzati dell'organizzazione per consentire la concessione di ruoli specifici.

Suggerimenti sui ruoli IAM per diversi casi d'uso

Oltre all'accesso concesso dai ruoli IAM per l'utilizzo di Gemini Cloud Assist, le attività eseguite tramite Gemini Cloud Assist richiedono l'accesso alle risorseGoogle Cloud pertinenti per l'attività. Ad esempio:

  • Se utilizzi gli agenti per comprendere l'integrità delle applicazioni GKE, le autorizzazioni IAM per GKE e le relative risorse associate sono fondamentali.

  • Se utilizzi agenti per eseguire il deployment dei job di trattamento dati, le autorizzazioni IAM per Dataflow, Managed Service for Apache Spark o BigQuery potrebbero essere le più importanti.

Le autorizzazioni IAM necessarie dipendono dal dominio specifico in cui si trovano le tue attività. A loro volta, i ruoli IAM appropriati che contengono queste autorizzazioni variano in base al caso d'uso. I seguenti ruoli IAM per le funzioni lavorative forniscono un buon punto di partenza se non sai quali ruoli dovrebbero avere gli utenti o le identità degli agenti.

Attività Ruoli pertinenti
Risoluzione dei problemi e garanzia di affidabilità e scalabilità dell'infrastruttura Google Cloud in modo ampio in più domini, sia in modo proattivo che interattivo
  • roles/iam.siteReliabilityEngineer
  • roles/iam.supportUser
  • Deployment, aggiornamento ed esplorazione dell'infrastruttura Google Cloud in generale in più domini
  • roles/iam.infrastructureAdmin
  • roles/iam.devOps
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • Esplorazione, comprensione e risoluzione dei problemi dell'infrastruttura di rete
  • roles/iam.networkAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • Interazione con i dati e analisi degli stessi tramite pipeline di trattamento dati, trasformazione e analisi
  • roles/iam.dataScientist
  • roles/logging.viewer
  • roles/monitoring.viewer
  • Deployment, aggiornamento e risoluzione dei problemi dei database
  • roles/iam.databaseAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • Comprendere e analizzare in dettaglio i costi dell'applicazione
  • roles/cloudhub.operator
  • roles/monitoring.viewer
  • roles/logging.viewer
  • Navigazione e visualizzazione di risorse Google Cloud , gerarchia delle cartelle, log, configurazione della sicurezza e metadati delle risorse chiave.
  • roles/iam.securityAuditor
  • Utilizzo di Gemini Cloud Assist con i set di dati di Storage Insights per comprendere l'utilizzo dello spazio di archiviazione di Cloud Storage.
  • roles/bigquery.jobUser
  • roles/bigquery.dataViewer
  • roles/storageinsights.viewer