Daten-Agents erstellen

Mit konversationellen Daten-Agents können Sie über eine Schnittstelle in natürlicher Sprache mit Ihren Datenbankdaten interagieren. Mit diesen Agents können Nutzer mit ihren Daten interagieren und Erkenntnisse aus operativen Datenbanken gewinnen, ohne komplexe SQL-Abfragen schreiben zu müssen.

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

Für Anwendungsentwickler bieten diese Agents folgende Vorteile:

  • Hohe Genauigkeit: Durch die Verwendung von erstelltem Kontext können Sie eine hohe Genauigkeit für bestimmte geschäftliche Fragen erzielen. Er 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 liefert.
  • Geringere Komplexität: KI-Agenten übersetzen natürliche Sprache in SQL-Abfragen, führen sie aus und fassen Daten zusammen oder visualisieren sie.
  • Flexibilität: Sie können Agents für persönliche Tests entwerfen oder sie veröffentlichen, damit sie anderen Nutzern in Ihrem Projekt oder programmatisch über die API zur Verfügung stehen.

Hinweis

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

  2. Aktivieren Sie die Spanner API, 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. Weitere 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:

  • Daten aus unterstützten Datenbankquellen mit der Methode QueryData abfragen: 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: Rolle „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 Data Agents.
  • 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: Rolle „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:

Informationen zum Arbeiten mit Spanner-Ressourcen finden Sie unter Spanner-Rollen und ‑Berechtigungen.

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. Rufen Sie in der Google Cloud Console die Spanner-Seite auf.

    Spanner aufrufen

  2. Wählen Sie eine Instanz aus der Liste und dann eine Datenbank 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 (Agent-Name) einen aussagekräftigen Namen für den Daten-Agent ein, z. B. Q4 sales data oder User activity logs.

  8. Geben Sie im Feld Agentenbeschreibung eine Beschreibung des Daten-KI-Agents ein. Eine gute Beschreibung erklärt, was der KI-Agent tut und welche Daten er verwendet. So können Sie leichter entscheiden, ob dies der richtige Daten-KI-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 KI‑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 des neuen KI-Agenten wird wieder geöffnet.

Tabellen- und Feldbeschreibungen anpassen

Um die Genauigkeit von KI-Datenagenten für Konversationen zu verbessern, können Sie optional zusätzliche Tabellenmetadaten angeben. Nur der KI-Datenagent verwendet diese Metadaten. Sie 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 KI-Agent Ihre Daten besser versteht. Wenn Sie keine Beschreibungen hinzufügen, verwendet der KI-Agent die Schemabeschreibungen aus Ihren Datendefinitionen.

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

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

So konfigurieren Sie Tabellen- und Feldbeschreibungen:

  1. Öffnen Sie auf dem Tab Agent Catalog (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 auf Anpassen.
  4. Geben Sie eine Tabellenbeschreibung ein.
  5. Wenn Sie eine Feldbeschreibung bearbeiten möchten, klicken Sie neben dem Feld auf 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 neue Agent-Seite wird wieder geöffnet.
  7. Wiederholen Sie diese Schritte für jede Tabelle, die Sie anpassen möchten.

Daten-Agents Labels hinzufügen

Im Bereich 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 Catalog (Agentenkatalog) den Agenten, dem Sie ein Label hinzufügen möchten.
  2. Klicken Sie auf Agent bearbeiten.
  3. Klicken Sie im Bereich 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 Ihr 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. Wenn Sie ein Label löschen möchten, klicken Sie auf Löschen.
  8. Wenn Sie fertig sind, klicken Sie auf Hinzufügen. Die Seite des neuen KI-Agenten wird wieder geöffnet.

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

Agent als Vorschau ansehen und veröffentlichen

  1. Geben Sie im Bereich Vorschau eine Beispielfrage in das Feld Frage stellen ein und drücken Sie dann die Eingabetaste.

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

  2. Klicken Sie auf Speichern.

  3. Wenn Sie den Daten-Agenten in den Entwurfsmodus versetzen möchten, um ihn später noch einmal zu bearbeiten, klicken Sie auf  Zurück, um zur Seite Agentenkatalog zurückzukehren. Da sich Ihr Agent jetzt im Entwurfsmodus befindet, wird er auf dem Tab Agentenkatalog im Bereich 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. Wenn Sie den Data Agent veröffentlichen und für die Verwendung im Projekt verfügbar machen möchten, klicken Sie auf Veröffentlichen. Durch die Veröffentlichung des Agents können andere Nutzer, die Zugriff auf dieselben Datenbanktabellen haben, Ihren Agent ansehen und mit ihm interagieren. Sie profitieren dabei von den Anweisungen und dem Kontext, die Sie erstellt haben.

    Sie können Unterhaltungen mit dem KI-Datenagenten auf der Seite Agents in der Google Cloud Console erstellen. Sie können auch eine eigene Benutzeroberfläche für den Chat mit dem KI-Datenagenten mit der Conversational Analytics API erstellen.

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

    1. Klicken Sie im Bereich Freigabeberechtigungen 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 Data Agent zu chatten.
      • Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor): Berechtigung zum Bearbeiten des Data Agents.
      • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer): Gewährt die Berechtigung zum Aufrufen des Data Agents.

  6. Klicken Sie auf Speichern.

  7. Wenn Sie zur Seite des neuen Agents zurückkehren möchten, klicken Sie auf Schließen. Nachdem Sie den Agent gespeichert oder veröffentlicht haben, können Sie ihn im Agent-Katalog aufrufen.

