Integration in die Agent Platform

Auf dieser Seite wird beschrieben, wie Sie die Integration zwischen AlloyDB for PostgreSQL und der Gemini Enterprise Agent Platform einrichten, damit Sie Abfragen ausführen können, die Ihre Daten an Agent Platform-Modelle übergeben.

Diese Anleitung bezieht sich speziell auf die Verwendung von AlloyDB und nicht von AlloyDB Omni. Wenn Sie stattdessen eine lokale Installation von AlloyDB Omni mit der Agent Platform einbinden möchten, lesen Sie AlloyDB Omni mit AlloyDB AI installieren.

Weitere Informationen zur Verwendung von ML-Modellen mit AlloyDB finden Sie unter Generative AI-Anwendungen mit AlloyDB AI erstellen.

Weitere Informationen zur Agent Platform finden Sie in der Übersicht zur Agent Platform.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Konto bei Google Cloudhaben, erstellen Sie ein Konto, um die Leistung unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Agent Platform API.

    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

  5. Installieren Sie die Google Cloud CLI.

  6. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

    gcloud init

  8. In the Google Cloud console, on the project selector page, select or create a Google Cloud 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

  9. Verify that billing is enabled for your Google Cloud project.

  10. Enable the Agent Platform API.

    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

  11. Installieren Sie die Google Cloud CLI.

  12. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

    gcloud init

Informationen zum AlloyDB-Dienst-Agent

Wenn Sie AlloyDB mit anderen Google Cloud Diensten verwenden, verwendet AlloyDB einen Dienst-Agent für die Identitäts- und Zugriffsverwaltung (Identity and Access Management, IAM), um sich bei diesen Diensten zu authentifizieren. Dieser Dienst-Agent ist ein IAM-Hauptkonto, das von AlloyDB gesteuert wird. Sie weisen diesem Dienst-Agent IAM-Rollen zu, damit er in Ihrem Namen auf andere Google Cloud Dienste zugreifen kann.

Dem AlloyDB-Dienst-Agent die Rolle Vertex AI User zuweisen

Um die Datenbankintegration mit der Agent Platform zu aktivieren, weisen Sie dem AlloyDB-Dienst-Agent die Rolle Vertex AI User zu. Dadurch kann der AlloyDB-Dienst-Agent in Ihrem Namen auf die Agent Platform zugreifen.

So weisen Sie dem AlloyDB-Dienst-Agent die Rolle Vertex AI User zu:

Fügen Sie dem AlloyDB-Dienst-Agent Berechtigungen für die Agent Platform für das Projekt hinzu, in dem sich der Cluster der AlloyDB-Datenbank befindet:

Console

  1. Rufen Sie in der Google Cloud console die Seite Willkommen auf und kopieren Sie die Projektnummer des Projekts mit AlloyDB-Clustern oder ‑Instanzen. Sie verwenden diese Projektnummer in den nächsten Schritten.

    Willkommen aufrufen

  2. Rufen Sie in der Google Cloud Console die Seite IAM auf.

    IAM aufrufen

  3. Wählen Sie das Projekt aus, das Agent Platform-Endpunkte aufrufen muss.

  4. Aktivieren Sie Von Google bereitgestellte Rollenzuweisungen einschließen.

  5. Klicken Sie auf Zugriff gewähren.

  6. Geben Sie im Feld Neue Hauptkonten Folgendes ein:

        service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

    Ersetzen Sie PROJECT_NUMBER durch die Projektnummer.

  7. Geben Sie im Feld Rolle die Option Vertex AI User ein.

  8. Klicken Sie auf Speichern.

gcloud

Wenn Sie die gcloud CLI verwenden möchten, können Sie die Google Cloud CLI installieren und initialisieren oder Sie können Cloud Shell verwenden.

        gcloud projects add-iam-policy-binding PROJECT_ID 

        --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com" 

        --role="roles/aiplatform.user"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID des Projekts mit dem Agent Platform-Endpunkt.
  • PROJECT_NUMBER: Die Projektnummer des Projekts mit AlloyDB-Clustern oder ‑Instanzen.

Installierte Erweiterung prüfen

Prüfen Sie, ob die Erweiterung google_ml_integration in der Datenbank installiert ist, die die Daten enthält, für die Sie Vorhersagen erhalten möchten:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Cluster auf.

    Zu den Clustern

  2. Klicken Sie in der Spalte Ressourcenname auf den Namen des AlloyDB-Clusters, um die Seite Übersicht des Clusters aufzurufen.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Authentifizieren Sie sich auf der Seite In AlloyDB Studio anmelden mit dem Namen Ihrer Datenbank, Ihrem Nutzernamen und Ihrem Passwort.

  5. Führen Sie auf dem Tab Editor 1 folgende Schritte aus:

    1. Prüfen Sie, ob die Erweiterung google_ml_integration Version 1.4.2 oder höher installiert ist:

      SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

    2. Klicken Sie auf Ausführen. Warten Sie, bis die Erweiterungsversion im Bereich Ergebnisse angezeigt wird.

psql

  1. Stellen Sie eine Verbindung von einem psql-Client zur primären Instanz des Clusters her, wie unter Verbinden eines psql-Clients mit einer Instanz beschrieben.

  2. Stellen Sie an der psql-Eingabeaufforderung eine Verbindung zur Datenbank her: 

    \c DB_NAME

    Ersetzen Sie DB_NAME durch den Namen der Datenbank, in der Sie die Erweiterung installieren möchten.

  3. Prüfen Sie, ob die Erweiterung google_ml_integration Version 1.4.2 oder höher installiert ist: 

    SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

Nächste Schritte