Conversational Analytics einbetten

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

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 Dashboard-Datenagenten für die konversationelle Analyse verwendet, muss ein Administrator Dashboard-Datenagenten [Vorschau] aktivieren. Aktivieren Sie auf der Verwaltungsseite Gemini in Looker unter der Einstellung Trusted Tester-Funktionen aktivieren die Einstellung Dashboard-Agenten aktivieren. Die Einstellung Trusted Tester-Funktionen aktivieren muss ebenfalls aktiviert sein.

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 in der Unterhaltung mit dem Datenagenten in einem eingebetteten Dashboard unterstützt.

Einbettungs-URL für die konversationelle 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 Inhalts-ID hinzu.

Wenn Sie eine Unterhaltung mit einem Explore-Datenagenten 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:

• Für die Seite Unterhaltungen sieht die Einbettungs-URL so aus: https://my_looker_instance.looker.com/embed/conversations.
• Für die Seite 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 Dashboard-Datenagenten für die konversationelle Analyse [Vorschau] 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 Datenagenten über ein Dashboard öffnet, für Nutzer sichtbar oder unsichtbar zu machen. Standardmäßig ist die Option zum Starten einer Unterhaltung mit einem Dashboard-Datenagenten für Nutzer sichtbar, die Berechtigungen zur Interaktion mit Dashboard-Agenten haben. Wenn Sie den Gemini-Funken für ein bestimmtes Dashboard ausblenden und die Möglichkeit entfernen möchten, eine Unterhaltung mit einem Dashboard-Datenagenten 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.