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 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 sich die Genauigkeit von Agenten verbessern lässt. Sie enthält 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 die Abrechnung für Ihr Google Cloud Projekt 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 KI-Datenagenten arbeiten möchten, benötigen Sie IAM-Berechtigungen, die Ihrem Anwendungsfall entsprechen. In der folgenden Tabelle sind die erforderlichen Rollen aufgeführt, je nachdem, ob Sie KI-Agenten erstellen und veröffentlichen, KI-Agenten in Gemini Enterprise bereitstellen oder KI-Agenten suchen und verwenden. Weitere Informationen finden Sie unter IAM-Identity and Access Management für die Conversational Analytics API.

Anwendungsfall Erforderliche Rollen
Agents erstellen, bearbeiten, veröffentlichen, freigeben und löschen
  • So erstellen Sie Daten-Agents in einem Projekt: Rolle „Gemini Data Analytics Data Agent Creator“ (roles/geminidataanalytics.dataAgentCreator) für das Projekt. Mit dieser Rolle erhalten Sie automatisch die Rolle „Gemini Data Analytics Data Agent Owner“ für die von Ihnen erstellten Data Agents.
  • Zum Bearbeiten, Freigeben oder Löschen eines Data Agents: Rolle „Gemini Data Analytics Data Agent Owner“ (roles/geminidataanalytics.dataAgentOwner) für den Agent oder das Projekt.
  • So bearbeiten Sie einen Data Agent in einem Projekt: Rolle „Gemini Data Analytics Data Agent Editor“ (roles/geminidataanalytics.dataAgentEditor) für das Projekt.
  • So rufen Sie Daten-Agents in einem Projekt auf: Rolle „Gemini Data Analytics Data Agent Viewer“ (roles/geminidataanalytics.dataAgentViewer) für das Projekt.
  • Außerdem benötigen Sie die folgenden Rollen, um einen Daten-Agent zu erstellen oder zu bearbeiten:
KI-Agenten in Gemini Enterprise bereitstellen

Damit ein veröffentlichter Agent für Nutzer in Gemini Enterprise verfügbar ist, benötigen Sie Berechtigungen zum Registrieren und Verwalten von A2A-Agenten in der Gemini Enterprise-Administratorkonsole.
KI-Agenten entdecken und verwenden
  • Um mit KI-Datenagenten zu chatten: „Gemini Data Analytics Data Agent User“ (roles/geminidataanalytics.dataAgentUser).
  • Alle Data Agents im Projekt ansehen: Gemini Data Analytics Data Agent Viewer (roles/geminidataanalytics.dataAgentViewer).

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 Agent-Beschreibung eine Beschreibung des Daten-Agents ein. Eine gute Beschreibung erklärt, was der Agent tut und welche Daten er verwendet. So können Sie leichter entscheiden, ob er 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 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 Agent Ihre Daten besser 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 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-Agents, um zu sehen, ob 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-Agents 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-Agent in den Entwurfsmodus versetzen möchten, um ihn später noch einmal zu bearbeiten, klicken Sie auf  Zurück, um zur Seite Agent Catalog (Agent-Katalog) zurückzukehren. Da sich Ihr Agent jetzt im Entwurfsmodus befindet, wird er im Abschnitt Meine Agentenentwürfe auf dem Tab Agentenkatalog 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 Datenagenten zu veröffentlichen und für die Verwendung im Projekt verfügbar zu machen. Wenn Sie den Agent veröffentlichen, können andere Nutzer, die Zugriff auf dieselben Datenbanktabellen haben, Ihren Agent aufrufen und mit ihm interagieren. Sie profitieren dann von den Anweisungen und dem Kontext, die Sie erstellt haben.

    Sie können Unterhaltungen mit dem Daten-Agenten erstellen, indem Sie die Seite Agents in der Google Cloud Konsole verwenden. Sie können auch eine eigene Benutzeroberfläche erstellen, um mit dem KI-Datenagenten zu chatten. Verwenden Sie dazu die Conversational Analytics API.

  5. Optional: Klicken Sie im Dialogfeld Ihr KI-Agent wurde veröffentlicht auf Freigeben, um den KI-Agenten 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.
    5. Klicken Sie auf Speichern.

  6. Optional: Sie können den Daten-KI-Agenten in Gemini Enterprise veröffentlichen. Weitere Informationen finden Sie unter Daten-Agent in Gemini Enterprise veröffentlichen.

  7. Klicken Sie auf Schließen, um zur Seite des neuen Agents zurückzukehren. Nachdem Sie Ihren Agenten gespeichert oder veröffentlicht haben, können Sie ihn im Agentenkatalog sehen.

Daten-Agents verwalten

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

  • Meine Agents: Eine Liste aller Agents, die Sie erstellen und veröffentlichen. Sie können veröffentlichte KI‑Agents bearbeiten und für andere freigeben.
  • Meine Agent-Entwürfe: Agenten, 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 Ansehen 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 Agents 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 Agent löschen? auf Löschen. Wenn Sie den Agenten dauerhaft löschen, wird er 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.

