In diesem Dokument wird beschrieben, wie Sie Unterhaltungen in Cloud SQL for MySQL erstellen, bearbeiten und löschen. Unterhaltungen sind gespeicherte Chats mit einem KI-Datenagenten.
Sie können Daten-Agents mehrteilige Fragen mit gängigen Begriffen wie „Umsatz“ oder „beliebteste“ stellen, ohne Tabellenfeldnamen anzugeben oder Bedingungen zum Filtern der Daten zu definieren. Die Chatantwort enthält die Antwort auf Ihre Frage in Form von Text und Code und generiert bei Bedarf Diagramme. Die Antwort enthält die Begründung für die Ergebnisse.
Sie können eine Unterhaltung mit einem KI-Datenagenten erstellen. Wenn Sie eine direkte Unterhaltung erstellen, interpretiert die Conversational Analytics API Ihre Frage ohne den Kontext und die Verarbeitungsanweisungen, die von einem KI-Datenagenten bereitgestellt werden.
Hinweis
-
Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.
-
Aktivieren Sie die Cloud SQL-, Data Analytics API with Gemini- und Gemini for Google Cloud APIs.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (
roles/serviceusage.serviceUsageAdmin), die die Berechtigungserviceusage.services.enableenthält. Weitere Informationen zum Zuweisen von Rollen
Erforderliche Rollen
Wenn Sie mit Daten-Agents arbeiten möchten, benötigen Sie eine der folgenden IAM-Rollen (Identity and Access Management) für die Conversational Analytics API:
- Daten aus unterstützten Datenbankquellen mit der Methode
QueryDataabfragen: Gemini Data Analytics Data Query User (roles/geminidataanalytics.queryDataUser) auf Projektebene. - Alle Daten-Agents im Projekt erstellen, bearbeiten, freigeben und löschen: „Gemini Data Analytics Data Agent Owner“ (
roles/geminidataanalytics.dataAgentOwner) auf Projektebene. - Eigene Daten-Agents im Projekt erstellen:
Gemini Data Analytics Data Agent Creator (
roles/geminidataanalytics.dataAgentCreator) auf Projektebene. Mit dieser Rolle erhalten Sie automatisch die Rolle „Gemini Data Analytics Data Agent Owner“ für die von Ihnen erstellten Daten-Agents. - Alle Daten-Agents im Projekt ansehen und bearbeiten: „Gemini Data Analytics Data Agent Editor“ (
roles/geminidataanalytics.dataAgentEditor) auf Projektebene. - Alle Data Agents im Projekt ansehen: „Gemini Data Analytics Data Agent Viewer“ (
roles/geminidataanalytics.dataAgentViewer) auf Projektebene.
Außerdem benötigen Sie die folgenden Rollen, um einen Daten-Agent zu erstellen oder zu bearbeiten:
- Ein IAM-Nutzer oder -Dienstkonto, das auf Instanzebene hinzugefügt wurde. Weitere Informationen finden Sie unter IAM-Richtlinienbindung zu einem Nutzer, Dienstkonto oder einer Gruppe hinzufügen.
- Die Rollen
cloudsql.studioUserundcloudsql.instanceUser, die dem IAM-Nutzer auf Projektebene zugewiesen wurden. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen. Datenbankberechtigungen, die einem IAM-Nutzer oder Dienstkonto erteilt werden, indem Sie sich als passwortbasierter Nutzer der Datenbank anmelden.
GRANT ALL PRIVILEGES ON *.* TO 'your-iam-user@example.com';Weitere Informationen finden Sie unter Einzelnen IAM-Nutzern oder Dienstkonten Datenbankberechtigungen erteilen.
Wenn Sie den Zugriff auf Cloud SQL for MySQL-Datenbankressourcen verwalten, sollten Sie die folgenden Berechtigungsebenen berücksichtigen:
- Google Cloud IAM: Steuert den Zugriff auf die Datenbankinstanz als Cloud-Ressource. Dazu gehören Berechtigungen zum Herstellen einer Verbindung, zum Verwalten der Instanz und zum Ausführen von SQL-Abfragen, z. B. mit der Berechtigung
executeSql. - Datenbankberechtigungen: Steuern Sie den Zugriff auf Objekte in der Datenbank, z. B. Tabellen, Ansichten und Schemas. Sie werden mit SQL-Befehlen wie
GRANTund datenbankspezifischen Nutzer- und Rollensystemen verwaltet.
Für Cloud SQL for MySQL benötigen Sie die entsprechenden Cloud SQL-IAM-Rollen, um eine Verbindung zur Instanz herzustellen und autorisiert zu sein, Anfragen zu senden. Um mit Objekten wie Tabellen und Ansichten zu interagieren, muss dem Datenbanknutzer, der die Verbindung herstellt, die erforderlichen Berechtigungen über das Cloud SQL for MySQL-GRANT-System gewährt werden. Weitere Informationen finden Sie unter Cloud SQL for MySQL-Nutzer.
Wenn der Agent ein Dienstkonto verwendet, können Sie ihm eine Datenbankrolle zuweisen. Ein Beispiel finden Sie unter Nutzer mit IAM-Datenbankauthentifizierung verwalten.
Unterhaltungen erstellen
Sie können in der Google Cloud Console für Cloud SQL for MySQL auf der Seite Agents auf dem Tab Agent Catalog (Agent-Katalog) dauerhafte Unterhaltungen mit einem Agent oder einer Datenquelle erstellen.
Unterhaltung mit einem KI-Datenagenten erstellen
Wenn Sie eine Unterhaltung mit einem KI-Datenagenten erstellen möchten, müssen Sie zuerst einen KI-Datenagenten erstellen und veröffentlichen. Sie können auch eine Unterhaltung mit Agents starten, die andere mit Ihnen teilen.
So erstellen Sie eine Unterhaltung mit einem Daten-Agent in der Google Cloud Console:
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for MySQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Agents.
Klicken Sie im Bereich Meine KI-Agents oder Von anderen in Ihrer Organisation geteilt auf die Agent-Karte des Agents, mit dem Sie chatten möchten.
Klicken Sie auf Unterhaltung beginnen. Ein neues Chatfeld wird geöffnet.
Geben Sie im Feld Frage stellen eine Frage für den Daten-Agent ein. Beispiele: „Wie hoch war unser Gesamtumsatz im letzten Quartal?“ oder „Zeige mir die fünf Nutzer mit der längsten Sitzungsdauer.“ Sie können auch auf eine der von Gemini vorgeschlagenen Fragen klicken, um loszulegen.
Der Daten-Agent antwortet, indem er die Maßnahme angibt, die er ergreift, um Ihre Frage zu beantworten, und gibt dann die Ergebnisse zurück.
Wenn Sie sehen möchten, welche Schritte der Daten-Agent ausführt, um die Antwort auf Ihre Frage zu liefern, klicken Sie auf Begründung anzeigen.
Wenn Sie Informationen dazu sehen möchten, wie die Ergebnisse berechnet wurden, klicken Sie auf Wie wurde das berechnet?. Der Abschnitt Zusammenfassung enthält jetzt eine generierte Abfrage, gefolgt vom Abfrageergebnis. Sie können den Code kopieren und dann auf Studio klicken, um ihn in den Abfrageeditor einzufügen.
Wenn es für die Daten angemessen ist, stellt der Daten-Agent Diagramme, Tabellen und andere Visualisierungen bereit. Wenn Sie Ihren Chatverlauf aufrufen möchten, gehen Sie zur Liste Unterhaltungsverwaltung.
Agent-Informationen finden Sie im Bereich Details. Dieser Bereich enthält eine Beschreibung des Agents und seiner Wissensquellen.
Unterhaltungen verwalten
Auf der Seite KI-Agenten können Sie eine Unterhaltung öffnen, umbenennen oder löschen.
Vorhandene Unterhaltung öffnen
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for MySQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Agents.
Klicken Sie auf dem Tab Unterhaltungen in der Liste der Unterhaltungen auf die Unterhaltung, die Sie öffnen möchten.
Unterhaltung umbenennen
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for MySQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Agents.
Klicken Sie auf dem Tab Unterhaltungen in der Liste der Unterhaltungen auf die Unterhaltung, die Sie umbenennen möchten.
Klicken Sie auf Aktionen ansehen > Umbenennen.
Geben Sie im Dialogfeld Unterhaltung umbenennen im Feld Name der Unterhaltung einen neuen Namen für die Unterhaltung ein.
Klicken Sie auf Umbenennen.
Unterhaltungen löschen
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for MySQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf Agents.
Klicken Sie auf dem Tab Unterhaltungen in der Liste der Unterhaltungen auf die Unterhaltung, die Sie löschen möchten.
Klicken Sie auf Aktionen ansehen > Löschen.
Klicken Sie im Dialogfeld Unterhaltung löschen? auf Löschen.
Standorte
Die Funktion für konversationelle Analysen ist global verfügbar. Sie können nicht auswählen, welche Region verwendet werden soll.
Nächste Schritte
- Weitere Informationen
- Weitere Informationen zur Conversational Analytics API
- Daten-Agent in Cloud SQL for MySQL erstellen