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.

Poiché si tratta di una tecnologia in fase iniziale, Gemini per i prodotti Google Cloud può generare output apparentemente plausibili, ma di fatto errati. Ti consigliamo di verificare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per saperne di più, consulta Gemini for Google Cloud e l'AI responsabile.

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 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.

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.