Projekt- und Entwicklungsumgebung einrichten

Auf dieser Seite erfahren Sie, wie Sie ein Cloud de Confiance by S3NS -Projekt erstellen und die Agent Platform APIs aktivieren, um mit der Gemini Enterprise Agent Platform zu beginnen. Wenn Sie nicht die Berechtigungen zum Ausführen dieser Aufgaben haben, bitten Sie einen Administrator, ein Projekt einzurichten und die Gemini Enterprise Agent Platform für Sie zu aktivieren. Auf dieser Seite wird auch beschrieben, wie Sie die Google Cloud CLI in Ihrer lokalen Entwicklungsumgebung einrichten.

Projekt einrichten

So richten Sie ein Projekt ein:

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

Authentifizierung einrichten

    Wählen Sie die Tabs für die Art und Weise aus, wie Sie auf die API zugreifen möchten:

    Console

    Wenn Sie über die Cloud de Confiance Console auf Cloud de Confiance by S3NS -Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    1. Installieren Sie die Google Cloud CLI.

    2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

      Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    3. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

      gcloud init

    4. Aktualisieren Sie die gcloud CLI nach der Initialisierung und installieren Sie die erforderlichen Komponenten: 

      gcloud components update
gcloud components install beta

    Führen Sie den folgenden Befehl aus, um die gcloud CLI so einzurichten, dass die Authentifizierung bei Google APIs über die Identitätsübernahme des Dienstkontos anstelle Ihrer Nutzeranmeldedaten erfolgt: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.

    Clientbibliotheken

    Wenn Sie Clientbibliotheken in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

    1. Installieren Sie die Google Cloud CLI.

    2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

      Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    3. Aktualisieren Sie die gcloud CLI nach der Initialisierung und installieren Sie die erforderlichen Komponenten: 

      gcloud components update
gcloud components install beta

    4. Erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto: 

      gcloud auth application-default login

      Wenn ein Authentifizierungsfehler zurückgegeben wird, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

    Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter ADC für eine lokale Entwicklungsumgebung einrichten.

    Führen Sie den folgenden Befehl aus, um die lokale ADC-Datei so einzurichten, dass die Authentifizierung bei Google APIs über die Identitätsübernahme des Dienstkontos anstelle Ihrer Nutzeranmeldedaten erfolgt: 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.

    REST

    Wenn Sie die REST API in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

    1. Installieren Sie die Google Cloud CLI.

    2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

      Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    3. Aktualisieren Sie die gcloud CLI nach der Initialisierung und installieren Sie die erforderlichen Komponenten: 

      gcloud components update
gcloud components install beta

    Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Für die Verwendung von REST authentifizieren.

    Sie können die Identitätsübernahme des Dienstkontos verwenden, um ein Zugriffstoken für REST API-Anfragen zu generieren. Weitere Informationen finden Sie unter Dienstkonto mit Identitätsübernahme.

    Informationen zum Einrichten der Authentifizierung für eine Produktionsumgebung finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Standardanmeldedaten für Anwendungen für Code einrichten, der auf Cloud de Confianceausgeführt wird .

Bitten Sie einen Administrator, ein Gemini Enterprise Agent Platform-Projekt für Sie einzurichten.

In diesem Abschnitt wird beschrieben, wie ein Administrator die Rollen zuweist, die für die Verwendung der Gemini Enterprise Agent Platform erforderlich sind.

  1. Legen Sie einen aussagekräftigen Projektnamen und eine Projekt-ID fest, um Ihr Projekt zu identifizieren. Wenn Sie Teil einer Organisation sind oder mehrere Projekte erstellen möchten, sollten Sie sich überlegen, welche Namenskonventionen und Ordnerhierarchien befolgt werden oder befolgt werden könnten, um die Projektorganisation klar zu gestalten.
  2. Erforderliche Rollen:
    1. Der Zugriff auf die meisten Funktionen der Gemini Enterprise Agent Platform wird durch die IAM-Rolle Gemini Enterprise Agent Platform-Nutzer (roles/aiplatform.user) gewährt und sollte für die meisten Nutzer der Gemini Enterprise Agent Platform ausreichend sein. Für uneingeschränkten Zugriff auf Gemini Enterprise Agent Platform-Ressourcen können Sie die Rolle Gemini Enterprise Agent Platform-Administrator (roles/aiplatform.admin) anfordern. Informationen zu den Unterschieden zwischen diesen und anderen Rollen der Gemini Enterprise Agent Platform finden Sie unter Zugriffssteuerung für die Gemini Enterprise Agent Platform mit IAM.
    2. Wenn Sie auch Gemini Enterprise Agent Platform Workbench-Instanzen in Cloud de Confiance by S3NSverwenden möchten, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Notebooks Administrator (roles/notebooks.admin) für das Projekt sowie die IAM-Rolle Service Account User (roles/iam.serviceAccountUser) für das Projekt oder das Compute Engine-Standarddienstkonto zuzuweisen.
    3. Zum Aktivieren der erforderlichen APIs benötigen Sie außerdem die IAM-Rolle Service Usage-Administrator (roles/serviceusage.serviceUsageAdmin) oder Ihr Administrator muss die APIs über die folgenden ersten Schritte für Sie aktivieren.
  3. Bitten Sie Ihren Administrator, die Agent Platform APIs für Sie zu aktivieren. Wenn Ihnen die IAM-Rolle Service Usage-Administrator (roles/serviceusage.serviceUsageAdmin) zugewiesen ist, können Sie dies selbst tun.

Nächste Schritte