Puoi incorporare l'interfaccia di Analisi conversazionale in un sito web o in un'applicazione utilizzando un tag iframe HTML, proprio come puoi fare con altri tipi di contenuti di Looker. L'interfaccia di Analisi conversazionale include il riquadro di conversazione dell'agente dati della dashboard e la pagina Conversazioni, dove puoi chattare con gli agenti dati connessi a più Esplora di Looker o con un'Esplora autonoma.
Analisi conversazionale supporta sia l'incorporamento privato, in cui gli utenti vengono autenticati utilizzando le proprie credenziali di accesso a Looker, sia l'incorporamento firmato, in cui gli utenti vengono autenticati tramite la tua applicazione.
Questa pagina descrive come incorporare l'interfaccia di Analisi conversazionale in un iframe.
Scopri come e quando Gemini for Google Cloud utilizza i tuoi dati.
Prima di iniziare
Per incorporare Analisi conversazionale, devono essere soddisfatti i seguenti requisiti:
- La tua istanza deve essere ospitata da Looker.
- Gli utenti avranno bisogno delle stesse autorizzazioni necessarie per utilizzare Analisi conversazionale non incorporata.
- Per incorporare una dashboard di Looker che utilizza un agente dati della dashboard di analisi conversazionale, un amministratore deve abilitare gli agenti dati della dashboard (anteprima). Nella pagina di amministrazione Gemini in Looker, nella sezione Abilita le funzionalità di Trusted Tester, attiva l'impostazione Abilita gli agenti della dashboard. Deve essere abilitata anche l'impostazione Abilita le funzionalità di Trusted Tester.
Limitazioni dell'incorporamento dell'analisi conversazionale
Tieni presente le seguenti limitazioni quando incorpori contenuti di analisi conversazionale:
I temi incorporati sono supportati parzialmente quando incorpori Analisi conversazionale. I temi delle opzioni generali si applicano alle interfacce di Analisi conversazionale. Non sono supportate altre opzioni di applicazione dei temi. I temi incorporati sono supportati nell'esperienza di conversazione dell'agente dati in una dashboard incorporata.
Creazione dell'URL di incorporamento di Analisi conversazionale
La procedura per creare un URL di incorporamento per Analisi conversazionale è la stessa utilizzata per incorporare altri tipi di contenuti, come dashboard o Look, in cui aggiungi /embed/ dopo il nome dell'istanza e prima della cartella dei contenuti e dell'ID dei contenuti.
Per incorporare una conversazione con un agente dati di Esplora o con un'Esplora autonoma, trova l'URL non incorporato della conversazione o dell'agente e aggiungi /embed/ prima della cartella conversations o agents. Ad esempio:
- Per la pagina Conversazioni, l'URL di incorporamento sarà simile a
https://my_looker_instance.looker.com/embed/conversations. - Per la pagina Agenti, l'URL di incorporamento sarà simile a
https://my_looker_instance.looker.com/embed/agents. - Per una conversazione specifica, l'URL di incorporamento sarà simile a
https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. In questo esempio,c9f370ac830b4669aeb494396422004cè l'ID della conversazione. - Anteprima: per una dashboard che utilizza un agente dati della dashboard di analisi conversazionale, l'URL di incorporamento sarà simile a
https://my_looker_instance.looker.com/embed/dashboards/1.
Incorporamento privato di Analisi conversazionale
Per l'incorporamento privato, crea un iframe e utilizza l'URL di incorporamento di Analisi conversazionale come origine dell'iframe, come mostrato nell'esempio seguente:
<iframe
src="https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c"
width="1000"
height="2000"
frameborder="0">
</iframe>
Quindi incorpora l'iframe nella pagina web o nell'applicazione.
Incorporamento firmato di Analisi conversazionale
La procedura per l'incorporamento firmato di Analisi conversazionale è la stessa utilizzata per altri tipi di contenuti. Utilizza l'URL di incorporamento di Analisi conversazionale quando codifichi l'URL di incorporamento firmato.
Gli utenti incorporati avranno bisogno delle autorizzazioni appropriate per utilizzare Analisi conversazionale, ad esempio chat_with_explore o chat_with_agent. Di conseguenza, dovrai aggiungere queste autorizzazioni all'URL di incorporamento firmato.
Puoi aggiungere un parametro URL per rendere visibile o nascosta agli utenti la scintilla 
Gemini che apre il riquadro di conversazione dell'agente dati da una dashboard. Per impostazione predefinita, l'opzione per avviare una conversazione con un agente dati della dashboard è visibile agli utenti che hanno le autorizzazioni per interagire con gli agenti della dashboard. Per nascondere la scintilla Gemini da una dashboard specifica e rimuovere la possibilità di avviare una conversazione con un agente dati della dashboard, aggiungi il parametro ca_chat=false all'URL di incorporamento firmato. Ad esempio: https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false.