Intégrer Conversational Analytics

Vous pouvez intégrer l'interface Conversational Analytics dans un site Web ou une application à l'aide d'une balise iFrame HTML, comme vous le feriez avec d'autres types de contenu Looker. L'interface Conversational Analytics comprend le volet de conversation de l'agent de données du tableau de bord et la page Conversations, où vous pouvez discuter avec des agents de données connectés à plusieurs explorations Looker ou avec une exploration autonome.

Conversational Analytics est compatible avec l'intégration privée, où les utilisateurs sont authentifiés à l'aide de leurs identifiants de connexion Looker, et avec l'intégration signée, où les utilisateurs sont authentifiés via votre propre application.

Cette page explique comment intégrer l'interface Conversational Analytics dans un iFrame.

Découvrez comment et quand Gemini pour Google Cloud utilise vos données.

Cette technologie étant à un stade précoce, il se peut que les produits Gemini pour Google Cloudgénèrent des résultats qui semblent plausibles, mais qui sont en fait incorrects. Nous vous recommandons de vérifier tous les résultats des produits Gemini pour Google Cloud avant de les utiliser. Pour en savoir plus, consultez la page Gemini pouret l'IA responsable. Google Cloud

Avant de commencer

Pour intégrer Conversational Analytics, vous devez remplir les conditions suivantes :

• Votre instance doit être hébergée par Looker.
• Les utilisateurs auront besoin des mêmes autorisations que celles requises pour utiliser Conversational Analytics non intégré.
• Pour intégrer un tableau de bord Looker qui utilise un agent de données de tableau de bord d'analyse conversationnelle, un administrateur doit activer les agents de données de tableau de bord (aperçu). Sur la page d'administration Gemini dans Looker, sous le paramètre Activer les fonctionnalités pour les testeurs de confiance, activez le paramètre Activer les agents de tableau de bord. Le paramètre Activer les fonctionnalités pour les testeurs de confiance doit également être activé.

Limites de l'intégration de l'analyse conversationnelle

Tenez compte des limites suivantes lorsque vous intégrez du contenu d'analyse conversationnelle :

Les thèmes intégrés sont partiellement compatibles lorsque vous intégrez Conversational Analytics. Les thèmes des options générales s'appliquent aux interfaces Conversational Analytics. Aucune autre option de thème n'est acceptée. Les thèmes intégrés sont compatibles avec l'expérience de conversation de l'agent de données dans un tableau de bord intégré.

Créer l'URL d'intégration de Conversational Analytics

Le processus de création d'une URL d'intégration pour Conversational Analytics est le même que pour l'intégration d'autres types de contenu, tels que des tableaux de bord ou des Looks, où vous ajoutez /embed/ après le nom de l'instance et avant le dossier de contenu et l'ID de contenu.

Pour intégrer une conversation avec un agent de données d'exploration ou avec une exploration autonome, recherchez l'URL non intégrée de la conversation ou de l'agent, puis ajoutez /embed/ avant le dossier conversations ou agents. Exemple :

• Pour la page Conversations, l'URL d'intégration se présentera comme suit : https://my_looker_instance.looker.com/embed/conversations.
• Pour la page Agents, l'URL d'intégration se présentera comme suit : https://my_looker_instance.looker.com/embed/agents.
• Pour une conversation spécifique, l'URL d'intégration se présentera comme suit : https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. Dans cet exemple, c9f370ac830b4669aeb494396422004c est l'ID de la conversation.
• Aperçu : pour un tableau de bord qui utilise un agent de données de tableau de bord d'analyse conversationnelle, l'URL d'intégration se présentera comme suit : https://my_looker_instance.looker.com/embed/dashboards/1.

Intégration privée de Conversational Analytics

Pour l'intégration privée, créez un iFrame et utilisez l'URL d'intégration de Conversational Analytics comme source d'iFrame, comme illustré dans l'exemple suivant :

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

Intégrez ensuite l'iFrame dans votre page Web ou votre application.

Intégration signée de Conversational Analytics

Le processus d'intégration signée de Conversational Analytics est le même que pour les autres types de contenu. Utilisez l'URL d'intégration de Conversational Analytics lorsque vous codez l'URL d'intégration signée.

Les utilisateurs intégrés auront besoin des autorisations appropriées pour utiliser Conversational Analytics, telles que chat_with_explore ou chat_with_agent. Par conséquent, vous devrez ajouter ces autorisations à l'URL d'intégration signée.

Vous pouvez ajouter un paramètre d'URL pour que l'étincelle Gemini qui ouvre le volet de conversation de l'agent de données à partir d'un tableau de bord soit visible ou masquée pour les utilisateurs. Par défaut, l'option permettant de démarrer une conversation avec un agent de données de tableau de bord est visible pour les utilisateurs autorisés à interagir avec les agents de tableau de bord. Pour masquer l'étincelle Gemini d'un tableau de bord spécifique et supprimer la possibilité de démarrer une conversation avec un agent de données de tableau de bord, ajoutez le paramètre ca_chat=false à l'URL d'intégration signée. Exemple : https://my_looker_instance.looker.com/embed/dashboards/1?ca_chat=false.