Incorpora Conversational Analytics

Puedes incorporar la interfaz de Conversational Analytics en un sitio web o una aplicación con una etiqueta iframe HTML, al igual que con otros tipos de contenido de Looker. La interfaz de Conversational Analytics incluye el panel de conversación del agente de datos del panel y la página Conversaciones, en la que puedes chatear con agentes de datos que están conectados a varios Explorar de Looker o chatear con un Explorar independiente.

Conversational Analytics admite la incorporación privada, en la que los usuarios se autentican con su acceso a Looker, y la incorporación firmada, en la que los usuarios se autentican a través de tu propia aplicación.

En esta página, se describe cómo incorporar la interfaz de Conversational Analytics en un iframe.

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.

Antes de comenzar

Para incorporar Conversational Analytics, se deben cumplir los siguientes requisitos:

  • Tu instancia debe estar alojada en Looker.
  • Los usuarios necesitarán los mismos permisos que se requieren para usar Conversational Analytics no integrado.
  • Para incorporar un panel de Looker que use un agente de datos del panel de estadísticas de conversaciones, un administrador debe habilitar los agentes de datos del panel (versión preliminar). En la página de administrador de Gemini en Looker, en el parámetro de configuración Habilitar funciones del verificador de confianza, activa el parámetro de configuración Habilitar agentes de panel. También se debe habilitar el parámetro de configuración Habilitar funciones del verificador de confianza.

Limitaciones de la incorporación de Conversational Analytics

Ten en cuenta las siguientes limitaciones cuando incorpores contenido de análisis conversacional:

Los temas incorporados se admiten parcialmente cuando incorporas Conversational Analytics. Los temas de Opciones generales se aplican a las interfaces de Conversational Analytics. No se admiten otras opciones de temas. Los temas incorporados son compatibles con la experiencia de conversación del agente de datos en un panel incorporado.

Cómo crear la URL incorporada de Conversational Analytics

El proceso para crear una URL de incorporación para Conversational Analytics es el mismo que para incorporar otros tipos de contenido, como paneles o Looks, en el que agregas /embed/ después del nombre de la instancia y antes de la carpeta de contenido y el ID de contenido.

Para incorporar una conversación con un agente de datos de Explore o con una instancia de Explore independiente, busca la URL no incorporada de la conversación o el agente, y agrega /embed/ antes de la carpeta conversations o agents. Por ejemplo:

  • En la página Conversaciones, la URL incorporada se verá como https://my_looker_instance.looker.com/embed/conversations.
  • En la página Agentes, la URL de incorporación se verá como https://my_looker_instance.looker.com/embed/agents.
  • En el caso de una conversación específica, la URL de incorporación se verá como https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. En este ejemplo, c9f370ac830b4669aeb494396422004c es el ID de la conversación.
  • Vista previa: En el caso de un panel que usa un agente de datos del panel de análisis de conversaciones, la URL de incorporación se verá como https://my_looker_instance.looker.com/embed/dashboards/1.

Incorporación privada de Conversational Analytics

Para la incorporación privada, crea un iframe y usa la URL de incorporación de Conversational Analytics como fuente del iframe, como se muestra en el siguiente ejemplo:

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

Luego, incorpora el iframe en tu página web o aplicación.

Incorporación firmada de Conversational Analytics

El proceso para la incorporación firmada de Conversational Analytics es el mismo que para otros tipos de contenido. Usa la URL de incorporación de Conversational Analytics cuando codifiques la URL de incorporación firmada.

Los usuarios integrados necesitarán los permisos adecuados para usar Conversational Analytics, como chat_with_explore o chat_with_agent. Como resultado, deberás agregar esos permisos a la URL de incorporación firmada.

Puedes agregar un parámetro de URL para que el de Gemini que abre el panel de conversación del agente de datos desde un panel esté visible o oculto para los usuarios. De forma predeterminada, la opción para iniciar una conversación con un agente de datos del panel está visible para los usuarios que tienen permisos para interactuar con los agentes del panel. Para ocultar el ícono de Gemini en un panel específico y quitar la capacidad de iniciar una conversación con un agente de datos del panel, agrega el parámetro ca_chat=false a la URL de incorporación firmada. Por ejemplo: https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false.