Canvas konfigurieren

Auf dieser Seite wird beschrieben, wie Administratoren Canvas in Gemini Enterprise für ihre Nutzer einrichten und konfigurieren können.

Canvas ist in den globalen, US-amerikanischen und EU-Regionen allgemein verfügbar. Sie ist für Nutzer der Gemini Enterprise Business-, Standard- und Plus-Versionen verfügbar.

Hinweis

Canvas ist standardmäßig deaktiviert. Sie können Canvas überprüfen und testen, bevor Sie es für Nutzer aktivieren.

Führen Sie die folgenden Schritte aus, um Canvas für Ihre Nutzer zu aktivieren:

• Funktionsschalter aktivieren
• Einer benutzerdefinierten IAM-Rolle Canvas-Berechtigungen hinzufügen

Canvas in der Gemini Enterprise-App aktivieren

Damit Nutzer auf die Canvas-Funktion zugreifen können, muss ein Gemini Enterprise-Administrator in den Einstellungen für die Verwaltung von Web-App-Funktionen den Ein/Aus-Button Canvas aktivieren aktivieren. Weitere Informationen finden Sie unter Funktionen der Webanwendung verwalten.

Canvas-Berechtigungen einer benutzerdefinierten IAM-Rolle hinzufügen

Prüfen Sie, ob die Nutzer die erforderlichen Berechtigungen für Canvas haben:

• Vordefinierte Rollen: Nutzer, die mit Standardrollen wie roles/discoveryengine.user auf Gemini Enterprise zugreifen, müssen keine Änderungen vornehmen, da die erforderlichen Berechtigungen in den vordefinierten Rollen enthalten sind.

• Benutzerdefinierte Rollen: Wenn Nutzer mit benutzerdefinierten IAM-Rollen auf Gemini Enterprise zugreifen, müssen Sie der benutzerdefinierten Rolle die Berechtigungen immersiveArtifacts hinzufügen. Ohne diese Berechtigungen können Nutzer Canvas nicht verwenden. Für Canvas sind die folgenden Berechtigungen erforderlich:

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

  Da die für Canvas erforderlichen Berechtigungen in der Vorabversion sind, können Sie sie nicht über die Google Cloud Console hinzufügen. Verwenden Sie stattdessen die gcloud CLI. Wenn Sie diese Berechtigungen beispielsweise einer vorhandenen benutzerdefinierten Rolle auf Projektebene hinzufügen möchten, führen Sie den folgenden Befehl aus:

  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
  

  Hinweis :Da sich diese Berechtigungen in der Vorabversion befinden, wird in der gcloud CLI eine Warnung angezeigt, dass sich diese Berechtigungen in der alpha-Phase befinden und möglicherweise nicht stabil genug für die Verwendung in benutzerdefinierten Rollen sind. Diese Warnung ist zu erwarten und verhindert nicht, dass die Berechtigungen angewendet werden.

  Weitere Informationen zum Verwalten von IAM-Rollen für Gemini Enterprise finden Sie unter Zugriffssteuerung mit IAM.

Beschränkungen

Canvas wird in der mobilen App nicht unterstützt. Es ist nur in der Web-App verfügbar.

Kontingentverbrauch

Canvas-Anfragen und reguläre Chatanfragen in der Gemini Enterprise App werden auf dieselbe Weise gezählt und haben dasselbe Kontingent.

In der Gemini Enterprise App wird die Fehlermeldung Nutzungslimit erreicht angezeigt, wenn Sie mit dem Assistenten chatten oder Gemini Enterprise-Funktionen in einem der folgenden Szenarien verwenden:

• Ihr Projekt hat die monatliche Ausgabenobergrenze erreicht.
• Ihr Projekt überschreitet das zusammengefasste Kontingentlimit für eine bestimmte Funktion und Ihr Gemini Enterprise-Administrator hat keine Überschreitungen aktiviert.

Dieser Fehler betrifft nur die Funktion, für die das Limit erreicht wurde. Sie können weiterhin andere Funktionen mit verbleibendem Kontingent verwenden.