Incorporar as Análises de Conversação

É possível incorporar a interface do Conversational Analytics em um site ou aplicativo usando uma tag iframe HTML, assim como outros tipos de conteúdo do Looker. A interface das Análises de conversação inclui o painel de conversa do agente de dados do dashboard e a página Conversas, em que você pode conversar com agentes de dados conectados a várias análises do Looker ou com uma análise independente.

A análise de dados de conversação é compatível com a incorporação particular, em que os usuários são autenticados com o login do Looker, e a incorporação assinada, em que os usuários são autenticados pelo seu próprio aplicativo.

Nesta página, descrevemos como incorporar a interface do Conversational Analytics em um iframe.

Saiba como e quando o Gemini para Google Cloud usa seus dados.

Antes de começar

Para incorporar a Análise de conversação, considere os seguintes requisitos e limitações:

  • Sua instância precisa ser hospedada pelo Looker.
  • Os usuários precisam das mesmas permissões necessárias para usar a Análise de conversas não incorporada.
  • Os temas incorporados são parcialmente compatíveis quando você incorpora a Análise conversacional. Os temas das Opções gerais se aplicam às interfaces da Análise Conversacional. Nenhuma outra opção de tema é compatível. Os temas incorporados são compatíveis com a experiência de conversa do agente de dados em um painel incorporado.

Como criar o URL de incorporação da API Conversational Analytics

O processo para criar um URL de incorporação para a Conversational Analytics é o mesmo que para incorporar outros tipos de conteúdo, como dashboards ou Looks. Basta adicionar /embed/ depois do nome da instância e antes da pasta de conteúdo e do ID do conteúdo.

Para incorporar uma conversa com um agente de dados do recurso Detalhar ou com um recurso Detalhar independente, encontre o URL não incorporado da conversa ou do agente e adicione /embed/ antes da pasta conversations ou agents. Exemplo:

  • Na página Conversas, o URL de incorporação será semelhante a https://my_looker_instance.looker.com/embed/conversations.
  • Na página Agentes, o URL de incorporação será semelhante a https://my_looker_instance.looker.com/embed/agents.
  • Para uma conversa específica, o URL de incorporação será semelhante a https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. Neste exemplo, c9f370ac830b4669aeb494396422004c é o ID da conversa.

Incorporação privada da Análise conversacional

Para incorporação privada, crie um iframe e use o URL de incorporação do Conversational Analytics como origem do iframe, conforme mostrado no exemplo a seguir:

  <iframe
      src="https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Em seguida, incorpore o iframe na sua página da Web ou aplicativo.

Incorporação assinada da Análise Conversacional

O processo para incorporação assinada da análise de conversas é o mesmo que para outros tipos de conteúdo. Use o URL de incorporação da Análise de conversas ao codificar o URL de incorporação assinado.

Os usuários incorporados precisam ter as permissões adequadas para usar o recurso de análise de conversação, como chat_with_explore ou chat_with_agent. Como resultado, você terá que adicionar essas permissões ao URL de incorporação assinado.

Você pode adicionar um parâmetro de URL para tornar visível ou ocultar dos usuários o Gemini Spark que abre o painel de conversa do agente de dados em um painel.