KI-Datenagenten erstellen

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Mit konversationellen Daten-Agents können Sie über eine Schnittstelle in natürlicher Sprache mit Ihren Datenbankdaten interagieren. Durch das Erstellen dieser Agents können Nutzer ihre Daten analysieren und Statistiken aus Betriebsdatenbanken erstellen, ohne komplexe SQL-Abfragen schreiben zu müssen.

Ein Daten-Agent ist eine Kombination aus einer Persona, einer Reihe von Datenquellen und dem Zugriff auf eine Reihe von geschäftlichem Wissen, das für seine Zwecke entscheidend ist.

Für Anwendungsentwickler bieten diese Agents folgende Vorteile:

• Hohe Genauigkeit: Mit selbst erstelltem Kontext können Sie eine hohe Genauigkeit für bestimmte geschäftliche Fragen erzielen. Selbst erstellter Kontext ist der wichtigste Faktor, mit dem Agent-Ersteller die Genauigkeit verbessern können. Er umfasst Schemabeschreibungen, Systemanweisungen und strukturierten Kontext, der zusätzliche Informationen zu erwarteten Datenbankabfragen enthält.
• Weniger Komplexität: Agents übersetzen natürliche Sprache in SQL-Abfragen, führen diese aus und können sogar Daten zusammenfassen oder visualisieren.
• Flexibilität: Sie können Agents für persönliche Tests entwerfen oder sie veröffentlichen, um sie anderen Nutzern in Ihrem Projekt zur Verfügung zu stellen oder programmatisch über die API zu verwenden.

Hinweis

1. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

2. Aktivieren Sie AlloyDB for PostgreSQL, die 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 Berechtigung serviceusage.services.enable enthält. Informationen zum Zuweisen von Rollen.

   APIs aktivieren

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:

• Abfragedaten aus unterstützten Datenbankquellen mit der Methode QueryData: Gemini Data Analytics Data Query User (roles/geminidataanalytics.queryDataUser) auf Projektebene.
• Eigene Daten-Agents 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 Daten-Agents zugewiesen.
• Alle Daten-Agents im Projekt bearbeiten, freigeben und löschen: Gemini Data Analytics Data Agent Owner (roles/geminidataanalytics.dataAgentOwner) auf Projektebene.
• Alle Daten-Agents im Projekt ansehen und bearbeiten: Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor) auf Projektebene.
• Alle Daten-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 dem Cluster auf Datenbankebene hinzugefügt wurde. Weitere Informationen finden Sie unter Datenbanknutzer verwalten.
• Die Rolle alloydb.databaseUser und die Berechtigung serviceusage.serviceUsageConsumer, die dem IAM-Nutzer auf Projektebene gewährt wurden. Weitere Informationen finden Sie unter IAM-Richtlinienbindung für ein Projekt hinzufügen.

Informationen zum Arbeiten mit AlloyDB-Ressourcen, z. B. zum Ansehen von Tabellen oder Ausführen von Abfragen, finden Sie unter IAM-Rollen und -Berechtigungen für AlloyDB.

KI-Datenagenten erstellen

In den folgenden Abschnitten wird beschrieben, wie Sie einen Daten-Agent erstellen. Nachdem Sie einen Agent erstellt haben, können Sie seine Einstellungen bearbeiten.

Grundlagen konfigurieren

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

2. Wählen Sie einen Cluster aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Agents.

4. Klicken Sie auf den Tab Agents.

5. Wählen Sie eine Datenbank aus und melden Sie sich mit Ihrem IAM-Konto an.

6. Klicken Sie auf Neuer Agent. Die Seite Neuer Agent wird geöffnet.

7. Geben Sie im Abschnitt Editor im Feld Agent-Name einen beschreibenden Namen für den Daten-Agent ein, z. B. Q4 sales data oder User activity logs.

8. Geben Sie im Feld Agent-Beschreibung eine Beschreibung des Daten-Agent ein. Eine gute Beschreibung erklärt, was der Agent tut und welche Daten er verwendet. So können Sie feststellen, ob dies der richtige Daten-Agent für eine Unterhaltung ist, z. B. What are the top 10 selling products in Q2?

