IAM-Anforderungen für die Verwendung von Gemini Cloud Assist

Auf dieser Seite werden die IAM-Rollen (Identity and Access Management) beschrieben, die Nutzer benötigen, um Gemini Cloud Assist erfolgreich verwenden zu können. Informationen zum Einrichten von Gemini Cloud Assist finden Sie unter Gemini Cloud Assist einrichten.

Übersicht

Damit Gemini Cloud Assist Fragen und Anfragen zu Ihren Ressourcen in Google Cloud beantworten kann, benötigt es die entsprechenden IAM-Berechtigungen für diese Ressourcen. Gemini Cloud Assist hat dieselben Berechtigungen wie der Nutzer, der Anfragen an Gemini Cloud Assist sendet. In vielen Fällen sind die erforderlichen IAM-Berechtigungen also bereits erteilt.

IAM-Rollen für die Verwendung von Gemini Cloud Assist

Die folgenden IAM-Rollen werden für die allgemeine Verwendung von Gemini Cloud Assist empfohlen:

IAM-Rolle Hinweise
Gemini Cloud Assist User Mit dieser Rolle können Nutzer Gemini Cloud Assist verwenden. Dazu gehören das Aufrufen von KI-Agenten, das Chatten, das Erstellen von KI-Agenten-Artefakten und das Freigeben von Artefakten, die dem Nutzer gehören.
Cloud Asset Viewer Mit dieser Rolle kann der KI-Agent des Nutzers die Topologie von Assets ermitteln, die für die Frage des Nutzers relevant sind, da Cloud Asset Inventory Assets in Google Cloud und die zugehörigen Metadaten verwaltet. Zu den Assets gehören Ihre Ressourcen, Richtlinien und Konfigurationen in Google Cloud .

Folgen Sie der Anleitung unter Gemini Cloud Assist für ein Projekt einrichten, um diese Rollen zuzuweisen. Eine allgemeine Anleitung finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Verfügbare IAM-Rollen für Gemini Cloud Assist

In den meisten Fällen ist die empfohlene IAM-Rolle für die Verwendung von Gemini Cloud Assist Gemini Cloud Assist User. In einigen Fällen möchten Sie diese Rolle möglicherweise gegen eine andere Gemini Cloud Assist-Rolle austauschen. In der folgenden Tabelle sind die verschiedenen Gemini Cloud Assist-Rollen aufgeführt, die Sie verwenden können:

IAM-Rolle Funktion
Gemini Cloud Assist Viewer Mit dieser Rolle können Nutzer Agent-Artefakte wie Prüfungen oder Berichte sowie Agent-Konfigurationen ansehen. Diese Rolle gewährt im Vergleich zur Rolle Gemini Cloud Assist User eingeschränkteren Zugriff. Mit der Rolle Gemini Cloud Assist Viewer ist es beispielsweise nicht möglich, den Agent aufzurufen oder mit ihm zu chatten.
Gemini Cloud Assist User Mit dieser Rolle können Nutzer Gemini Cloud Assist verwenden. Dazu gehören das Aufrufen von KI-Agenten, das Chatten, das Erstellen von KI-Agenten-Artefakten und das Freigeben von Artefakten, die dem Nutzer gehören.
Gemini Cloud Assist Editor Mit dieser Rolle erhalten Nutzer Bearbeitungsberechtigungen für Gemini Cloud Assist. Zusätzlich zu den Berechtigungen, die in der Rolle Gemini Cloud Assist User enthalten sind, enthält die Rolle „Bearbeiter“ Berechtigungen zum Löschen von Chat-Themen, zum Löschen von Agentenartefakten und zum Aktualisieren bestimmter Agentenkonfigurationen.
Gemini Cloud Assist Admin Mit dieser Rolle erhalten Nutzer Administratorberechtigungen für Gemini Cloud Assist. Zusätzlich zu den Berechtigungen, die in der Rolle Gemini Cloud Assist Editor enthalten sind, enthält die Administratorrolle Berechtigungen, mit denen Sie verschiedene Richtlinien von Gemini Cloud Assist konfigurieren können. Dazu gehören das Aktivieren proaktiver Agenten und der Datenweitergabe, das Gewähren von Berechtigungen für Agenten und das projektweite Freigeben von Artefakten.

Spezifische IAM-Berechtigungen

Die folgenden IAM-Berechtigungen sind für die Funktionsweise von Gemini Cloud Assist wichtig. Verwenden Sie diese Informationen, wenn Sie benutzerdefinierte IAM-Rollen erstellen.

