Integration in die Agent Platform

Wenn Sie AlloyDB for PostgreSQL in die Gemini Enterprise Agent Platform einbinden, können Sie SQL-Abfragen ausführen, die Ihre Datenbankdaten direkt an Agent Platform-Modelle übergeben, um Einbettungen zu generieren und Onlinevorhersagen zu treffen.

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

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

Weitere Informationen zur Agent Platform finden Sie unter Agent Platform – Übersicht.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit 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.

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

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

Weisen Sie dem AlloyDB-Dienst-Agent die Rolle Vertex AI User zu.

Wenn Sie die Datenbankeinbindung in die Agent Platform aktivieren möchten, weisen Sie dem AlloyDB-Dienst-Agenten 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 „Inhaber“ und „IAM-Administrator für Projekte“ enthalten diese Berechtigung. Die Rolle „AlloyDB Admin“ enthält auch die Berechtigungen, die erforderlich sind, um dem Dienst-Agent die Rolle „Vertex AI User“ zu gewähren. 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 für das Projekt, in dem sich der Cluster der AlloyDB-Datenbank befindet, Agent Platform-Berechtigungen hinzu:

Console

1. Rufen Sie in der Google Cloud Console die Seite Willkommen auf und kopieren Sie die Projektnummer des Projekts, das AlloyDB-Cluster oder -Instanzen enthält. Sie benötigen diese Projektnummer in den nächsten Schritten.

   Zur Begrüßungsseite

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 den Text 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 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, das AlloyDB-Cluster oder -Instanzen enthält.

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

Installierte Erweiterung prüfen

Prüfen Sie, ob 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 Übersichtsseite 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, auf der die Erweiterungsverwaltung und die ersten Vorhersagen verarbeitet werden, auch wenn Sie später Vorhersagen von Lesepoolinstanzen aufrufen möchten.

5. Führen Sie im Tab Editor 1 die folgenden Schritte aus:

   1. Prüfen Sie, ob die google_ml_integration-Erweiterung 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 psql-Client mit einer Instanz verbinden beschrieben.

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

2. Stellen Sie über die Eingabeaufforderung psql 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 google_ml_integration-Erweiterung 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

• Remote-Modellendpunkte aufrufen