9. Klicken Sie im Abschnitt Wissensquellen auf Quelle hinzufügen. Die Seite Daten hinzufügen wird geöffnet.

10. Wählen Sie die Tabellen aus, die der Agent zum Beantworten von Fragen hauptsächlich nutzen soll. Wenn Sie weitere Wissensquellen sehen möchten, wählen Sie Mehr anzeigen aus.

11. Klicken Sie auf Hinzufügen. Die Seite „Neuer Agent“ wird wieder geöffnet.

Tabellen- und Feldbeschreibungen anpassen

Um die Genauigkeit von konversationellen Daten-Agents zu verbessern, können Sie optional zusätzliche Tabellenmetadaten angeben. Diese Metadaten werden nur vom Daten-Agent verwendet und haben keine Auswirkungen auf die Quelltabelle. Sie können die folgenden Metadaten hinzufügen:

• Schemabeschreibungen:Fügen Sie Beschreibungen für Ihre Tabellen und Spalten hinzu, damit der Agent Ihre Daten versteht. Wenn Sie keine Beschreibungen hinzufügen, verwendet der Agent die Schemabeschreibungen aus Ihren Datendefinitionen.

Beachten Sie beim Hinzufügen von Tabellen- und Feldbeschreibungen die folgenden Best Practices:

• Fügen Sie Beschreibungen zu Ihrer Datendefinition und nicht nur zu Ihrer Daten-Agent-Definition hinzu. So können auch andere Agents von den Beschreibungen profitieren.
• Wenn Sie eine geeignete Beschreibung erstellen möchten, damit Daten-Agents Ihre Daten verstehen, fügen Sie Beschreibungen zu Ihrem spezifischen Agent hinzu. Nachdem Sie geprüft haben, ob die Beschreibung die gewünschte Wirkung hat, können Sie entscheiden, ob Sie die Beschreibung in Ihrer Datendefinition hinzufügen möchten.

So konfigurieren Sie Tabellen- und Feldbeschreibungen:

1. Öffnen Sie auf dem Tab Agent-Katalog den Agent, den Sie anpassen möchten.
2. Klicken Sie auf Agent bearbeiten.
3. Suchen Sie unter Wissensquellen die Tabelle, die Sie anpassen möchten, und klicken Sie dann auf Anpassen.
4. Geben Sie eine Tabellenbeschreibung ein.
5. Wenn Sie eine Feldbeschreibung bearbeiten möchten, klicken Sie neben dem Feld auf „Bearbeiten“ Bearbeiten. Der Bereich Feld bearbeiten wird geöffnet.
   1. Geben Sie im Feld ID eine Feldbeschreibung ein.
   2. Klicken Sie auf Aktualisieren, um die Feldbeschreibung zu speichern.
6. Klicken Sie auf Aktualisieren, um die Beschreibung und die Feldaktualisierungen zu speichern. Die Seite „Neuer Agent“ wird wieder geöffnet.
7. Wiederholen Sie diese Schritte für jede Tabelle, die Sie anpassen möchten.

Labels zu Daten-Agents hinzufügen

Im Abschnitt Agent-Einstellungen können Sie Labels erstellen, um Ihre Google Cloud Ressourcen zu organisieren. Labels sind Schlüssel/Wert-Paare mit denen Sie verwandte Objekte zusammen oder mit anderen Google Cloud Ressourcen gruppieren können.

1. Öffnen Sie auf dem Tab Agent-Katalog den Agent, dem Sie ein Label hinzufügen möchten.
2. Klicken Sie auf Agent bearbeiten.
3. Klicken Sie im Abschnitt Agent-Einstellungen auf Label hinzufügen. Der Bereich Labels verwalten wird geöffnet.
4. Klicken Sie auf Label hinzufügen.
5. Geben Sie in den Feldern Schlüssel und Wert das Schlüssel/Wert-Paar für das Label ein.
6. Wenn Sie weitere Labels hinzufügen möchten, klicken Sie noch einmal auf Label hinzufügen.
7. Um ein Label zu löschen, klicken Sie auf „Löschen“.
8. Wenn Sie fertig sind, klicken Sie auf Hinzufügen. Die Seite „Neuer Agent“ wird wieder geöffnet.

