Incorporar as Análises de Conversação

É possível incorporar a interface da Análise Conversacional em um site ou aplicativo usando uma tag de iframe HTML, assim como você faz com outros tipos de conteúdo do Looker. A interface da Análise Conversacional inclui o painel de conversa do agente de dados do painel e a página Conversas, em que é possível conversar com agentes de dados conectados a várias Análises do Looker ou ter um chat direto com uma Análise.

A Análise Conversacional oferece suporte à incorporação particular, em que os usuários são autenticados usando o login do Looker, e à incorporação assinada, em que os usuários são autenticados pelo seu próprio aplicativo.

Nesta página, descrevemos como incorporar a interface da Análise Conversacional em um iframe.

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

Antes de começar

Para incorporar a Análise Conversacional, os seguintes requisitos precisam ser atendidos:

  • Sua instância precisa ser hospedada pelo Looker.
  • Os usuários precisam das mesmas permissões necessárias para usar a Análise Conversacional não incorporada .
  • Para incorporar um painel do Looker que usa um agente de dados da Análise Conversacional, um administrador precisa ativar os agentes de dados do painel. Na página de administrador Gemini no Looker, em Análise Conversacional, ative a configuração Agentes do painel.

Limitações da incorporação da Análise Conversacional

Observe as seguintes limitações ao incorporar conteúdo da Análise Conversacional:

Os temas incorporados são parcialmente compatíveis quando você está incorporando 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 Análise Conversacional

O processo para criar um URL de incorporação para a Análise Conversacional é o mesmo que para incorporar outros tipos de conteúdo, como painéis ou Looks, em que você adiciona /embed/ após o 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 da Análise ou um chat direto com uma Análise, encontre o URL não incorporado da conversa ou do agente e adicione /embed/ antes da pasta conversations ou agents. Exemplo:

  • Para a página Conversas, o URL de incorporação será parecido com https://my_looker_instance.looker.com/embed/conversations.
  • Para a página Agentes, o URL de incorporação será parecido com https://my_looker_instance.looker.com/embed/agents.
  • Para uma conversa específica, o URL de incorporação será parecido com https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. Neste exemplo, c9f370ac830b4669aeb494396422004c é o ID da conversa.
  • Para um painel que usa um agente de dados da Análise Conversacional, o URL de incorporação será parecido com https://my_looker_instance.looker.com/embed/dashboards/1.

Incorporação particular da Análise Conversacional

Para a incorporação particular, crie um iframe e use o URL de incorporação da Análise Conversacional 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 de incorporação assinada da Análise Conversacional é o mesmo que para outros tipos de conteúdo. Use o URL de incorporação da Análise Conversacional ao codificar o URL de incorporação assinada.

Os usuários incorporados precisam das permissões adequadas para usar a Análise Conversacional, como chat_with_explore ou chat_with_agent. Como resultado, você terá que adicionar essas permissões ao URL de incorporação assinada.

É possível adicionar um parâmetro de URL para tornar o ícone de brilho do Gemini que abre o painel de conversa do agente de dados de um painel visível ou oculto para os usuários. Por padrão, a opção de iniciar uma conversa com um agente de dados do painel fica visível para os usuários que têm permissões para interagir com os agentes do painel. Para ocultar o ícone de brilho do Gemini de um painel específico e remover a capacidade de iniciar uma conversa com um agente de dados do painel, adicione o parâmetro ca_chat=false ao URL de incorporação assinada. Exemplo: https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false.