Daten-Agenten in Gemini Enterprise veröffentlichen

Für die Veröffentlichung eines Daten-Agents ist eine Zusammenarbeit zwischen Datenanalysten, Gemini Enterprise-Administratoren und Geschäftsnutzern erforderlich. Informationen zu den für diese Nutzer erforderlichen Rollen finden Sie unter Erforderliche Rollen.

Agent erstellen und veröffentlichen

So erstellen, bearbeiten und veröffentlichen Sie einen Agent:

  1. Erstellen oder bearbeiten Sie Ihren Daten-Agent in Spanner.
  2. Veröffentlichen Sie den Agent. Wenn Sie den Agenten veröffentlichen, wählen Sie Gemini Enterprise als Veröffentlichungsoption aus.
  3. Klicken Sie auf JSON kopieren, um die JSON-Datei des A2A-Endpunkts zu kopieren.
  4. Geben Sie die A2A-Endpunkt-JSON und die Liste der Nutzer an Ihren Gemini Enterprise-Administrator weiter, damit er den benutzerdefinierten Agenten in der Google Cloud Console registrieren und Zugriffsberechtigungen konfigurieren kann. Weitere Informationen finden Sie unter Agent bereitstellen.
  5. Geben Sie den KI-Agenten für die Nutzer und Gruppen frei, die Zugriff benötigen.

Agent bereitstellen

So machen Sie einen veröffentlichten Agenten für Nutzer in der Google Cloud Console verfügbar:

  1. Rufen Sie in der Google Cloud Console Gemini Enterprise auf.

    Gemini Enterprise

  2. Klicken Sie auf den Namen der App, für die Sie den Agenten registrieren möchten.

  3. Klicken Sie auf Agenten > Agenten hinzufügen.

  4. Klicken Sie im Bereich Agenttyp auswählen für Benutzerdefinierter Agent über A2A auf Hinzufügen.

  5. Geben Sie im Feld JSON-Agentenkarte die Details der Agentenkarte ein, die Sie zuvor vom Datenanalysten im JSON-Format erhalten haben.

  6. Klicken Sie auf Agentendetails ansehen > Weiter.

  7. So ermöglichen Sie dem Agent, in Ihrem Namen auf Google Cloud -Ressourcen zuzugreifen:

    1. Geben Sie die Client-ID und den Clientschlüssel ein, die Sie im Abschnitt Autorisierungsdetails konfigurieren generiert haben.

    2. Geben Sie im Feld Autorisierungs-URI Folgendes ein:

      https://accounts.google.com/o/oauth2/v2/auth?client_id=client_id&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent

      Ersetzen Sie client_id durch die Client-ID, die Sie unter Autorisierungsdetails konfigurieren generiert haben.

    3. Geben Sie im Feld Token-URI Folgendes ein:

      https://oauth2.googleapis.com/token

    4. Geben Sie im Feld Bereiche Folgendes ein:

      https://www.googleapis.com/auth/cloud-platform

  8. Klicken Sie auf Beenden.

  9. Geben Sie den KI-Agenten für die Nutzer oder Gruppen frei.

Weitere Informationen finden Sie unter A2A-Agents registrieren und verwalten.

KI-Agenten finden und verwenden

Sie können einen Daten-Agenten in Gemini Enterprise auf eine der folgenden Arten finden und verwenden:

  • Suchen Sie in der Agentengalerie nach dem Agenten und starten Sie einen dedizierten Chat.
  • Verwenden Sie die dedizierte URL des Agents, um Gemini Enterprise direkt in einer Sitzung mit diesem bestimmten Spanner-Daten-Agenten zu öffnen.
  • Rufen Sie den KI-Agenten auf, indem Sie im Gemini Enterprise-Chat eine @mention eingeben, z. B. @sales_pipeline_agent.
  • Stellen Sie eine allgemeine analytische Frage, z. B. „Wie hat sich unsere Vertriebspipeline in den letzten drei Monaten entwickelt?“, damit Gemini Enterprise die Anfrage automatisch an den entsprechenden Daten-Agent weiterleitet.

Nachdem Sie den Agenten gefunden haben, können Sie auf eine der folgenden Arten mit ihm interagieren:

  • Führen Sie die einmalige OAuth-Anmeldung durch, um sich sicher bei Spanner zu authentifizieren.
  • Fragen in natürlicher Sprache stellen Der Conversational Analytics-Agent verarbeitet Ihre Anfragen und streamt die Antwort als Text, Markdown, Diagramme oder Tabellen zurück an Gemini Enterprise.
  • Sie können sich Ihren Unterhaltungsverlauf im Verlaufsbereich ansehen. Dort werden Unterhaltungen automatisch gespeichert.

Standorte

Die Funktion „Konversationelle Analysen“ ist global verfügbar. Sie können nicht auswählen, welche Region verwendet werden soll.

Nächste Schritte