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.Hinweis
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.
- Erstellen Sie eine Datenbank in Ihrer Instanz, in der Sie die Tabellen erstellen. Weitere Informationen finden Sie unter Datenbank auf der Cloud SQL-Instanz erstellen.
Erforderliche Rollen und Berechtigungen
- Fügen Sie einen IAM-Nutzer oder ein Dienstkonto auf Instanzebene hinzu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung zu einem Nutzer, Dienstkonto oder einer Gruppe hinzufügen.
- 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, indem Sie sich als der passwortbasierte Nutzer der Datenbank anmelden.
GRANT ALL PRIVILEGES ON * TO "IAM_USERNAME";.
Weitere Informationen finden Sie unter Datenbankberechtigungen für einen einzelnen IAM-Nutzer oder ein einzelnes Dienstkonto 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 erteilen und die Cloud SQL Data API zu aktivieren:
gcloud components update gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID durch die ID Ihrer Cloud SQL-Instanz.
Melden Sie sich an, um die Schritte in dieser Anleitung auszuführen Cloud de Confiance by S3NS und authentifizieren Sie sich dann mit der IAM-Authentifizierung bei der Datenbank.
KI-Datenagenten erstellen
So erstellen Sie einen Daten-Agent:
Rufen Sie in der Cloud de Confiance by S3NS 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 ein. Der Name des Agents muss in der richtigen Groß- und Kleinschreibung angegeben werden und 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-central1us-east1europe-west4asia-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. Sie können den Agenten dann bearbeiten, um die Kontextdatei hochzuladen.
KI-Agenten bearbeiten
So bearbeiten Sie einen Daten-Agent:
Rufen Sie in der Cloud de Confiance 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 Cloud de Confiance 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.