Intégrer Conversational Analytics

Vous pouvez intégrer Conversational Analytics dans un site Web ou une application à l'aide d'une balise iFrame HTML, comme vous le faites avec d'autres types de contenu Looker. Conversational Analytics est compatible avec l'intégration privée, où les utilisateurs sont authentifiés à l'aide de leur identifiant Looker, et avec l'intégration signée, où les utilisateurs sont authentifiés via votre propre application.

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

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

Avant de commencer

Pour intégrer Conversational Analytics, gardez à l'esprit les exigences et limites suivantes :

  • Pour intégrer Conversational Analytics, votre instance doit être sur Looker 26.2 ou version ultérieure.
  • Votre administrateur Looker doit activer la fonctionnalité expérimentale Intégrer Conversational Analytics.
  • Les utilisateurs auront besoin des mêmes autorisations que celles requises pour utiliser Conversational Analytics non intégré.
  • Pendant la version bêta, les limites supplémentaires suivantes s'appliquent :
    • L'intégration de Conversational Analytics n'est possible que dans Looker (original). Looker (Google Cloud Core) n'est pas compatible.
    • Les thèmes intégrés ne sont pas acceptés.
    • Le SDK Embed n'est pas compatible avec l'intégration signée d'analyses conversationnelles.

Créer l'URL à intégrer pour l'analyse conversationnelle

La procédure de création d'une URL à intégrer pour Conversational Analytics est la même que pour intégrer d'autres types de contenu, tels que des tableaux de bord ou des Looks. Vous devez ajouter /embed/ après le nom de l'instance et avant le dossier de contenu et l'ID de contenu.

Pour Conversational Analytics, 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 des conversations, l'URL d'intégration ressemblera à https://my_looker_instance.looker.com/embed/conversations.
  • Pour la page des agents, l'URL d'intégration ressemblera à https://my_looker_instance.looker.com/embed/agents.
  • Pour une conversation spécifique, l'URL à intégrer se présente comme suit : https://my_looker_instance.looker.com/embed/conversations/c9f370ac830b4669aeb494396422004c. Dans cet exemple, c9f370ac830b4669aeb494396422004c correspond à l'ID de conversation.

Intégration privée de Conversational Analytics

Pour l'intégration privée, créez un iFrame et utilisez l'URL d'intégration Conversational Analytics comme source de votre iFrame, comme indiqué 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 à 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 doivent disposer des autorisations appropriées pour utiliser Conversational Analytics, comme chat_with_explore. Par conséquent, vous devrez ajouter ces autorisations à l'URL d'intégration signée.