Fahren Sie mit dem nächsten Abschnitt fort, um den Agent in den Entwurfsmodus zu versetzen oder ihn zu veröffentlichen.

Vorschau des Agent ansehen und ihn veröffentlichen

1. Geben Sie im Abschnitt Vorschau im Feld Frage stellen eine Beispielfrage ein und drücken Sie die Eingabetaste.

   Prüfen Sie die Antwort des Agent, um zu bestätigen, dass der Daten-Agent die erwarteten Daten zurückgibt. Wenn die Antwort nicht Ihren Erwartungen entspricht, ändern Sie die Einstellungen im Abschnitt Editor , um die Konfiguration des Daten-Agent zu verfeinern, bis Sie zufriedenstellende Antworten erhalten. Sie können Ihren Agent weiter testen und ändern, um die Ergebnisse des Agent zu verbessern.

2. Klicken Sie auf Speichern.

3. Wenn Sie den Daten-Agent in den Entwurfsmodus versetzen möchten, um ihn später noch einmal zu bearbeiten, klicken Sie auf Zurück , um zur Seite Agent-Katalog zurückzukehren. Da sich Ihr Agent jetzt im Entwurfsmodus befindet, wird er auf dem Tab Agent-Katalog im Abschnitt Meine Entwurfs-Agents angezeigt.

   Wenn Sie Ihren Agent veröffentlichen möchten, bleiben Sie auf der Seite zur Agent-Erstellung und fahren Sie mit dem nächsten Schritt fort.

4. Klicken Sie auf Veröffentlichen, um den Daten-Agent zu veröffentlichen und ihn für die Verwendung im Projekt verfügbar zu machen. Durch die Veröffentlichung des Agent können andere Nutzer, die Zugriff auf dieselben Datenbanktabellen haben, Ihren Agent ansehen und mit ihm interagieren und so von den von Ihnen erstellten Anweisungen und dem Kontext profitieren.

   Sie können Unterhaltungen mit dem Daten-Agent führen, indem Sie in der Google Cloud Console die Seite Agents verwenden. Sie können auch eine eigene Schnittstelle erstellen, um mit dem Daten-Agent zu chatten, indem Sie die Conversational Analytics API verwenden.

5. Optional: Klicken Sie im Dialogfeld Ihr Agent wurde veröffentlicht auf Freigeben, um den Daten-Agent für andere Nutzer freizugeben.

   1. Klicken Sie im Bereich Berechtigungen freigeben auf Hauptkonto hinzufügen.
   2. Geben Sie im Feld Neue Hauptkonten ein oder mehrere Hauptkonten ein.
   3. Klicken Sie auf die Liste Rolle auswählen.
   4. Wählen Sie in der Liste Rolle eine der folgenden Rollen aus:
      • Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser): Gewährt die Berechtigung, mit dem Daten-Agent zu chatten.
      • Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor): Gewährt die Berechtigung, den Daten-Agent zu bearbeiten.
      • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer): Gewährt die Berechtigung, den Daten-Agent anzusehen.

6. Klicken Sie auf Speichern.

7. Klicken Sie auf Schließen, um zur Seite „Neuer Agent“ zurückzukehren. Nachdem Sie Ihren Agent gespeichert oder veröffentlicht haben, können Sie ihn im Agent-Katalog sehen.

Daten-Agents verwalten

Vorhandene Agents finden Sie auf dem Tab Agent-Katalog, der aus drei Abschnitten besteht:

• Meine Agents: Eine Liste aller Agents, die Sie erstellen und veröffentlichen. Sie können veröffentlichte Agents ändern und für andere freigeben.
• Meine Entwurfs-Agents: Agents, die Sie noch nicht veröffentlicht haben. Entwurfs-Agents können nicht freigegeben werden.
• Von anderen Personen in Ihrer Organisation freigegeben: Agents, die von anderen erstellt und für Sie freigegeben wurden. Wenn andere Ihnen Berechtigungen gewähren, können Sie diese freigegebenen Agents bearbeiten.

