In diesem Dokument wird beschrieben, wie Sie Unterhaltungen in Cloud SQL for PostgreSQL erstellen, bearbeiten und löschen. Unterhaltungen sind persistente Chats mit einem KI-Datenagenten.
Sie können KI-Datenagenten mehrteilige Fragen stellen, die allgemeine Begriffe wie „Umsatz“ oder „beliebteste“ verwenden, ohne Tabellenfeldnamen anzugeben oder Bedingungen zum Filtern der Daten zu definieren. Die Chatantwort enthält die Antwort auf Ihre Frage als Text und Code und generiert gegebenenfalls 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 ein KI-Datenagent bietet.
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. Informationen zum Zuweisen von Rollen.
Erforderliche Rollen
Wenn Sie mit KI-Datenagenten arbeiten möchten, benötigen Sie eine der folgenden IAM-Rollen (Identity and Access Management) der Conversational Analytics API:
- Daten aus unterstützten Datenbankquellen mit der Methode
QueryDataabfragen: „Gemini Data Analytics Data Query User“ (roles/geminidataanalytics.queryDataUser) auf Projektebene. - Alle KI-Datenagenten im Projekt erstellen, bearbeiten, freigeben und löschen: „Gemini Data Analytics Data Agent Owner“ (
roles/geminidataanalytics.dataAgentOwner) auf Projektebene. - Eigene KI-Datenagenten im Projekt erstellen: „Gemini Data Analytics Data Agent Creator“ (
roles/geminidataanalytics.dataAgentCreator) auf Projektebene. Mit dieser Rolle wird Ihnen automatisch die Rolle „Gemini Data Analytics Data Agent Owner“ für die von Ihnen erstellten KI-Datenagenten zugewiesen. - Alle KI-Datenagenten im Projekt ansehen und bearbeiten: „Gemini Data Analytics Data Agent Editor“ (
roles/geminidataanalytics.dataAgentEditor) auf Projektebene. - Alle KI-Datenagenten im Projekt ansehen: „Gemini Data Analytics Data Agent Viewer“ (
roles/geminidataanalytics.dataAgentViewer) auf Projektebene.
Außerdem benötigen Sie die folgenden Rollen, um einen KI-Datenagenten zu erstellen oder zu bearbeiten:
- Ein IAM-Nutzer oder Dienstkonto, das der Instanz hinzugefügt wurde. Weitere Informationen finden Sie unter Nutzer mit IAM-Datenbankauthentifizierung für Cloud SQL verwalten.
- 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 zugewiesen wurden, indem er sich als
postgres-Nutzer anmeldet.GRANT ALL ON SCHEMA public TO public;Weitere Informationen finden Sie unter Datenbankberechtigungen einem einzelnen IAM-Nutzer oder Dienstkonto zuweisen.
Wenn Sie den Zugriff auf Cloud SQL for PostgreSQL-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 den Zugriff auf Objekte in der Datenbank, z. B. Tabellen, Ansichten und Schemas. Diese werden mit SQL-Befehlen wie
GRANTund datenbankspezifischen Nutzer- und Rollensystemen verwaltet.
Für Cloud SQL for PostgreSQL benötigen Sie die entsprechenden Cloud SQL-IAM-Rollen, um eine Verbindung zur Instanz herzustellen und Abfragen senden zu können. Um mit Objekten wie Tabellen und Ansichten zu interagieren, muss der verbindende Datenbanknutzer die erforderlichen Berechtigungen haben, die mit dem Cloud SQL for PostgreSQL-System GRANT gewährt wurden.
Weitere Informationen finden Sie unter
PostgreSQL-Nutzer und -Rollen.
Wenn der KI-Agent ein Dienstkonto verwendet, kann ihm eine Datenbankrolle zugewiesen werden. Weitere Informationen finden Sie beispielsweise unter
Nutzer mit IAM-Datenbankauthentifizierung verwalten.
Unterhaltungen erstellen
Sie können persistente Unterhaltungen mit einem KI-Agenten oder mit einer Datenquelle in der Google Cloud Console für Cloud SQL for PostgreSQL auf dem Tab Agentenkatalog auf der Seite KI-Agenten 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 KI-Agenten beginnen, die andere mit Ihnen teilen.
So erstellen Sie eine Unterhaltung mit einem KI-Datenagenten in der Google Cloud Console: Befolgen Sie diese Schritte:
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for PostgreSQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf KI-Agenten.
Klicken Sie im Bereich Meine KI-Agenten oder Von anderen in Ihrer Organisation freigegeben auf die Karte des KI-Agenten, mit dem Sie chatten möchten.
Klicken Sie auf Unterhaltung beginnen. Ein neuer Chatbereich wird geöffnet.
Geben Sie im Feld Eine Frage stellen eine Frage für den KI-Datenagenten ein. Beispiele: „Wie hoch war unser Gesamtumsatz im letzten Quartal?“ oder „Zeigen Sie mir die fünf Nutzer mit der längsten Sitzungsdauer.“ Sie können auch auf eine der von Gemini vorgeschlagenen Fragen klicken, um zu beginnen.
Der KI-Datenagent antwortet mit der Aktion, die er ausführt, um Ihre Frage zu beantworten, und gibt dann die Ergebnisse zurück.
Wenn Sie jeden Schritt sehen möchten, den der KI-Datenagent ausführt, um die Antwort auf Ihre Frage zu finden, klicken Sie auf Begründung anzeigen , um jede Nachricht im Begründungsprozess des KI-Agenten zu sehen.
Wenn Sie Informationen dazu sehen möchten, wie die Ergebnisse berechnet wurden, klicken Sie auf Wie wurde das berechnet? Der Bereich Zusammenfassung enthält jetzt eine generierte Abfrage, gefolgt vom Abfrageergebnis. Sie können den Code kopieren und dann auf Studio klicken, um den Code in den Abfrageeditor einzufügen.
Wenn es für die Daten geeignet ist, stellt der KI-Datenagent Diagramme, Tabellen und andere Visualisierungen bereit. Ihren Chatverlauf finden Sie in der Liste Unterhaltungsverwaltung.
Informationen zum KI-Agenten finden Sie im Bereich Details. Dieser Bereich enthält eine Beschreibung des KI-Agenten und seiner Wissensquellen.
Unterhaltungen verwalten
Sie können eine Unterhaltung auf der Seite KI-Agenten öffnen, umbenennen oder löschen.
Vorhandene Unterhaltung öffnen
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for PostgreSQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf KI-Agenten.
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 PostgreSQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf KI-Agenten.
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.
Unterhaltung löschen
Rufen Sie in der Google Cloud Console die Seite „Cloud SQL for PostgreSQL“ auf.
Wählen Sie eine Instanz aus der Liste aus.
Klicken Sie im Navigationsmenü auf KI-Agenten.
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 konversationelle Analyse funktioniert global. Sie können nicht auswählen, welche Region verwendet werden soll.
Nächste Schritte
- Weitere Informationen zur konversationellen Analyse in Cloud SQL for PostgreSQL.
- Weitere Informationen zur Conversational Analytics API.
- KI-Datenagenten in Cloud SQL for PostgreSQL erstellen.