Incorporare Analisi conversazionale

Puoi incorporare l'interfaccia di Conversational Analytics 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 della conversazione dell'agente di dati della dashboard e la pagina Conversazioni, in cui puoi chattare con gli agenti di dati connessi a più esplorazioni di Looker o con un'esplorazione autonoma.

Conversational Analytics 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 Conversational Analytics in un iframe.

Scopri come e quando Gemini per 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 di dati della dashboard di Conversational Analytics, un amministratore deve attivare gli agenti di dati della dashboard [anteprima]. Nella pagina di amministrazione Gemini in Looker, nella sezione Abilita le funzionalità di Trusted Tester, attiva l'impostazione Abilita agenti dashboard. Deve essere attivata anche l'impostazione Abilita le funzionalità di Trusted Tester.

Limitazioni dell'incorporamento di Analisi conversazionale

Tieni presenti le seguenti limitazioni quando incorpori contenuti di Conversational Analytics:

I temi incorporati sono parzialmente supportati quando incorpori Analisi conversazionale. I temi delle Opzioni generali si applicano alle interfacce di Analisi conversazionale. Non sono supportate altre opzioni di 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 incorporato per Conversational Analytics è la stessa 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 contenuto.

Per incorporare una conversazione con un agente di dati di Esplora o con un'esplorazione 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 incorporato sarà simile a https://my_looker_instance.looker.com/embed/conversations.
  • Per la pagina Agenti, l'URL incorporato sarà simile a https://my_looker_instance.looker.com/embed/agents.
  • Per una conversazione specifica, l'URL incorporato avrà il seguente aspetto: https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. In questo esempio, c9f370ac830b4669aeb494396422004c è l'ID conversazione.
  • Per una dashboard che utilizza un agente di dati della dashboard Conversational Analytics [Anteprima], 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 Conversational Analytics 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>

Poi incorpora l'iframe nella pagina web o nell'applicazione.

Incorporamento firmato di Analisi conversazionale

La procedura per l'incorporamento firmato di Conversational Analytics è la stessa degli altri tipi di contenuti. Utilizza l'URL di incorporamento di Conversational Analytics 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 incorporato firmato.

Puoi aggiungere un parametro URL per rendere visibile o nascosta agli utenti la scintilla di 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 di dati della dashboard è visibile agli utenti che dispongono delle autorizzazioni per interagire con gli agenti della dashboard. Per nascondere la scintilla di Gemini da una dashboard specifica e rimuovere la possibilità di avviare una conversazione con un agente di dati della dashboard, aggiungi il parametro ca_chat=false all'URL incorporato firmato. Ad esempio: https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false.