Data Agents erstellen und verwalten

Mit Daten-KI-Agenten können Sie die konversationelle Analyse für Ihre Nutzer anpassen. Mit KI-Agenten können Sie der konversationellen Analyse Kontext und Anweisungen geben, damit sie Fragen für bestimmte Anwendungsfälle effektiver beantworten kann. KI-Agenten ermöglichen es Analysten, Geschäftsbegriffe bestimmten Feldern zuzuordnen, die besten Felder für die Filterung anzugeben und benutzerdefinierte Berechnungen zu definieren.

Auf dieser Seite werden die folgenden Prozesse beschrieben:

Weitere Informationen dazu, wie und wann Gemini forIhre Daten verwendet. Google Cloud

Hinweis

Stellen Sie sich einen Daten-KI-Agenten als eine weitere Art von Looker-Inhalt vor, z. B. ein Dashboard, einen Look oder einen Ordner.

Die Verwendung eines Daten-KI-Agenten wird durch eine Kombination aus Inhaltszugriff, Datenzugriff und Funktionszugriff verwaltet. Wenn Sie die in der folgenden Tabelle beschriebenen Aufgaben ausführen möchten, muss Ihnen eine Looker-Rolle zugewiesen sein, die die erforderlichen Berechtigungen für die Modelle hat, die von Ihrem Daten-KI-Agenten abgefragt werden, und in einigen Fällen Zugriff auf den Agenten selbst.

Aufgabe Erforderliche Looker-Berechtigungen Erforderliche Zugriffsebene für Daten-KI-Agenten
KI-Agenten erstellen, bearbeiten, freigeben und löschen Hinzugefügt am 25.18. admin_agents Es muss kein Inhaltszugriff gewährt werden.
KI-Agenten erstellen, bearbeiten, freigeben und löschen Hinzugefügt am 25.18. save_agents

Nutzer können KI-Agenten erstellen, die nur die Explores verwenden, für die ihnen diese Berechtigung für das zugrunde liegende Modell gewährt wurde. Wenn Nutzer einen Daten-KI-Agenten bearbeiten, löschen oder freigeben möchten, der von einem anderen Nutzer erstellt wurde, muss ihnen eine Rolle zugewiesen sein, die diese Berechtigung für jedes Modell enthält, das vom Agenten verwendet wird.
Zugriff verwalten; Bearbeiten (Dieser Zugriff wird automatisch gewährt, wenn der Nutzer den Agenten erstellt. Andernfalls muss der Zugriff Zugriff verwalten; Bearbeiten vom Ersteller des Agenten gewährt werden, indem er den Agenten freigibt.)
KI-Agenten in anderen Google Cloud Anwendungen veröffentlichen Hinzugefügt am 26.6. publish_agent_externally

Nutzer veröffentlichen vorhandene KI-Agenten in anderen Google Cloud Anwendungen wie Gemini Enterprise.
Zugriff verwalten; Bearbeiten (Dieser Zugriff wird automatisch gewährt, wenn der Nutzer den Agenten erstellt. Andernfalls muss der Zugriff Zugriff verwalten; Bearbeiten vom Ersteller des Agenten gewährt werden, indem er den Agenten freigibt.)
Über den Tab KI-Agenten in der konversationellen Analyse mit einem Daten-KI-Agenten chatten access_data (für jedes Modell, das die Explores enthält, die vom Daten-KI-Agenten verwendet werden)

Hinzugefügt am 25.18 chat_with_agent (für jedes Modell, das die Explores enthält, die vom Daten-KI-Agenten verwendet werden)
Zugriff Ansehen
Über den Tab Explores in der konversationellen Analyse mit einem Looker-Explore chatten access_data (für jedes Modell, das die Explores enthält, die vom Daten-KI-Agenten verwendet werden)

Hinzugefügt am 25.18. chat_with_explore

Looker bietet auch die folgenden Standardrollen, die Teilmengen dieser Berechtigungen für alle Modelle in der Instanz enthalten:

  • Agent-Manager für die konversationelle Analyse: Mit dieser Rolle kann ein Nutzer KI-Agenten erstellen, bearbeiten, freigeben, löschen und mit ihnen chatten, für die er den Zugriff Zugriff verwalten; Bearbeiten hat, und mit Explores chatten.
  • Nutzer der konversationellen Analyse: Mit dieser Rolle kann ein Nutzer mit einem KI-Agenten chatten, für den er den Zugriff Ansehen hat.
  • Administrator: Standardmäßig hat diese Rolle (Looker-Administrator) alle Berechtigungen und den gesamten Inhaltszugriff in der Instanz.