Daten-Agent bearbeiten

So bearbeiten Sie einen Daten-Agent:

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

2. Wählen Sie einen Cluster aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Agents.

4. Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) bei Agents an.

5. Klicken Sie auf den Tab Agent-Katalog.

6. Suchen Sie die Agent-Karte des Daten-Agent, den Sie ändern möchten.

7. Wenn Sie den Daten-Agent im Agent-Editor öffnen möchten, klicken Sie auf Aktionen öffnen und dann auf der Agent-Karte auf Bearbeiten.

8. Bearbeiten Sie die Konfiguration des Daten-Agent nach Bedarf.

9. Wenn Sie Ihre Änderungen speichern möchten, ohne sie zu veröffentlichen, klicken Sie auf Speichern.

10. Klicken Sie auf Veröffentlichen, um Ihre Änderungen zu veröffentlichen. Im Dialogfeld Freigeben können Sie den Agent entweder für andere freigeben oder auf Abbrechen klicken.

11. Klicken Sie auf „Zurück“ Go back, um zum Bereich Agents zurückzukehren.

Daten-Agent freigeben

So geben Sie einen veröffentlichten Daten-Agent frei: Entwurfs-Agents können nicht freigegeben werden.

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

2. Wählen Sie einen Cluster aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Agents.

4. Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) bei Agents an.

5. Klicken Sie auf den Tab Agent-Katalog.

6. Suchen Sie die Agent-Karte des Daten-Agent, den Sie ändern möchten.

7. Wenn Sie den Daten-Agent im Agent-Editor öffnen möchten, klicken Sie auf Open actions und dann auf der Agent-Karte auf Edit.

8. Klicken Sie auf Freigeben, um den Daten-Agent für andere Nutzer freizugeben.

9. Klicken Sie im Bereich Berechtigungen freigeben auf Hauptkonto hinzufügen.

10. Geben Sie im Feld Hauptkonten hinzufügen ein oder mehrere Hauptkonten ein.

11. Klicken Sie auf Rolle auswählen.

12. Wählen Sie in der Liste Rolle eine der folgenden Rollen aus:

    • Gemini Data Analytics Data Agent User (roles/geminidataanalytics.dataAgentUser): Gewährt die Berechtigung, mit dem Daten-Agent zu chatten.
    • Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor): Gewährt die Berechtigung, den Daten-Agent zu bearbeiten.
    • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer): Gewährt die Berechtigung, den Daten-Agent anzusehen.

13. Klicken Sie auf Speichern.

14. Klicken Sie auf Schließen, um zur Seite zum Bearbeiten des Agent zurückzukehren.

15. Klicken Sie auf Zurück, um zum Bereich Agents zurückzukehren.

Daten-Agent löschen

1. Öffnen Sie in der Google Cloud Console die Seite AlloyDB.

   Zu AlloyDB

2. Wählen Sie einen Cluster aus der Liste aus.

3. Klicken Sie im Navigationsmenü auf Agents.

4. Melden Sie sich mit der IAM-Authentifizierung (Identity and Access Management) bei Agents an.

5. Wählen Sie den Tab Agent-Katalog aus.

6. Suchen Sie im Abschnitt Agents des Tabs Agent-Katalog die Agent-Karte des Daten-Agent, den Sie löschen möchten.

7. Klicken Sie auf Aktionen öffnen > Löschen.

8. Klicken Sie im Dialogfeld Agent löschen? auf Löschen. Wenn Sie den Agent löschen, wird er dauerhaft aus dem Projekt entfernt.

   Nachdem Sie einen Agent gelöscht haben, sind vorhandene Unterhaltungen im Lesemodus weiterhin verfügbar. Sie können dem gelöschten Agent keine neuen Fragen mehr stellen.

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 AlloyDB.
• Weitere Informationen zur Conversational Analytics API.
• Daten mit Unterhaltungen analysieren.
• Weitere Informationen dazu, wie die Rolle „Gemini Data Analytics Data Agent Viewer“ (roles/geminidataanalytics.dataAgentViewer) die Berechtigung zum Ansehen des Daten-Agent gewährt