We’ve migrated our documentation to a new site, which means some URLs have changed. If you hit a broken link, submit a support ticket.
General
English French
English French

Tutor

Fonctionnement de Tutor

Lorsque vous posez une question ou soumettez une demande à Tutor, il procède aux étapes suivantes :

  1. Détection du produit : Tutor détermine d'abord si votre question porte sur un produit Piano spécifique et filtre la documentation pertinente en conséquence.

  2. Recherche par similarité sémantique : il évalue la similarité sémantique entre votre question et la documentation disponible ainsi que les FAQ du support.

  3. Sélection des sources : Tutor sélectionne les 15 sources les plus pertinentes de sa base de connaissances.

  4. Génération de la réponse : à l'aide de LLM, Tutor construit une réponse cohérente à partir des sources sélectionnées.

  5. Liste des sources : Tutor fournit la liste des sources utilisées pour générer la réponse, afin que vous puissiez vérifier les informations. Les FAQ du support indiquent également l'ancienneté du contenu pour vous aider à évaluer si l'information est susceptible d'être obsolète.

Accéder à Tutor

Les clients Piano peuvent accéder à Tutor à l'adresse tutor.piano.io. Toutes les personnes disposant d'un identifiant pour les applications de production Piano Subscriptions ou Piano Analytics peuvent se connecter à Tutor avec leurs identifiants habituels. Si un utilisateur d'une organisation cliente ne dispose pas d'identifiant, il doit être ajouté à l'application de production ; il pourra alors se connecter à Tutor sous 24 heures.

Les clients qui utilisent l'ancien Single Sign-On (SSO) de Piano Analytics peuvent rencontrer des problèmes de connexion. La principale solution consiste à migrer vers la nouvelle solution SSO, mais ces utilisateurs peuvent aussi se connecter via le lien « Réinitialiser le mot de passe ». À ce jour, les clients Piano disposant uniquement d'un compte SocialFlow ne peuvent pas encore se connecter à Tutor. Une unification du SSO SocialFlow est prévue pour le permettre à l'avenir.

En cas de problème d'accès à Tutor, contactez votre account manager ou écrivez à tutor@piano.io.

Bien utiliser Tutor

Comment poser des questions

  • Soyez précis : posez des questions claires et précises pour obtenir les réponses les plus exactes. Évitez les formulations ambiguës et les détails superflus.

  • Donnez du contexte : ajoutez les informations de contexte pertinentes et des détails sur le produit ou la fonctionnalité concernés.

  • Mentionnez les produits Piano : citez explicitement le produit Piano (Management + Billing, Composer, ID, Piano Analytics, DMP, ESP ou SocialFlow, par exemple) afin de filtrer les informations pertinentes.

  • Utilisez des mots-clés : employez des mots-clés liés au sujet, comme des noms de produits ou de fonctionnalités.

  • Évitez les liens : plutôt que d'inclure des liens, copiez-collez l'extrait de texte auquel vous souhaitez faire référence.

  • Décomposez vos questions : si vous avez plusieurs questions, posez-les dans des demandes distinctes.

Exemples de questions

Les questions précises qui contiennent les noms et mots-clés pertinents donnent généralement les meilleurs résultats :

  • « Quelle API Management + Billing puis-je utiliser pour récupérer les informations d'un abonné ? »

  • « Dans Identity Management, combien de temps un lien de réinitialisation du mot de passe reste-t-il valide pour un utilisateur ? »

  • « Quelles sont les différences entre les propriétés de source dans Piano Analytics ? »

Les questions ambiguës comme « Parle-moi des rapports », qui peuvent concerner différents produits de la plateforme Piano, risquent de produire des réponses confuses. De même, un mot-clé isolé comme « API », « login » ou « conversions » peut faire remonter de la documentation de plusieurs produits Piano.

Pour de meilleurs résultats, essayez des questions plus précises, par exemple :

  • « Comment voir les conversions d'une expérience Composer spécifique ? »

  • « Quelles métriques de Piano Analytics sont couramment utilisées pour suivre les conversions ? »

Sources

Après avoir répondu à une question, Tutor génère automatiquement un message « Comment cette réponse a été produite » qui indique les sources utilisées pour élaborer la réponse. Vous pouvez également cliquer sur « Afficher les sources » pour consulter la liste des sources. Cette fonctionnalité vous permet de vérifier facilement la réponse de Tutor.

Notez que Tutor peut parfois fournir des informations inexactes, en raison d'une documentation obsolète, d'un contenu ambigu ou des limites du modèle de langage. Si vous recevez une réponse inexacte, vous pouvez le signaler par e-mail à tutor@piano.io : nous pourrons ainsi combler les lacunes de la documentation et continuer à améliorer la précision de Tutor.

Évaluer les réponses

Après avoir reçu une réponse de Tutor, évaluez son utilité :

  • Très utile : Tutor a été précis et a fourni une réponse correcte.

  • Assez utile : la réponse de Tutor était partiellement correcte ou légèrement à côté.

  • Inutile : Tutor n'a pas pu répondre ou a fourni une réponse incorrecte.

Vous pouvez également envoyer un retour plus détaillé à l'équipe Tutor à l'adresse tutor@piano.io.

Questions de suivi

Vous pouvez poser des questions de suivi pour approfondir un sujet ou préciser votre demande initiale. Tutor utilise vos questions précédentes comme contexte pour affiner ses réponses.

Après avoir posé une question, l'option « Suggérer des questions associées » s'affiche sous votre requête. Cliquez sur ce bouton pour que Tutor vous suggère 5 à 10 questions alternatives liées à votre question initiale.

Redémarrer la conversation