IAM-Berechtigung Funktion
geminicloudassist.agents.invoke Nachrichten an Gemini Cloud Assist-Agenten senden und von ihnen empfangen.
cloudaicompanion.topics.create Chat mit Gemini Cloud Assist starten
cloudaicompanion.geminiGcpEnablementSettings.update Administratoreinstellungen für Gemini Cloud Assist konfigurieren.
mcp.tools.call Senden und Empfangen von Nachrichten an Gemini Cloud Assist-Agenten über MCP.

Erforderliche Berechtigungen für den Chat

Der Gemini Cloud Assist-Chatbereich verwendet eine Backend-Ressource, die als Thema bezeichnet wird. Wenn Sie einen Chat starten, erstellt Gemini Cloud Assist eine Themenressource und weist Ihnen die Rolle roles/cloudaicompanion.topicAdmin für dieses Thema zu, die die Berechtigung cloudaicompanion.topics.update enthält. Das bedeutet, dass ein Chat nur von dem Nutzer angesehen und aktualisiert werden kann, der das Thema erstellt hat.

Wenn in Ihrer Organisation eine benutzerdefinierte Einschränkung gilt, die verhindert, dass Gemini Cloud Assist Nutzern roles/cloudaicompanion.topicAdmin gewährt, schlägt Ihr Versuch, eine Chatsitzung zu starten, fehl. Bitten Sie Ihren Administrator, die benutzerdefinierten Einschränkungen der Organisation zu aktualisieren, um bestimmte Rollen zuzulassen.

Empfehlungen für IAM-Rollen für verschiedene Anwendungsfälle

Zusätzlich zu dem Zugriff, der über IAM-Rollen für die Verwendung von Gemini Cloud Assist gewährt wird, erfordern Aufgaben, die über Gemini Cloud Assist ausgeführt werden, Zugriff auf dieGoogle Cloud -Ressourcen, die für diese Aufgabe relevant sind. Beispiel:

  • Wenn Sie Agenten verwenden, um den Zustand von GKE-Anwendungen zu ermitteln, sind IAM-Berechtigungen für GKE und die zugehörigen Ressourcen am wichtigsten.

  • Wenn Sie Agenten zum Bereitstellen von Datenverarbeitungsjobs verwenden, sind IAM-Berechtigungen für Dataflow, Managed Service for Apache Spark oder BigQuery möglicherweise am wichtigsten.

Die erforderlichen IAM-Berechtigungen hängen von der jeweiligen Domain ab, in der sich Ihre Aufgaben befinden. Die entsprechenden IAM-Rollen, die diese Berechtigungen enthalten, variieren je nach Anwendungsfall. Die folgenden IAM-Rollen für Aufgabenbereiche sind ein guter Ausgangspunkt, wenn Sie sich nicht sicher sind, welche Rollen Nutzer oder Agent-Identitäten haben sollten.

Aufgabe Relevante Rollen
Fehlerbehebung und Sicherstellung der Zuverlässigkeit und Skalierbarkeit der Google Cloud -Infrastruktur in mehreren Domains, sowohl proaktiv als auch interaktiv
  • roles/iam.siteReliabilityEngineer
  • roles/iam.supportUser
  • Bereitstellen, Aktualisieren und Erkunden der Infrastruktur von Google Cloud in mehreren Domains
  • roles/iam.infrastructureAdmin
  • roles/iam.devOps
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • Netzwerkinfrastruktur erkunden, verstehen und Fehler beheben
  • roles/iam.networkAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • roles/cloudtrace.user
  • roles/apptopology.viewer
  • Interaktion mit Daten und Analyse von Daten über Pipelines für die Datenverarbeitung, -transformation und -analyse
  • roles/iam.dataScientist
  • roles/logging.viewer
  • roles/monitoring.viewer
  • Datenbanken bereitstellen, aktualisieren und Fehler beheben
  • roles/iam.databaseAdmin
  • roles/logging.viewer
  • roles/monitoring.viewer
  • Kosten Ihrer Anwendung im Detail verstehen und analysieren
  • roles/cloudhub.operator
  • roles/monitoring.viewer
  • roles/logging.viewer
  • Google Cloud -Ressourcen, Ordnerhierarchie, Logs, Sicherheitskonfiguration und wichtige Ressourcenmetadaten durchsuchen und ansehen.
  • roles/iam.securityAuditor
  • Gemini Cloud Assist mit Storage Insights-Datasets verwenden, um Ihre Cloud Storage-Nutzung nachzuvollziehen.
  • roles/bigquery.jobUser
  • roles/bigquery.dataViewer
  • roles/storageinsights.viewer