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 autonomo.
Analisi conversazionale supporta sia l'incorporamento privato, in cui gli utenti vengono autenticati utilizzando le 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, tieni presente i seguenti requisiti e limitazioni:
- La tua istanza deve essere ospitata da Looker.
- Gli utenti avranno bisogno delle stesse autorizzazioni necessarie per utilizzare Analisi conversazionale non incorporata.
- 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 del contenuto.
Per incorporare una conversazione con un agente dati di Esplora o con un Esplora autonomo, 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.
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 nascondere agli utenti la scintilla 
Gemini che apre il riquadro di conversazione dell'agente dati da una dashboard.