KI-Datenagenten in AlloyDB Studio verwalten

In diesem Dokument wird beschrieben, wie Sie in AlloyDB for PostgreSQL Studio einen Daten-KI-Agenten mit einer Agentenkontextdatei erstellen. Ein Daten-Agent ist mit einer einzelnen Agent-Kontextdatei verknüpft.

Weitere Informationen zu Daten-Agents finden Sie unter Daten-Agents – Übersicht.

Hinweise

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie einen Agent erstellen.

Erforderliche Dienste aktivieren

Aktivieren Sie die folgenden Dienste für Ihr Projekt:

AlloyDB for PostgreSQL-Cluster und ‑Instanz vorbereiten

Achten Sie darauf, dass Sie Zugriff auf einen vorhandenen AlloyDB-Cluster und eine vorhandene AlloyDB-Instanz haben, oder erstellen Sie einen neuen.

Erforderliche Rollen und Berechtigungen

executesql-Berechtigung für AlloyDB for PostgreSQL-Instanz erteilen

Verwenden Sie den folgenden curl-Befehl, um der AlloyDB for PostgreSQL-Instanz die Berechtigung executesql zu erteilen und die Instanzeinstellung data_api_access auf den Wert ALLOW_DATA_API festzulegen : 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
Ersetzen Sie Folgendes:
  • PROJECT_ID: Die ID Ihres Google Cloud -Projekts.
  • LOCATION: Die Region, in der sich Ihr AlloyDB-Cluster befindet.
  • CLUSTER_ID: Die ID Ihres AlloyDB-Clusters.
  • INSTANCE_ID: Die ID Ihrer AlloyDB-Instanz.
Melden Sie sich an, um die Schritte in dieser Anleitung auszuführen Google Cloud und authentifizieren Sie sich dann mit der IAM-Authentifizierung bei der Datenbank.

KI-Datenagenten erstellen

So erstellen Sie einen Daten-Agent:

  1. Rufen Sie in der Google Cloud Console die Seite „AlloyDB“ auf.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) in Studio an.

  5. Klicken Sie im Explorer-Bereich neben Data Agents auf Aktionen ansehen.

  6. Klicken Sie auf Agent erstellen.

  7. Geben Sie unter Agent name (Agent-Name) einen eindeutigen Namen für den Agenten an. Beim Namen des Agents wird zwischen Groß- und Kleinschreibung unterschieden. Er kann Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten.

  8. Optional. Fügen Sie unter Agent description (Agentenbeschreibung) eine Beschreibung für Ihren Agenten hinzu.

  9. Optional. Klicken Sie auf Erweiterte Optionen ansehen und wählen Sie unter Standort auswählen eine Region zum Speichern des Agentenkontexts aus. Sie können aus der folgenden Liste der unterstützten Regionen auswählen:

    • us-central1
    • us-east1
    • europe-west4
    • asia-southeast1

  10. Klicken Sie auf Erstellen.

Agentenkontext erstellen

Nachdem Sie einen Agent erstellt haben, folgen Sie der Anleitung unter Kontexte mit der Gemini CLI erstellen, um eine Agent-Kontextdatei zu erstellen. Anschließend können Sie den Agenten bearbeiten, um die Kontextdatei hochzuladen.

KI-Agenten bearbeiten

So bearbeiten Sie einen Daten-Agent:

  1. Rufen Sie in der Google Cloud Console die Seite „AlloyDB“ auf.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) in Studio an.

  5. Klicken Sie im Explorer-Bereich neben Data Agents auf Aktionen ansehen.

  6. Klicken Sie auf Agent bearbeiten.

  7. Optional: Bearbeiten Sie die Agent-Beschreibung.

  8. Klicken Sie im Abschnitt Agent-Kontextdatei hochladen auf Durchsuchen und wählen Sie die Agent-Kontextdatei aus.

  9. Klicken Sie auf Speichern.

KI-Datenagenten löschen

So löschen Sie einen Daten-Agent:

  1. Rufen Sie in der Google Cloud Console die Seite „AlloyDB“ auf.

    Zu AlloyDB

  2. Wählen Sie einen Cluster aus der Liste aus.

  3. Klicken Sie im Navigationsmenü auf AlloyDB Studio.

  4. Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) in Studio an.

  5. Klicken Sie im Explorer-Bereich neben Data Agents auf Aktionen ansehen.

  6. Klicken Sie auf Agent löschen.

  7. Geben Sie im Bestätigungsdialogfeld Agent löschen den Namen des Agents ein.

  8. Klicken Sie auf Bestätigen, um den Agent zu löschen.

Nächste Schritte