KI-Datenagenten in AlloyDB Studio verwalten

In diesem Dokument wird beschrieben, wie Sie in AlloyDB for PostgreSQL Studio mithilfe einer Kontextdatei für den KI-Agenten einen KI-Datenagenten erstellen. Ein KI-Datenagent ist mit einer einzelnen Kontextdatei für den KI-Agenten verknüpft.

Weitere Informationen zu KI-Datenagenten finden Sie unter Übersicht über KI-Datenagenten.

Hinweis

Erfüllen Sie die folgenden Voraussetzungen, bevor Sie einen KI-Agenten erstellen.

Erforderliche Dienste aktivieren

Aktivieren Sie die folgenden Dienste für Ihr Projekt:

AlloyDB for PostgreSQL-Cluster und ‑Instanz vorbereiten

Prüfen Sie, ob Sie Zugriff auf einen vorhandenen AlloyDB-Cluster und eine vorhandene AlloyDB-Instanz haben, oder erstellen Sie einen neuen Cluster und eine neue Instanz.

Erforderliche Rollen und Berechtigungen

  • Fügen Sie dem Cluster auf Datenbankebene einen Identity and Access Management (IAM)-Nutzer oder ein Dienstkonto hinzu. Weitere Informationen finden Sie unter Datenbanknutzer verwalten.
  • Weisen Sie dem IAM-Nutzer auf Projektebene die Rolle alloydb.databaseUser und die Berechtigung serviceusage.serviceUsageConsumer zu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen.

Berechtigung executesql 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, und authentifizieren Sie sich dann mit der IAM-Authentifizierung bei der Datenbank .Google Cloud

KI-Datenagenten erstellen

So erstellen Sie einen KI-Datenagenten:

  1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

    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 bei Studio an.

  5. Klicken Sie im Bereich Explorer neben KI-Datenagenten auf Aktionen ansehen.

  6. Klicken Sie auf KI-Agenten erstellen.

  7. Geben Sie unter KI-Agentenname einen eindeutigen Namen für den KI-Agenten ein. Beim Namen des KI-Agenten wird zwischen Groß- und Kleinschreibung unterschieden. Er kann Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten.

  8. Optional. Fügen Sie unter KI-Agentenbeschreibung eine Beschreibung für den KI-Agenten hinzu.

  9. Optional. Klicken Sie auf Erweiterte Optionen anzeigen und wählen Sie unter Standort auswählen eine Region für den Kontext des KI-Agenten 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.

Kontext für den KI-Agenten erstellen

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

KI-Agenten bearbeiten

So bearbeiten Sie einen KI-Datenagenten:

  1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

    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 bei Studio an.

  5. Klicken Sie im Bereich Explorer neben KI-Datenagenten auf Aktionen ansehen.

  6. Klicken Sie auf KI-Agenten bearbeiten.

  7. Optional: Bearbeiten Sie die KI-Agentenbeschreibung.

  8. Klicken Sie im Bereich Kontextdatei für KI-Agenten hochladen auf Durchsuchen und wählen Sie die Kontextdatei für den KI-Agenten aus.

  9. Klicken Sie auf Speichern.

KI-Datenagenten löschen

So löschen Sie einen KI-Datenagenten:

  1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

    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 bei Studio an.

  5. Klicken Sie im Bereich Explorer neben KI-Datenagenten auf Aktionen ansehen.

  6. Klicken Sie auf KI-Agenten löschen.

  7. Geben Sie im Bestätigungsdialogfeld KI-Agenten löschen den Namen des KI-Agenten ein.

  8. Klicken Sie auf Bestätigen , um den KI-Agenten zu löschen.

Nächste Schritte