Configurer le canevas

Cette page explique comment les administrateurs peuvent configurer Canvas dans Gemini Enterprise pour leurs utilisateurs.

Canvas est en disponibilité générale dans les régions Monde, États-Unis et Europe. Elle est disponible pour les utilisateurs des éditions Gemini Enterprise Business, Standard et Plus.

Avant de commencer

Canvas est désactivé par défaut. Vous pouvez examiner et tester le Canvas avant de choisir de l'activer pour les utilisateurs.

Pour activer Canvas pour vos utilisateurs, procédez comme suit :

• Activez le bouton bascule de la fonctionnalité.
• Ajouter des autorisations Canvas à un rôle IAM personnalisé

Activer Canvas dans l'application Gemini Enterprise

Pour que les utilisateurs puissent accéder à la fonctionnalité Canvas, un administrateur Gemini Enterprise doit activer le bouton Activer Canvas dans les paramètres de gestion des fonctionnalités de l'application Web. Pour en savoir plus, consultez Gérer les fonctionnalités des applications Web.

Ajouter des autorisations Canvas à un rôle IAM personnalisé

Assurez-vous que les utilisateurs disposent des autorisations requises pour Canvas :

• Rôles prédéfinis : les utilisateurs qui accèdent à Gemini Enterprise avec des rôles standards tels que roles/discoveryengine.user n'ont pas besoin d'apporter de modifications, car les autorisations nécessaires sont incluses dans les rôles prédéfinis.

• Rôles personnalisés : si des utilisateurs accèdent à Gemini Enterprise à l'aide de rôles IAM personnalisés, vous devez ajouter les autorisations immersiveArtifacts à ces rôles. Sans ces autorisations, les utilisateurs ne peuvent pas utiliser Canvas. Canvas nécessite les autorisations suivantes :

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

  Étant donné que les autorisations requises pour Canvas sont en preview, vous ne pouvez pas les ajouter à l'aide de la console Google Cloud . Utilisez plutôt la gcloud CLI. Par exemple, pour ajouter ces autorisations à un rôle personnalisé existant au niveau du projet, exécutez la commande suivante :

  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
  

  Remarque : Étant donné que ces autorisations sont en preview, vous verrez un avertissement attendu de la gcloud CLI indiquant qu'elles sont en phase de lancement alpha et qu'elles peuvent être instables pour une utilisation dans des rôles personnalisés. Cet avertissement est normal et n'empêche pas l'application des autorisations.

  Pour en savoir plus sur la gestion des rôles IAM Gemini Enterprise, consultez Contrôle des accès avec IAM.

Limites

Canvas n'est pas compatible avec l'application mobile. Il n'est disponible que dans l'application Web.

Consommation de quota

Les requêtes Canvas et les requêtes de chat de l'application Gemini Enterprise sont comptabilisées de la même manière et partagent le même quota.

L'application Gemini Enterprise affiche le message d'erreur Limite d'utilisation atteinte lorsque vous discutez avec l'assistant ou que vous utilisez les fonctionnalités Gemini Enterprise dans l'un des scénarios suivants :

• Votre projet a atteint son plafond de dépenses mensuelles.
• Votre projet dépasse sa limite de quota groupé pour une fonctionnalité spécifique et votre administrateur Gemini Enterprise n'a pas activé les dépassements.

Cette erreur n'affecte que la fonctionnalité qui a atteint sa limite. Vous pouvez continuer à utiliser les autres fonctionnalités pour lesquelles il reste du quota.