Conversational Analytics einbetten

Sie können die Benutzeroberfläche der konversationellen Analyse mit einem HTML-iFrame-Tag in eine Website oder eine Anwendung einbetten, genau wie bei anderen Looker-Inhaltstypen. Die Benutzeroberfläche der konversationellen Analyse umfasst den Unterhaltungsbereich für KI-Datenagenten für Dashboards und die Seite Konversationsseite. Dort können Sie mit KI-Datenagenten chatten, die mit mehreren Looker-Explores verbunden sind, oder direkt mit einem Explore chatten.

Die konversationelle Analyse unterstützt sowohl die private Einbettung, bei der Nutzer mit ihren Looker-Anmeldedaten authentifiziert werden, als auch die signierte Einbettung, bei der Nutzer über Ihre eigene Anwendung authentifiziert werden.

Auf dieser Seite wird beschrieben, wie Sie die Benutzeroberfläche der konversationellen Analyse in einen iFrame einbetten.

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

Da es sich bei Produkten von Gemini für Google Cloudum Technologie in einem frühen Entwicklungsstadium handelt, kann es zu Ergebnissen kommen, die zwar plausibel erscheinen, aber faktisch falsch sind. Ausgaben der Produkte von Gemini für Google Cloud sollten daher vor der Verwendung geprüft werden. Weitere Informationen finden Sie unter Gemini für Google Cloud und verantwortungsbewusste Anwendung von KI.

Hinweis

Damit Sie die konversationelle Analyse einbetten können, müssen die folgenden Anforderungen erfüllt sein:

• Ihre Instanz muss von Looker gehostet werden.
• Nutzer benötigen dieselben Berechtigungen, die für die Verwendung der nicht eingebetteten konversationellen Analyse erforderlich sind.
• Wenn Sie ein Looker-Dashboard einbetten möchten, das einen KI-Datenagenten für Dashboards der konversationellen Analyse verwendet, muss ein Administrator KI-Datenagenten für Dashboards aktivieren. Aktivieren Sie auf der Seite "Verwaltung" Gemini in Looker unter Konversationelle Analyse die Einstellung Dashboard-Agenten.

Einschränkungen beim Einbetten der konversationellen Analyse

Beachten Sie beim Einbetten von Inhalten der konversationellen Analyse die folgenden Einschränkungen:

Eingebettete Designs werden beim Einbetten der konversationellen Analyse nur teilweise unterstützt. Die Designs der allgemeinen Optionen gelten für Benutzeroberflächen der konversationellen Analyse. Andere Designoptionen werden nicht unterstützt. Eingebettete Designs werden im Konversationsmodus des Datenagenten in einem eingebetteten Dashboard unterstützt.

URL für die Einbettung der konversationellen Analyse erstellen

Der Vorgang zum Erstellen einer Einbettungs-URL für die konversationelle Analyse ist derselbe wie beim Einbetten anderer Inhaltstypen wie Dashboards oder Looks. Dabei fügen Sie /embed/ nach dem Instanznamen und vor dem Inhaltsordner und der Content ID hinzu.

Wenn Sie eine Unterhaltung mit einem KI-Datenagenten für Explores oder einen direkten Chat mit einem Explore einbetten möchten, suchen Sie die nicht eingebettete URL der Unterhaltung oder des KI-Datenagenten und fügen Sie /embed/ vor dem Ordner conversations oder agents ein. Beispiel:

• Für die Seite Unterhaltungen sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/conversations.
• Für die Seite KI-Agenten sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/agents.
• Für eine bestimmte Unterhaltung sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. In diesem Beispiel ist c9f370ac830b4669aeb494396422004c die Unterhaltungs-ID.
• Für ein Dashboard, das einen KI-Datenagenten für Dashboards der konversationellen Analyse verwendet, sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/dashboards/1.

Private Einbettung der konversationellen Analyse

Erstellen Sie für die private Einbettung einen iFrame und verwenden Sie die Einbettungs-URL der konversationellen Analyse als iFrame-Quelle, wie im folgenden Beispiel gezeigt:

  <iframe
      src="https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Betten Sie den iFrame dann in Ihre Webseite oder Anwendung ein.

Signierte Einbettung der konversationellen Analyse

Der Vorgang für die signierte Einbettung der konversationellen Analyse ist derselbe wie für andere Inhaltstypen. Verwenden Sie die Einbettungs-URL der konversationellen Analyse, wenn Sie die signierte Einbettungs-URL codieren.

Eingebettete Nutzer benötigen die entsprechenden Berechtigungen, um die konversationelle Analyse zu verwenden, z. B. chat_with_explore oder chat_with_agent. Daher müssen Sie diese Berechtigungen der signierten Einbettungs-URL hinzufügen.

Sie können einen URL-Parameter hinzufügen, um den Gemini-Funken, der den Unterhaltungsbereich für KI-Datenagenten aus einem Dashboard öffnet, für Nutzer sichtbar oder ausgeblendet zu machen. Standardmäßig ist die Option zum Starten einer Unterhaltung mit einem KI-Datenagenten für Dashboards für Nutzer sichtbar, die Berechtigungen zur Interaktion mit Dashboard-Agenten haben. Wenn Sie das Gemini-Sternsymbol für ein bestimmtes Dashboard ausblenden und die Möglichkeit entfernen möchten, eine Unterhaltung mit einem KI-Datenagenten für Dashboards zu starten, fügen Sie der signierten Einbettungs-URL den Parameter ca_chat=false hinzu. Beispiel: https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false.