Daten-Agents verwalten

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

  • Meine KI-Agenten: Hier finden Sie eine Liste aller KI-Agenten, die Sie erstellen und veröffentlichen. Sie können veröffentlichte KI-Agenten bearbeiten und mit anderen teilen.
  • Meine KI-Agenten-Entwürfe: KI-Agents, die Sie noch nicht veröffentlicht haben. Sie können keine Entwürfe für KI-Agenten freigeben.
  • Von anderen Personen in Ihrer Organisation freigegeben: Agenten, die von anderen erstellt und für Sie freigegeben wurden. Wenn andere Ihnen Berechtigungen erteilen, können Sie diese freigegebenen Agents bearbeiten.

KI-Datenagenten bearbeiten

So bearbeiten Sie einen Daten-Agent:

  1. Rufen Sie in der Google Cloud Console die Spanner-Seite auf.

    Spanner aufrufen

  2. Wählen Sie eine Instanz aus der Liste und dann eine Datenbank aus.

  3. Klicken Sie im Navigationsmenü auf Agents.

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

  5. Klicken Sie auf den Tab Agent-Katalog.

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

  7. Wenn Sie den Datenagenten 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-Agents 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 die Änderungen zu veröffentlichen. Im Dialogfeld Freigeben können Sie den Agent entweder für andere freigeben oder auf Abbrechen klicken.

  11. Wenn Sie zum Bereich Agents zurückkehren möchten, klicken Sie auf  Zurück.

KI-Datenagenten freigeben

So geben Sie einen veröffentlichten Daten-Agenten frei: Sie können keine KI-Agenten im Entwurfsstatus freigeben.

  1. Rufen Sie in der Google Cloud Console die Spanner-Seite auf.

    Spanner aufrufen

  2. Wählen Sie eine Instanz aus der Liste und dann eine Datenbank aus.

  3. Klicken Sie im Navigationsmenü auf Agents.

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

  5. Klicken Sie auf den Tab Agent-Katalog.

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

  7. Klicken Sie zum Öffnen des Daten-Agents im Agent-Editor auf  Aktionen öffnen > klicken Sie auf der Agent-Karte auf Bearbeiten.

  8. Wenn Sie den Daten-Agent mit anderen Nutzern teilen möchten, klicken Sie auf Teilen.

  9. Klicken Sie im Bereich Freigabeberechtigungen 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 Data Agent zu chatten.
    • Gemini Data Analytics Data Agent Editor (roles/geminidataanalytics.dataAgentEditor): Berechtigung zum Bearbeiten des Data Agents.
    • Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer): Gewährt die Berechtigung zum Aufrufen des Data Agents.

  13. Klicken Sie auf Speichern.

  14. Wenn Sie zur Seite zum Bearbeiten des Agents zurückkehren möchten, klicken Sie auf Schließen.

  15. Wenn Sie zum Bereich KI-Agenten zurückkehren möchten, klicken Sie auf  Zurück.

KI-Datenagenten löschen

  1. Rufen Sie in der Google Cloud Console die Spanner-Seite auf.

    Spanner aufrufen

  2. Wählen Sie eine Instanz aus der Liste und dann eine Datenbank aus.

  3. Klicken Sie im Navigationsmenü auf Agents.

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

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

  6. Suchen Sie im Abschnitt Agents auf dem Tab Agent Catalog die Agent-Karte des Daten-Agents, den Sie löschen möchten.

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

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

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

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