Wenn Sie den Context-Engineering-Agenten verwenden, kann er Kontextsets automatisch über Ihre Befehlszeile erstellen und hochladen. In diesem Dokument wird beschrieben, wie Sie Kontextgruppen in Cloud SQL for MySQL Studio erstellen, bearbeiten und löschen, wenn Sie eine visuelle Oberfläche in der Google Cloud Console zum Verwalten von Kontextgruppendateien verwenden möchten. Wenn Sie einen Kontextsatz in Cloud SQL Studio erstellen, wird er in der Kontextsatzgruppe default des Projekts für die ausgewählte Region gespeichert und mit der aktuellen Datenbank verknüpft. Kontextsatznamen (und die davon abgeleiteten Kontextsatz-IDs) müssen innerhalb der Kontextsatzgruppe default des Projekts für eine bestimmte Region über alle Datenbanken und Instanzen hinweg eindeutig sein. In Cloud SQL Studio schlägt die Validierung fehl, wenn Sie einen Kontextsatz mit einem Namen erstellen, dessen abgeleitete ID bereits vorhanden ist. Wenn Sie den Inhalt überschreiben, aber die Datenbankzuordnungen beibehalten möchten, bearbeiten Sie stattdessen den vorhandenen Kontextsatz. Wenn Sie Inhalte direkt über den Context Engineering-Agenten oder die Dataplex API mit einer vorhandenen Kontextsatz-ID hochladen, werden die Inhalte und, falls angegeben, die Datenbankzuordnungen ersetzt.
In der Liste Kontextsätze in Cloud SQL Studio werden nur Kontextsätze in der Kontextsatzgruppe default in allen unterstützten Regionen angezeigt, die mit der aktuellen Datenbank verknüpft sind. Kontextsätze, die für eine andere Datenbank oder über die API erstellt wurden, ohne die Datenbankressource in databases (oder in einer benutzerdefinierten Kontextsatzgruppe) zu verknüpfen, werden nicht in der Cloud SQL Studio-Liste angezeigt.
Hinweis
Bevor Sie einen Kontextsatz erstellen oder hochladen, müssen Sie die folgenden Voraussetzungen erfüllen.
Kontextsätze können in den Regionen us-central1, us-east1, europe-west4 und asia-southeast1 erstellt werden.
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 in Ihrer Instanz eine Datenbank, in der Sie die Tabellen erstellen. Weitere Informationen finden Sie unter Datenbank auf der Cloud SQL-Instanz erstellen.
Erforderliche Rollen und Berechtigungen
- Aktivieren Sie die IAM-Datenbankauthentifizierung auf der Instanz, indem Sie das Datenbank-Flag
cloudsql_iam_authenticationaufon(cloudsql_iam_authentication=on) setzen. Weitere Informationen finden Sie unter Vorhandene Instanzen für die IAM-Datenbankauthentifizierung konfigurieren. - Fügen Sie einen IAM-Nutzer oder ein Dienstkonto auf Instanzebene hinzu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung zu Nutzern, Dienstkonten oder Gruppen hinzufügen.
- Weisen Sie dem IAM-Nutzer oder -Dienstkonto auf Projektebene die Rollen
roles/cloudsql.studioUser,roles/cloudsql.instanceUser,roles/serviceusage.serviceUsageConsumerundroles/geminidataanalytics.queryDataUserzu. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen. - Wenn Sie Kontextgruppen erstellen, hochladen und verwalten möchten, weisen Sie dem IAM-Nutzer oder -Dienstkonto auf Projektebene die Rolle „Dataplex Catalog Editor“ (
roles/dataplex.catalogEditor) oder „Dataplex Catalog Admin“ (roles/dataplex.catalogAdmin) zu. Weitere Informationen finden Sie unter Berechtigungen für Kontextgruppen. - Ein privilegierter Nutzer muss dem IAM-Nutzer oder -Dienstkonto Datenbankberechtigungen gewähren.
GRANT SELECT ON DATABASE_NAME.* TO 'IAM_USERNAME'@'%';
Ersetzen Sie DATABASE_NAME durch den Namen Ihrer Datenbank und IAM_USERNAME durch den IAM-Nutzernamen ohne das@und das Domainsuffix (z. B. wirduser@example.comzuuser, was zu'user'@'%'führt).
Weitere Informationen finden Sie unter Einem einzelnen IAM-Nutzer oder -Dienstkonto Datenbankberechtigungen gewähren.
Berechtigung executesql für die 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 sql instances patch INSTANCE_ID --project=PROJECT_ID --data-api-access=ALLOW_DATA_API
PROJECT_ID: Die ID Ihres Google Cloud -Projekts.INSTANCE_ID: Die ID Ihrer Cloud SQL-Instanz.
Kontextset erstellen
So erstellen Sie einen Kontextsatz:
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 in Cloud SQL Studio an.
Klicken Sie im Bereich Explorer neben Kontextsätze auf Aktionen ansehen.
Klicken Sie auf Kontextgruppe erstellen.
Geben Sie unter Name des Kontextsets einen eindeutigen Namen für das Kontextset ein. In Cloud SQL Studio muss der Name 4 bis 30 Zeichen lang sein und darf nicht mit einem Leerzeichen beginnen. Studio leitet die Kontextset-ID ab, indem es den Namen in Kleinbuchstaben umwandelt und nicht alphanumerische Zeichen durch Bindestriche (
-) ersetzt. Die abgeleitete Kontextset-ID muss innerhalb der Kontextset-Gruppedefaultdes Projekts für die ausgewählte Region eindeutig sein. Der Kontextsatznamequerydata_e2e_testhat beispielsweise die Kontextsatz-IDquerydata-e2e-test. Wenn Sie einen Kontextsatz direkt mit dem Kontext-Engineering-Agenten oder der Dataplex API hochladen, wird bei der Kontextsatz-ID zwischen Groß- und Kleinschreibung unterschieden. Sie darf keine Schrägstriche (/) enthalten und ist nicht auf 4 bis 30 Zeichen oder alphanumerische Zeichen, Bindestriche und Unterstriche beschränkt.Optional. Fügen Sie unter Beschreibung des Kontextsets eine Beschreibung für Ihr Kontextset hinzu.
Optional. Wenn Sie eine Kontextsatzdatei hochladen möchten, klicken Sie im Bereich Kontextsatzdatei hochladen auf Durchsuchen und wählen Sie die Kontextsatzdatei aus.
Optional. Wenn Sie eine Region für den Kontextsatz auswählen möchten, klicken Sie auf Erweiterte Optionen einblenden und wählen Sie unter Standort auswählen eine Region aus. Standardmäßig wird bei jeder Erstellung
us-east1verwendet. Wenn Sie eine andere Region alsus-east1auswählen, wählen Sie die Region aus, bevor Sie den Namen des Kontextsets eingeben, damit Cloud SQL Studio die Eindeutigkeit des Namens in dieser Region prüft.Klicken Sie auf Erstellen.
Kontextsets erstellen
Wenn Sie in Studio einen leeren Kontextsatz erstellt haben oder einen vorhandenen aktualisieren möchten, folgen Sie der Anleitung unter Kontextsätze mit dem Kontext-Engineering-Agenten erstellen und optimieren, um eine Kontextsatzdatei zu generieren und zu optimieren. Der Kontext-Engineering-Agent kann Ihr Kontextset direkt über die Befehlszeile erstellen und hochladen. Alternativ können Sie Ihr Kontextset in Studio bearbeiten, um die Kontextset-Datei manuell hochzuladen.
Kontextset bearbeiten
So bearbeiten Sie einen Kontextsatz:
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 in Cloud SQL Studio an.
Klicken Sie neben dem Kontextsatz, den Sie bearbeiten möchten, auf Aktionen ansehen.
Klicken Sie auf Kontextgruppe bearbeiten.
Optional. Bearbeiten Sie die Beschreibung des Kontextsets.
Klicken Sie im Abschnitt Kontextset-Datei hochladen auf Durchsuchen und wählen Sie die Kontextset-Datei aus.
Klicken Sie auf Speichern.
Kontextset löschen
So löschen Sie einen Kontextsatz:
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 in Cloud SQL Studio an.
Klicken Sie neben dem Kontextset, das Sie löschen möchten, auf Aktionen ansehen.
Klicken Sie auf Kontextset löschen.
Geben Sie im Bestätigungsdialogfeld Kontextgruppe löschen die ID der Kontextgruppe ein.
Klicken Sie auf Bestätigen, um den Kontextsatz zu löschen.
Nächste Schritte
- Weitere Informationen zu Kontextgruppen
- QueryData in Cloud SQL Studio testen
- Kontextsätze mit dem Context Engineering-Agenten erstellen und optimieren
- QueryData in eine Anwendung einbinden