Configurare Canvas

Questa pagina descrive come gli amministratori possono configurare Canvas in Gemini Enterprise per i propri utenti.

Canvas è in disponibilità generale nelle regioni globali, degli Stati Uniti e dell'UE. È disponibile per gli utenti delle versioni Gemini Enterprise Business, Standard e Plus.

Prima di iniziare

Canvas è disattivato per impostazione predefinita. Puoi esaminare e testare Canvas prima di scegliere di attivarlo per gli utenti.

Per attivare Canvas per i tuoi utenti, completa la seguente configurazione:

• Attivare/disattivare la funzionalità
• Aggiungere autorizzazioni Canvas a un ruolo IAM personalizzato

Attivare Canvas nell'app Gemini Enterprise

Per consentire agli utenti di accedere alla funzionalità Canvas, un amministratore di Gemini Enterprise deve attivare l'opzione di attivazione/disattivazione Abilita canvas nelle impostazioni di gestione delle funzionalità dell'app web. Per saperne di più, vedi Gestire le funzionalità dell'app web.

Aggiungere le autorizzazioni Canvas a un ruolo IAM personalizzato

Assicurati che gli utenti dispongano delle autorizzazioni richieste per Canvas:

• Ruoli predefiniti: gli utenti che accedono a Gemini Enterprise con ruoli standard come roles/discoveryengine.user non devono apportare modifiche, poiché le autorizzazioni necessarie sono incluse nei ruoli predefiniti.

• Ruoli personalizzati: per gli utenti che accedono a Gemini Enterprise utilizzando ruoli IAM personalizzati, devi aggiungere le autorizzazioni immersiveArtifacts al ruolo personalizzato. Senza queste autorizzazioni, gli utenti non possono utilizzare Canvas. Canvas richiede le seguenti autorizzazioni:

  • discoveryengine.immersiveArtifacts.create
  • discoveryengine.immersiveArtifacts.delete
  • discoveryengine.immersiveArtifacts.export
  • discoveryengine.immersiveArtifacts.get
  • discoveryengine.immersiveArtifacts.list
  • discoveryengine.immersiveArtifacts.navigate
  • discoveryengine.immersiveArtifacts.update

  Poiché le autorizzazioni richieste per Canvas sono in anteprima, non puoi aggiungerle utilizzando la console Google Cloud . Utilizza invece gcloud CLI. Ad esempio, per aggiungere queste autorizzazioni a un ruolo personalizzato esistente a livello di progetto, esegui questo comando:

  gcloud iam roles update ROLE_ID \
    --project=PROJECT_ID \
    --add-permissions=discoveryengine.immersiveArtifacts.create,discoveryengine.immersiveArtifacts.delete,discoveryengine.immersiveArtifacts.export,discoveryengine.immersiveArtifacts.get,discoveryengine.immersiveArtifacts.list,discoveryengine.immersiveArtifacts.navigate,discoveryengine.immersiveArtifacts.update
  

  Nota: poiché queste autorizzazioni sono in anteprima, viene visualizzato un avviso previsto da gcloud CLI che indica che queste autorizzazioni si trovano nella fase di lancio alpha e potrebbero essere instabili per l'utilizzo nei ruoli personalizzati. Questo avviso è previsto e non impedisce l'applicazione delle autorizzazioni.

  Per saperne di più sulla gestione dei ruoli IAM di Gemini Enterprise, consulta Controllo dell'accesso con IAM.

Limitazioni

Canvas non è supportato nell'app mobile. È disponibile solo nell'app web.

Consumo della quota

Le query di Canvas e le query di chat dell'app Gemini Enterprise vengono conteggiate allo stesso modo e condividono la stessa quota.

L'app Gemini Enterprise mostra il messaggio di errore Limite di utilizzo raggiunto quando chatti con l'assistente o utilizzi le funzionalità di Gemini Enterprise in uno dei seguenti scenari:

• Il tuo progetto ha raggiunto il limite di spesa mensile.
• Il tuo progetto supera il limite della quota condivisa per una funzionalità specifica e l'amministratore di Gemini Enterprise non ha attivato gli addebiti per superamento della quota.

Questo errore riguarda solo la funzionalità che ha raggiunto il limite. Puoi continuare a utilizzare altre funzionalità per le quali è disponibile una quota.