In diesem Dokument wird beschrieben, wie Sie in Cloud SQL for MySQL 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:
Cloud SQL-Instanz vorbereiten
- Achten Sie darauf, dass Sie Zugriff auf eine vorhandene Cloud SQL-Instanz haben, oder erstellen Sie eine neue. Weitere Informationen finden Sie unter Instanzen für Cloud SQL erstellen.
- Füllen Sie die Datenbank mit den Daten und dem Schema, auf die der Endnutzer zugreifen möchte.
Erforderliche Rollen und Berechtigungen
- Fügen Sie dem Cluster auf Instanzebene einen IAM-Nutzer oder ein Dienstkonto hinzu. Weitere Informationen finden Sie unter Nutzer mit IAM-Datenbankauthentifizierung verwalten.
- Weisen Sie dem IAM-Nutzer auf Projektebene die Rollen
cloudsql.studioUserundcloudsql.instanceUserzu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen. Sie müssen einem IAM-Nutzer oder Dienstkonto auch Datenbankberechtigungen erteilen. Weitere Informationen finden Sie unter Einzelnen IAM-Nutzern oder Dienstkonten Datenbankberechtigungen erteilen.
executesql-Berechtigung für Cloud SQL-Instanz gewähren
Führen Sie den folgenden Befehl aus, um der Cloud SQL-Instanz die Berechtigung executesql zu gewähren und die Cloud SQL Data API zu aktivieren:
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID durch die ID Ihrer Cloud SQL-Instanz.
KI-Datenagenten erstellen
So erstellen Sie einen Daten-Agent:
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Cloud SQL Studio.
Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) in Studio an.
Klicken Sie im Explorer-Bereich neben Data Agents auf Aktionen ansehen.
Klicken Sie auf Agent erstellen.
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.
Optional. Fügen Sie unter Agent description (Agentenbeschreibung) eine Beschreibung für Ihren Agenten hinzu.
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
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:
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Cloud SQL Studio.
Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) in Studio an.
Klicken Sie im Explorer-Bereich neben Data Agents auf Aktionen ansehen.
Klicken Sie auf Agent bearbeiten.
Optional: Bearbeiten Sie die Agent-Beschreibung.
Klicken Sie im Abschnitt Kontextdatei des Agenten hochladen auf Durchsuchen und wählen Sie die Kontextdatei des Agenten aus.
Klicken Sie auf Speichern.
KI-Datenagenten löschen
So löschen Sie einen Daten-Agent:
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Cloud SQL Studio.
Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) in Studio an.
Klicken Sie im Explorer-Bereich neben Data Agents auf Aktionen ansehen.
Klicken Sie auf Agent löschen.
Geben Sie im Bestätigungsdialogfeld Agent löschen den Namen des Agents ein.
Klicken Sie auf Bestätigen, um den Agent zu löschen.