Ein Looker-Administrator kann diese Rollen und Berechtigungen auf der Seite Rollen im Bereich Verwaltung der Looker-Instanz gewähren. Weitere Informationen zu Looker-Rollen finden Sie auf der Dokumentationsseite Verwaltungseinstellungen – Rollen.

Der Ersteller des Daten-KI-Agenten kann den Zugriff einzelner Nutzer auf den Agenten verwalten, indem er den Agenten freigibt.

Daten-KI-Agenten erstellen und bearbeiten

So erstellen Sie einen neuen Daten-KI-Agenten:

  1. Rufen Sie die Seite Unterhaltungen auf.
  2. Wählen Sie auf dem Tab KI-Agenten die Option + Neuer Agent aus. Oder wählen Sie im linken Bereich sparkKI-Agenten verwalten und dann + Neuer Agent aus.
  3. Geben Sie auf der Seite Neuer Agent die folgenden Informationen zu Ihrem Daten-KI-Agenten an.

    • Agent-Name: Geben Sie einen Namen für den Agenten ein. Der Name sollte eindeutig und beschreibend sein.
    • Agent-Beschreibung: Beschreiben Sie kurz, was dieser Agent tun kann und welche Daten er verwendet. Nutzer sehen diese Beschreibung, wenn sie den Agenten auswählen, um eine Unterhaltung zu starten, oder wenn Sie den Agenten für sie freigeben. Die Beschreibung sollte daher den Zweck des Agenten und seine Vorteile klar erläutern.
    • Daten: Folgen Sie dieser Anleitung, um eine Verbindung zu bis zu fünf vorhandenen Looker-Explores herzustellen:
      1. Klicken Sie im Feld Daten auf + Explores auswählen.
      2. Klicken Sie im Fenster Explores suchen auf die Explores, die Sie in den Daten-KI-Agenten aufnehmen möchten. Diese Explores werden im Bereich Ausgewählte Explores des Fensters angezeigt.
      3. Klicken Sie auf Speichern, um den ausgewählten Explore zum Daten-KI-Agenten hinzuzufügen.
  4. Anweisungen: Geben Sie Kontext an, damit die konversationelle Analyse weiß, wie sie mit Ihren Daten interagieren und genaue und relevante Antworten geben kann. Beispiele für die Arten von Kontext, die Sie angeben können, finden Sie unter Anweisungen für KI-Agenten schreiben.

  5. Optional: Wenn Sie den Code-Interpreter für alle Unterhaltungen mit Ihrem Agenten aktivieren möchten, wählen Sie Erweiterte Analysen aktivieren aus.

  6. Optional können Sie Ihren Agenten testen, um die Anweisungen und Einstellungen zu optimieren.

  7. Klicken Sie auf Speichern, um den neuen Daten-KI-Agenten zu speichern.

Nachdem Sie den Daten-KI-Agenten gespeichert haben, können Sie ihn für andere Nutzer freigeben und eine Unterhaltung mit ihm starten.

Anweisungen für KI-Agenten schreiben

Wenn Sie einen Daten-KI-Agenten erstellen, können Sie Anweisungen in Freiform hinzufügen, die das Kernverhalten des Daten-KI-Agenten definieren und ihm grundlegenden Kontext liefern, den er berücksichtigen muss, bevor er einen Prompt eines Nutzers verarbeitet.

Hier einige Beispiele für die Arten von Kontext, die Sie im Feld Anweisungen angeben können:

  • Schlüsselfelder: Die wichtigsten Felder für die Analyse
  • Ausgeschlossene Felder: Felder, die der Daten-KI-Agent vermeiden soll
  • Filtern und Gruppieren: Felder, die der Agent zum Filtern und Gruppieren von Daten verwenden soll
  • Golden Queries: Paare aus Fragen in natürlicher Sprache und den entsprechenden Explore-Abfragen
  • Persona: Eine Rolle oder Expertise, ein Charakter oder ein Ton, den Sie dem Agenten zuweisen

Tipps und Best Practices zum Schreiben von Anweisungen für KI-Agenten finden Sie unter Best Practices für die Konfiguration der konversationellen Analyse in Looker.

Looker-Golden Query definieren

Wenn Sie eine Looker-Golden Query für einen bestimmten Explore definieren möchten, geben Sie Werte für beide folgenden Felder an:

  • natural_language_questions: Die Frage in natürlicher Sprache, die ein Nutzer stellen könnte
  • looker_query: Die Looker-Golden Query, die der Frage in natürlicher Sprache entspricht

