Integration in die Agent Platform

Durch die Integration von AlloyDB for PostgreSQL in die Gemini Enterprise Agent Platform können Sie SQL-Abfragen ausführen, mit denen Ihre Datenbankdaten direkt an Agent Platform-Modelle zur Einbettungserstellung und für Online-Vorhersagen übergeben werden.

Diese Anleitung gilt speziell für die Verwendung von AlloyDB und nicht für AlloyDB Omni. Wenn Sie stattdessen eine lokale Installation von AlloyDB Omni mit der Agent Platform einbinden möchten, lesen Sie den Artikel 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 unter Übersicht über die Agent Platform.

Hinweis

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie eines, um zu sehen, wie sich unsere Produkte in realen Szenarien schlagen. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the 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

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the 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

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

Informationen zum AlloyDB-Dienst-Agent

Wenn Sie AlloyDB mit anderen Google Cloud Diensten verwenden, authentifiziert sich AlloyDB über einen Dienst-Agent für Identity and Access Management (IAM) bei diesen Diensten. 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 in die 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.

Hinweis: Zum Zuweisen von IAM-Rollen benötigen Sie die Berechtigung resourcemanager.projects.setiamPolicy. Die Rollen Owner und Project IAM Admin enthalten diese Berechtigung. Die Rolle AlloyDB Admin enthält auch die Berechtigungen, die zum Zuweisen der Rolle Vertex AI User an den Dienst-Agent erforderlich sind. Wenn Sie nicht die erforderlichen Berechtigungen haben, wenden Sie sich an den Administrator Ihrer Organisation.

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:

       [e-mail]
       

   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:[e-mail]" 

        --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.

Hinweis: Die Richtlinienänderung wird innerhalb von 60 Sekunden bis 7 Minuten wirksam.

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 ausführen 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.

   **Hinweis**: AlloyDB Studio stellt eine Verbindung zur primären Instanz Ihres Clusters her. Dort werden die Erweiterungsverwaltung und die ersten Vorhersagen verarbeitet, auch wenn Sie später Vorhersagen von Instanzen des Lesepools aufrufen möchten.

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

   1. Prüfen Sie, ob die Erweiterung google_ml_integration in 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.

   Hinweis: Sie müssen eine Verbindung zur primären Instanz herstellen auch wenn Sie Vorhersagen aufrufen möchten, während Sie mit einer Instanz des Lesepools verbunden sind.

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 in Version 1.4.2 oder höher installiert ist:

   SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

Nächste Schritte

• Mit Einbettungen arbeiten

• Vorhersagen aufrufen

• Kontingente und Limits für die Agent Platform

• Endpunkte für Remotemodelle aufrufen