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 você pode conversar com agentes de dados conectados a várias Análises do Looker ou com uma Análise independente.

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.

Esta página descreve 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 [versão prévia]. Na página de administrador Gemini no Looker, em Ativar recursos de trusted testers, ative a configuração Ativar agentes do painel. A configuração Ativar recursos de trusted testers também precisa estar ativada.

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

Considere 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 com uma Análise independente, 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 [versão prévia], 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 a faísca do Gemini que abre o painel de conversa do agente de dados 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 a faísca 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.