Überlegen Sie sich für das Feld natural_language_questions, welche Fragen ein Nutzer zu diesem Explore stellen könnte, und formulieren Sie diese Fragen in natürlicher Sprache. Sie können mehr als eine Frage in den Wert dieses Felds aufnehmen. Sie können den Wert für das Feld looker_query aus den Abfragemetadaten des Explore abrufen.

Golden Queries unterstützen die folgenden Felder:

  • model (String): Das LookML-Modell, das zum Generieren der Abfrage verwendet wurde. Dies ist ein Pflichtfeld.
  • explore (String): Der Explore, der zum Generieren der Abfrage verwendet wurde. Dies ist ein Pflichtfeld.
  • fields[] (String): Die Felder, die aus dem Explore abgerufen werden sollen, einschließlich Dimensionen und Messwerte. Dieses Feld ist optional.
  • filters[] (String): Die Filter, die auf den Explore angewendet werden sollen. Dieses Feld ist optional.
  • sorts[] (String): Die Sortierung, die auf den Explore angewendet werden soll. Dieses Feld ist optional.
  • limit (String): Die Begrenzung für Datenzeilen, die auf den Explore angewendet werden soll. Dieses Feld ist optional.

Sie können die Abfragemetadaten des Explore direkt aus dem Explore abrufen. Folgen Sie dazu dieser Anleitung:

  1. Wählen Sie im Explore das Explore-Aktionen Menü und dann LookML abrufen aus.
  2. Wählen Sie den Tab Dashboard aus.
  3. Kopieren Sie die Abfragedetails aus dem LookML-Code. Die folgende Abbildung zeigt beispielsweise den LookML-Code für einen Explore namens Bestellpositionen:

Kopieren Sie die ausgewählten Metadaten zur Verwendung in Ihrer Looker-Golden Query:

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

Agent testen

Wenn Sie einen Agenten erstellen oder bearbeiten, enthält die Seite mit den Agentendetails den Bereich Vorschau des Agenten. Sie können die Einstellungen und Anweisungen des Agenten testen, indem Sie eine Unterhaltung mit ihm starten.

Sie müssen auf Aktualisieren klicken, damit eine Änderung in der Vorschau angezeigt wird. Wenn der Speicherstatus Not saved lautet, werden keine Aktualisierungen der Einstellungen in der Vorschau angezeigt.

Vorhandenen Daten-KI-Agenten bearbeiten

So bearbeiten Sie einen vorhandenen Daten-KI-Agenten:

  1. Wählen Sie auf der Seite Unterhaltungen die Option sparkKI-Agenten verwalten aus.
  2. Wählen Sie auf der Seite KI-Agenten verwalten den Daten-KI-Agenten aus, den Sie bearbeiten möchten.
  3. Aktualisieren Sie die Details zum Agenten nach Bedarf. Sie können die Details ändern, die Sie beim Erstellen des Agenten angegeben haben, einschließlich der Felder Agent-Name, Agent-Beschreibung, Daten und Anweisungen. Sie können auch den Code-Interpreter für Ihren Agenten aktivieren.
  4. Klicken Sie auf Aktualisieren, um die Änderungen zu speichern.

Daten-KI-Agenten freigeben

Durch die Freigabe können andere Nutzer mit Ihrem Agenten und seinen Explores chatten. Sie können einen Daten-KI-Agenten für andere Nutzer freigeben, indem Sie den Inhaltszugriff auf den Agenten gewähren. Nur ein Nutzer mit den entsprechenden Berechtigungen und Inhaltszugriff kann einen Agenten freigeben. Nachdem ein Agent erstellt wurde, kann es einige Minuten dauern, bis er freigegeben werden kann.

So geben Sie einen Daten-KI-Agenten frei:

  1. Wählen Sie auf der Seite Unterhaltungen im linken Bereich sparkKI-Agenten verwalten aus.
  2. Öffnen Sie das Menü für den ausgewählten Agenten, indem Sie auf das Dreipunkt-Menü Weitere Optionen klicken, und wählen Sie dann Freigeben aus.
  3. Nachdem Sie im Bereich Wer kann auf diesen Agenten zugreifen? eine Person oder Gruppen hinzugefügt und die gewünschte Berechtigungsstufe ausgewählt haben, klicken Sie auf Hinzufügen, um sie in die freigegebene Liste aufzunehmen.
  4. Wenn neue Nutzer oder Gruppen eine Benachrichtigungs-E-Mail erhalten sollen, klicken Sie auf das Kästchen Die gerade hinzugefügten Personen per E-Mail benachrichtigen.
  5. Klicken Sie nach allen Änderungen auf Speichern.

