É 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 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 de painel de 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 de 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ê 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 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 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. - Versão prévia: para um painel que usa um agente de dados de painel de 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 a 
faísca 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 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.