Pour aborder un nouveau sujet, utilisez l'option « Effacer le chat » afin de réinitialiser le contexte.

Historique

L'onglet « Historique » vous permet de consulter vos conversations passées avec Tutor, par exemple pour retrouver une ancienne réponse. En cliquant sur un fil de conversation, vous pouvez partager son URL avec d'autres utilisateurs de votre organisation. Vos collègues peuvent ainsi accéder à la conversation et profiter des informations partagées. Les questions que vous posez n'apparaissent pas automatiquement dans leur propre onglet « Historique », mais ils peuvent accéder à votre fil de conversation Tutor si vous leur partagez le lien direct.

À noter :

  • Partage au sein de votre organisation : seuls les utilisateurs de votre organisation ayant accès à Tutor peuvent ouvrir les liens partagés. Cette fonctionnalité facilite la collaboration en permettant aux membres de l'équipe de partager facilement connaissances et solutions.

  • Accès externe : les utilisateurs extérieurs à votre organisation ne peuvent pas accéder à ces liens partagés. Les données et conversations de votre organisation restent ainsi sécurisées.

Si vous souhaitez que l'équipe support de Piano vérifie une réponse de Tutor, vous pouvez partager l'URL du fil de conversation Tutor dans votre e-mail à support@piano.io. Le support disposera ainsi du contexte nécessaire pour traiter votre demande.

Utilisation multilingue

Grâce aux capacités des LLM, Tutor peut converser dans la langue de votre choix. Cependant, l'interface de Tutor n'est pas entièrement localisée : si la question et la réponse peuvent être dans n'importe quelle langue, les citations et les sources elles-mêmes restent en anglais.

Contacter le support

Si vous souhaitez que l'équipe support de Piano vérifie une réponse de Tutor, indiquez l'URL du fil de conversation Tutor dans votre e-mail à support@piano.io. Pour trouver cette URL, ouvrez l'onglet « Historique », cliquez sur le fil concerné et copiez l'URL depuis votre navigateur. Le support disposera ainsi du contexte nécessaire pour traiter votre demande.

Vous pouvez également contacter l'équipe produit Tutor par e-mail à tutor@piano.io pour partager vos retours ou soumettre des demandes de fonctionnalités liées à Tutor.

Avis de transparence

Tutor est un chatbot reposant sur l'intelligence artificielle. Le présent avis a pour objet d'assurer la transparence et de vous informer de l'utilisation de l'intelligence artificielle dans ce service.

Nature du système

Tutor est un système d'IA conçu pour aider les utilisateurs en fournissant des réponses automatisées aux questions et demandes relatives aux produits Piano. Il repose sur des technologies de traitement du langage naturel et d'apprentissage automatique. Il s'agit d'un système qui s'appuie sur des LLM (Large Language Models, grands modèles de langage) tiers fournis par Anthropic et OpenAI. Nous interrogeons ces modèles via une API (Application Programming Interface) en leur transmettant :

  • les questions des clients,

  • la documentation pertinente produite par Piano, pour aider les modèles à comprendre le contexte,

  • pour les demandes de support envoyées par e-mail, des données nettoyées, dont les données personnelles ont été supprimées et remplacées par des valeurs génériques.

Au sens de l'AI Act européen, il s'agit d'un système d'IA à risque limité, ce qui signifie qu'il présente un risque potentiel minime pour la sécurité ou les droits fondamentaux des utilisateurs.

Finalité et capacités

Tutor sert à répondre aux questions fréquentes et à fournir des informations sur nos services et nos produits. Il peut aussi aider à résoudre des problèmes simples ou à naviguer dans nos outils.

Avec cet outil, nous souhaitons offrir un support efficace et une expérience utilisateur fluide, tout en permettant à tout utilisateur qui le souhaite d'être redirigé vers notre équipe de support humaine.

Tutor ne prend aucune décision juridiquement contraignante et ne remplace pas les conseils d'un professionnel. Pour les questions complexes ou sensibles, un interlocuteur humain reste disponible.

Identification de l'IA et supervision humaine

Comme d'autres types de modèles d'IA, Tutor n'est pas exhaustif : il ne peut générer des réponses qu'à partir des contenus dont il dispose et n'est pas capable de véritablement résoudre des problèmes ni d'appliquer un raisonnement humain. La qualité de ses réponses dépend donc directement des informations auxquelles il a accès. Cette interaction est automatisée et générée par un système d'IA. Si vous préférez échanger avec une personne, vous pouvez à tout moment demander une assistance humaine par e-mail à support@piano.io.

Tutor est supervisé par Piano afin de garantir l'exactitude et la pertinence de ses réponses. Les conversations peuvent être examinées afin d'améliorer la qualité du système et d'assurer sa conformité.

Traitement des données personnelles

Lorsqu'il génère des réponses aux demandes de support envoyées par e-mail, Tutor supprime toutes les données personnelles (noms, adresses e-mail, identifiants utilisateur et autres informations permettant d'identifier une personne) au sein de son data center européen, avant tout appel à des API externes.

Les accords conclus par Piano avec les fournisseurs de LLM stipulent que les données transmises via l'API ne sont pas utilisées pour entraîner les modèles de ces fournisseurs. Piano suit et analyse l'utilisation de Tutor par ses clients afin d'améliorer le produit, de fournir des réponses plus pertinentes et d'améliorer l'expérience des clients Piano.

Droits des utilisateurs

En tant qu'utilisateur interagissant avec ce système d'IA, vous avez le droit :

  • d'être informé que vous interagissez avec une IA (objet du présent avis),

  • de refuser de poursuivre l'interaction et de demander un contact humain.

Contact

Pour toute question ou préoccupation concernant ce système d'IA, contactez support@piano.io.

Last updated: