Conversational Analytics einbetten

Sie können die Conversational Analytics-Benutzeroberfläche in eine Website oder Anwendung einbetten, indem Sie ein HTML-iFrame-Tag verwenden, genau wie bei anderen Looker-Inhaltstypen. Die Benutzeroberfläche für die konversationelle Analyse umfasst den Unterhaltungsbereich für Dashboard-KI-Datenagenten und die Seite Unterhaltungen. Dort können Sie mit KI-Datenagenten chatten, die mit mehreren Looker-Explores verbunden sind, oder mit einem einzelnen Explore.

Conversational Analytics unterstützt sowohl private Einbettung, bei der Nutzer mit ihrem Looker-Login authentifiziert werden, als auch signierte Einbettung, bei der Nutzer über Ihre eigene Anwendung authentifiziert werden.

Auf dieser Seite wird beschrieben, wie Sie die Conversational Analytics-Benutzeroberfläche in ein iFrame einbetten.

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

Hinweis

Damit Sie Conversational Analytics einbetten können, müssen die folgenden Voraussetzungen erfüllt sein:

  • Ihre Instanz muss von Looker gehostet werden.
  • Nutzer benötigen dieselben Berechtigungen, die für die Verwendung von nicht eingebetteten Conversational Analytics erforderlich sind.
  • Wenn Sie ein Looker-Dashboard einbetten möchten, für das ein KI-Datenagent für konversationelle Analysen verwendet wird, muss ein Administrator KI-Datenagenten für Dashboards (Vorabversion) aktivieren. Aktivieren Sie auf der Administratorseite Gemini in Looker unter der Einstellung Trusted Tester-Funktionen aktivieren die Einstellung Dashboard-Agents aktivieren. Die Einstellung Trusted Tester-Funktionen aktivieren muss ebenfalls aktiviert sein.

Einschränkungen beim Einbetten der konversationellen Analyse

Beachten Sie beim Einbetten von Conversational Analytics-Inhalten die folgenden Einschränkungen:

Eingebettete Designs werden beim Einbetten der konversationellen Analyse teilweise unterstützt. Die Designs für Allgemeine Optionen gelten für Conversational Analytics-Oberflächen. Andere Optionen für das Design werden nicht unterstützt. Eingebettete Designs werden in der Daten-Agent-Konversation in einem eingebetteten Dashboard unterstützt.

Einbettungs-URL für die konversationelle Analyse erstellen

Das Erstellen einer Einbettungs-URL für Conversational Analytics ist dasselbe wie für das Einbetten anderer Inhaltstypen wie Dashboards oder Looks. Sie fügen /embed/ nach dem Instanznamen und vor dem Inhaltsordner und der Inhalts-ID hinzu.

Wenn Sie eine Unterhaltung mit einem Explore-Daten-Agenten oder mit einem eigenständigen Explore einbetten möchten, suchen Sie die nicht eingebettete URL der Unterhaltung oder des Agenten und fügen Sie /embed/ vor dem Ordner conversations oder agents ein. Beispiel:

  • Auf der Seite Unterhaltungen sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/conversations.
  • Auf der 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.
  • Vorschau: Bei einem Dashboard, für das ein Daten-Agent für das Dashboard für Unterhaltungsanalysen verwendet wird, sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/dashboards/1.

Private Einbettung der konversationellen Analyse

Erstellen Sie für das private Einbetten einen iFrame und verwenden Sie die Einbettungs-URL für Conversational Analytics 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 von Conversational Analytics

Der Vorgang für das signierte Einbetten von Conversational Analytics ist derselbe wie für andere Inhaltstypen. Verwenden Sie die Einbettungs-URL für Conversational Analytics, wenn Sie die signierte Einbettungs-URL codieren.

Eingebettete Nutzer benötigen die entsprechenden Berechtigungen, um Conversational Analytics 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-Spark, mit dem der Unterhaltungsbereich des Daten-Agents über ein Dashboard geöffnet wird, für Nutzer sichtbar oder ausgeblendet zu machen. Standardmäßig ist die Option zum Starten einer Unterhaltung mit einem Dashboard-Daten-Agent für Nutzer sichtbar, die Berechtigungen zum Interagieren mit Dashboard-Agents haben. Wenn Sie den Gemini-Spark in einem bestimmten Dashboard ausblenden und die Möglichkeit entfernen möchten, eine Unterhaltung mit einem Dashboard-Daten-Agent 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.