Projekt für ein Team einrichten

Auf dieser Seite finden Sie Beispiele dafür, wie Sie ein Projekt für ein Team einrichten können, das mit der Gemini Enterprise Agent Platform arbeitet. Auf dieser Seite wird davon ausgegangen, dass Sie bereits mit IAM-Konzepten (Identity and Access Management) wie Richtlinien, Rollen, Berechtigungen und Hauptkonten vertraut sind, wie unter Zugriffssteuerung für die Agent Platform mit IAM und Konzepte der Zugriffsverwaltung beschrieben.

Diese Beispiele sind für die allgemeine Verwendung gedacht. Berücksichtigen Sie die spezifischen Anforderungen des Teams und passen Sie die Einrichtung des Projekts entsprechend an.

Übersicht

Die Agent Platform verwendet IAM, um den Zugriff auf Ressourcen zu verwalten. Berücksichtigen Sie bei der Planung der Zugriffssteuerung für Ihre Ressourcen Folgendes:

  • Sie können den Zugriff auf Projekt- oder Ressourcenebene verwalten. Der Zugriff auf Projektebene gilt für alle Ressourcen in diesem Projekt. Der Zugriff auf eine bestimmte Ressource gilt nur für diese Ressource.

  • Sie gewähren Zugriff, indem Sie Hauptkonten IAM-Rollen zuweisen. Vordefinierte Rollen sind verfügbar, um die Einrichtung des Zugriffs zu vereinfachen. Es werden jedoch benutzerdefinierte Rollen empfohlen, da Sie diese erstellen und den Zugriff auf die erforderlichen Berechtigungen beschränken können.

Weitere Informationen zur Zugriffssteuerung finden Sie unter Zugriffssteuerung für die Agent Platform mit IAM.

Einzelnes Projekt mit freigegebenem Zugriff auf Daten und Agent Platform-Ressourcen

In diesem Beispiel teilt ein Team ein einzelnes Projekt, das seine Daten und Agent Platform-Ressourcen enthält.

Sie können ein Projekt so einrichten, wenn die Daten, Container und anderen Agent Platform-Ressourcen des Teams für alle Nutzer des Projekts freigegeben werden können.

Die IAM-Zulassungsrichtlinie Ihres Projekts könnte in etwa so aussehen:

{
  "version": 1,
  "etag": "BwWKmjvelug=",
  "bindings": [
    {
      "role": "roles/aiplatform.user",
      "members": [
        "user:USER1_EMAIL_ADDRESS",
        "user:USER2_EMAIL_ADDRESS"
      ]
    },
    {
      "role": "roles/storage.admin",
      "members": [
        "user:USER1_EMAIL_ADDRESS",
        "user:USER2_EMAIL_ADDRESS"
      ]
    },
    {
      "role": "roles/aiplatform.serviceAgent",
      "members": [
        "user:service-PROJECT_NUMBER@gcp-sa-aiplatform-cc.iam.gserviceaccount.com"
      ]
    }
  ]
}

Wenn Sie ein Projekt auf diese Weise einrichten, kann ein Team leichter zusammenarbeiten, um Modelle zu trainieren, Code zu debuggen, Modelle bereitzustellen und Endpunkte zu beobachten. Alle Nutzer sehen dieselben Ressourcen und können mit denselben Daten trainieren. Agent Platform-Ressourcen werden innerhalb eines einzelnen Projekts ausgeführt. Sie müssen also keinen Zugriff auf Ressourcen außerhalb des Projekts gewähren. Das Kontingent wird im Team geteilt.

Informationen zum Einrichten der Zugriffssteuerung für das Projekt Ihres Teams finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Separate Daten- und Agent Platform-Ressourcen

In diesem Beispiel befinden sich die Daten des Teams in einem Projekt, das von den Agent Platform-Ressourcen getrennt ist.

In folgenden Fällen kann es sinnvoll sein, ein Projekt so einzurichten:

  • Die Daten des Teams sind zu schwer in dasselbe Projekt wie Ihre Agent Platform-Ressourcen zu verschieben.

  • Die Daten des Teams erfordern eine spezifische Kontrolle darüber, wer darauf zugreifen kann.

In diesen Fällen empfehlen wir, ein Projekt für die Daten und ein Projekt für Agent Platform-Ressourcen zu erstellen. Die Entwickler des Teams teilen das Projekt, das die Agent Platform-Ressourcen enthält. Sie verwenden die Agent Platform-Ressourcen, um auf die im anderen Projekt gespeicherten Daten zuzugreifen und sie zu verarbeiten. Datenadministratoren gewähren den Agent-Plattformressourcen Zugriff über Dienst-Agents oder benutzerdefinierte Dienstkonten.

Sie können beispielsweise den Standard-Dienst-Agents der Agent-Plattform Zugriff auf einen Cloud Storage-Bucket mit einer Zulassungsrichtlinie wie der folgenden gewähren:

{
  "version": 1,
  "etag": "BwWKmjvelug=",
  "bindings": [
    {
      "role": "roles/storage.objectViewer",
      "members": [
        "user:service-PROJECT_NUMBER@gcp-sa-aiplatform-cc.iam.gserviceaccount.com",
        "user:service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com"
      ]
    }
  ]
}

Geben Sie nach Möglichkeit ein Dienstkonto an, das als Ressourcenidentität verwendet werden soll, wenn Sie Agent Platform-Ressourcen erstellen, und verwenden Sie dieses Dienstkonto, um die Zugriffssteuerung zu verwalten. So können Sie bestimmten Ressourcen einfacher Zugriff auf die Daten gewähren und Berechtigungen im Laufe der Zeit verwalten.

Sie können beispielsweise einem Dienstkonto Zugriff auf BigQuery mit einer Richtlinie wie der folgenden gewähren:

{
  "version": 1,
  "etag": "BwWKmjvelug=",
  "bindings": [
    {
      "role": "roles/bigquery.user",
      "members": [
        "user:SERVICE_ACCOUNT_NAME@PROJECT_NUMBER.iam.gserviceaccount.com"
      ]
    }
  ]
}

Informationen zum Einrichten der Zugriffssteuerung für Dienstkonten finden Sie unter Zugriff auf Dienstkonten verwalten.

Im Projekt mit den Agent Platform-Ressourcen können Administratoren Nutzern Zugriff auf die Daten gewähren, indem sie ihnen die Rolle „Dienstkontonutzer“ (roles/iam.serviceAccountUser) für die angegebenen Dienstkonten zuweisen.

Weniger vertrauenswürdigen Code in zusätzlichen separaten Projekten isolieren

Modelle, Vorhersagecontainer und Trainingscontainer sind Code. Es ist wichtig, weniger vertrauenswürdigen Code von sensiblen Modellen und Daten zu isolieren. Sie sollten Endpunkte und Trainingsphasen in eigenen Projekten bereitstellen, ein spezielles Dienstkonto mit sehr eingeschränkten Berechtigungen verwenden und VPC Service Controls nutzen, um sie zu isolieren und die Auswirkungen des Zugriffs auf solche Container und Modelle zu verringern.

Nächste Schritte