Sie können einen Agenten, den Sie gerade erstellt oder bearbeitet haben, auch freigeben, indem Sie auf der Seite mit den Agenteneinstellungen auf Freigeben klicken und die oben genannten Schritte ausführen.

Zugriff auf einen Daten-KI-Agenten widerrufen

So widerrufen Sie den Zugriff auf einen Agenten:

  1. Klicken Sie auf der Seite Unterhaltungen im linken Bereich auf sparkKI-Agenten verwalten.
  2. Öffnen Sie das Menü für den ausgewählten Agenten, indem Sie auf das Dreipunkt-Menü Weitere Optionen klicken, und wählen Sie dann Freigeben aus.
  3. Klicken Sie neben den Nutzern oder Gruppen, deren Zugriff entfernt werden soll, auf das X.
  4. Klicken Sie nach allen Änderungen auf Speichern.

Wenn die entfernten Nutzer eine laufende Unterhaltung haben, haben sie noch ein oder zwei Minuten lang Zugriff, während die Änderungen übernommen werden.

Wenn ein Nutzer versucht, weitere Fragen zu stellen, nachdem der Zugriff auf einen Agenten entfernt wurde, wird die folgende Meldung angezeigt: The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions.

Daten-KI-Agenten veröffentlichen

Wenn Sie Ihren Agenten veröffentlichen, können Sie ihn in anderen Anwendungen in der gesamten Organisation freigeben Google Cloud. Sie können Ihren Agenten für die folgenden Google Cloud Anwendungen freigeben:

Bevor Sie einen Agenten veröffentlichen können, muss ein Looker-Administrator die Einstellung In Gemini Enterprise veröffentlichen auf der Seite Gemini in Looker im Bereich Verwaltung aktivieren und Ihnen eine Rolle zuweisen, die die Berechtigung publish_agent_externally enthält.

So veröffentlichen Sie einen Agenten:

  1. Bearbeiten Sie den Agenten.
  2. Wählen Sie Veröffentlichungseinstellungen aus, um das Fenster Veröffentlichungseinstellungen zu öffnen.
  3. Aktivieren Sie im Fenster Veröffentlichungseinstellungen die Einstellung Gemini Enterprise und wählen Sie Veröffentlichen aus. Wenn Sie diese Einstellung aktivieren, wird der Agent in der angezeigten Gemini Enterprise-Instanz veröffentlicht.
  4. In der Gemini Enterprise-Instanz muss ein Nutzer mit den folgenden Berechtigungen Nutzern Zugriff auf den Agenten gewähren:

    • discoveryengine.projects.get
    • resourcemanager.projects.get
    • serviceusage.services.list

    Diese Berechtigungen sind in der Rolle Discovery Engine-Administrator verfügbar.

Daten-KI-Agenten löschen

So löschen Sie einen Daten-KI-Agenten:

1.Klicken Sie auf der Seite Unterhaltungen im linken Bereich auf sparkKI-Agenten verwalten. 1. Öffnen Sie das Menü für den ausgewählten Agenten, indem Sie auf das Dreipunkt-Menü Weitere Optionen klicken, und wählen Sie dann Löschen aus. 1. Klicken Sie im Fenster Agent löschen? auf In den Papierkorb verschieben, um den Daten-KI-Agenten zu löschen.

In den Papierkorb verschobene Agenten werden nach 30 Tagen endgültig gelöscht. Sie können einen Daten-KI-Agenten manuell endgültig löschen oder ihn aus dem Papierkorb wiederherstellen, bevor er endgültig gelöscht wird. Wenn Sie nichts unternehmen, wird der Agent nach 30 Tagen automatisch endgültig gelöscht.

Daten-KI-Agenten endgültig löschen

So löschen Sie einen Daten-KI-Agenten endgültig:

  1. Rufen Sie die Seite Unterhaltungen auf.
  2. Maximieren Sie im linken Navigationsbereich den Abschnitt Papierkorb.
  3. Wählen Sie das Dreipunkt-Menü für den ausgewählten Agenten aus und klicken Sie dann auf Endgültig löschen , um das Menü zu öffnen.
  4. Klicken Sie im Fenster Sind Sie sicher? auf Endgültig löschen.

Daten-KI-Agenten aus dem Papierkorb wiederherstellen

So stellen Sie einen Daten-KI-Agenten aus dem Papierkorb wieder her:

  1. Rufen Sie die Seite Unterhaltungen auf.
  2. Maximieren Sie im linken Navigationsbereich den Abschnitt Papierkorb.
  3. Wählen Sie das Dreipunkt-Menü für den ausgewählten Agenten aus und klicken Sie dann auf Wiederherstellen , um das Menü zu öffnen.