> For the complete documentation index, see [llms.txt](https://docs.yelda.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yelda.fr/pilotage/conversations.md). # La page Conversations La page **Conversations** est votre point d'entrée pour le pilotage au quotidien. Elle rassemble l'ensemble des échanges entre votre agent IA et vos utilisateurs finaux, quel que soit le canal (fenêtre de chat, téléphone, SMS). Vous y suivez ce qui se passe en temps réel, retrouvez une conversation précise, et ouvrez le détail d'un échange pour comprendre comment l'agent a répondu. Cette page est en lecture : elle sert à **observer et analyser**, pas à modifier le comportement de l'agent (le paramétrage se fait dans les sections dédiées du studio). ![Liste des conversations dans le studio Yelda](https://3413274643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrHOdrzebY5DHcj61qXu%2Fuploads%2Fgit-blob-fd961fca5f0a9471a63ff4d77ae8e648d0cf95cf%2Fconversations-liste.png?alt=media) *** ## 1. Lire la liste des conversations Chaque ligne correspond à une conversation. Le tableau affiche les colonnes suivantes. | Colonne | Ce qu'elle indique | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom** | L'utilisateur final. Sur un agent de chat, un nom (ex. *Lina P.*). Sur un agent vocal, le numéro de téléphone masqué (ex. *+336 \*\* \*\* 42 05*). | | **Messages** | Le nombre de messages échangés dans la conversation. | | **Titre & aperçu** | Un titre décrivant la conversation (voir ci-dessous) et un aperçu du message le plus récent ou le plus pertinent. | | **Automatisation** | Indique si la conversation a été entièrement gérée par l'IA ou transmise à un humain. | | **Plateforme** | Le canal par lequel la conversation a eu lieu (fenêtre de chat, téléphone…). | | **Notation** | La note laissée par l'utilisateur final, lorsque cette fonctionnalité est activée. | | **Date** | Date et heure de la dernière activité. | ### Le titre et l'aperçu Le **titre** (en gras) est une description courte de la conversation. Sa génération est **optionnelle** : elle dépend de la configuration de votre agent. Si l'option n'est pas activée, la ligne n'affiche pas de titre, seulement l'aperçu. Un titre peut se terminer par une mention de statut, par exemple *« · Transféré à l'agent »* ou *« · Agent no reply »*, qui résume l'issue de la conversation. L'**aperçu** montre un extrait du message le plus récent, précédé de `(…)` lorsqu'il ne s'agit pas du tout début de la conversation. La mention **En cours** accompagnée d'un point vert signale une conversation encore active. ### La colonne Automatisation C'est l'indicateur clé pour distinguer ce que l'IA a traité seule de ce qui a nécessité un humain : * **Coche verte** → la conversation a été **entièrement automatisée** par l'agent IA, sans intervention humaine. * **Autre icône** (bulle de discussion sur un agent de chat, combiné téléphonique sur un agent vocal) → il y a eu une **mise en relation** avec un humain. Lorsqu'une mise en relation a lieu, le **nom de l'équipe ou de l'agent** qui a pris le relais peut s'afficher sous l'icône (ex. *Floa Support*). Ce nom dépend de votre configuration : avec un seul compte de prise en charge, un nom générique unique s'affiche ; avec un live chat comportant plusieurs agents, le nom de l'agent concerné apparaît. ### La colonne Notation Lorsque l'évaluation est activée pour votre agent, l'utilisateur final peut laisser une note à l'issue de la conversation ; elle s'affiche ici. Si la fonctionnalité n'est pas activée sur votre projet, la colonne reste vide. > **À noter** : titre généré, notation et plateformes multiples sont des **options de configuration**. Leur présence varie d'un agent à l'autre. *** ## 2. Filtrer et suivre en temps réel Au-dessus du tableau, une barre de filtres vous aide à retrouver rapidement les conversations pertinentes : * **Intents** — filtrer par intention détectée dans les conversations. * **Messages** — filtrer selon le volume ou le type de messages. * **Plateformes** — filtrer par canal, lorsque votre agent est multicanal. * **Évaluations** — filtrer par note reçue, lorsque l'évaluation est activée. * **Mise à jour en temps réel** — un interrupteur qui, une fois activé, actualise la liste automatiquement à mesure que de nouvelles conversations arrivent. Le compteur en haut de la liste indique le **nombre total de conversations**. Le bouton **Afficher les nouvelles interactions** charge les conversations survenues depuis l'ouverture de la page. > **Astuce** : gardez la mise à jour en temps réel activée pour surveiller l'activité pendant une opération sensible (campagne, incident) ; désactivez-la pour analyser un volume figé sans que la liste ne bouge sous vos yeux. ### Les onglets En haut de la page, trois onglets séparent les vues : **Conversations**, **Utilisateurs** et **SMS**. Cette page décrit l'onglet **Conversations**. L'onglet **Utilisateurs** regroupe l'ensemble de vos utilisateurs finaux ; l'onglet **SMS** concerne l'envoi de SMS. Ces deux onglets sont détaillés dans leurs pages dédiées. ### La pagination En bas de la liste, vous choisissez le nombre de conversations affichées par page (20 par défaut), et vous naviguez entre les pages. La mention *« affichage de X-Y sur Z »* rappelle votre position dans l'ensemble des résultats. *** ## 3. Ouvrir une conversation Cliquez sur une ligne pour ouvrir le **détail** de la conversation. L'écran se compose de deux zones : le fil de la conversation à gauche, et deux panneaux d'information à droite. ![Détail d'une conversation](https://3413274643-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLrHOdrzebY5DHcj61qXu%2Fuploads%2Fgit-blob-06e249feedab0707bbf93803eb0bccc74b73e7d3%2Fconversations-detail.png?alt=media) ### Le fil de conversation Le fil retrace l'échange dans l'ordre chronologique : * Les **messages de l'agent IA** apparaissent dans des bulles colorées. * Les **messages de l'utilisateur final** apparaissent dans des bulles grises. * Les **événements système** sont signalés en ligne, par exemple *« Ouverture du webchat »*, *« Ouverture du menu »*, ou l'auto-assignation d'une conversation à une équipe. * Lorsqu'une mise en relation a eu lieu, les messages de l'**agent humain** apparaissent également dans le fil. **Sur un agent vocal (téléphone)**, chaque message de l'utilisateur porte une icône de micro et un lien **Voir le message d'origine**, qui affiche la transcription brute de ce qui a été dit avant interprétation par l'agent. Les événements d'appel (ex. *« Appelle +… »*, *« Appel transféré vers… »*, *« Personne n'a répondu… »*, *« Raccroche »*) figurent aussi dans le fil. Lorsque l'appel a été enregistré, un **lecteur audio** s'affiche en haut du fil : une forme d'onde, un bouton **Jouer** et un bouton **Télécharger l'audio**, avec la durée de l'enregistrement. Chaque message du fil peut par ailleurs être réécouté individuellement via son bouton de lecture. Le sélecteur **Affichage** (ex. *« Messages uniquement »*) ajuste le niveau de détail affiché dans le fil. *** ## 4. Le panneau « À propos » Ce panneau résume les métadonnées de la conversation : * **Canal** — le support utilisé (ex. *Fenêtre de chat*, *Téléphone*). * **Durée** — le temps total de la conversation. * **Interactions** — le nombre de messages, avec la part traitée par l'IA. * **Commencée le / Finie le** — les horodatages de début et de fin. * **Voix** — la voix utilisée par l'agent (agents vocaux uniquement). * **Transcription** — le moteur de transcription utilisé (agents vocaux uniquement). > Les champs **Voix** et **Transcription** n'apparaissent que pour les agents vocaux (téléphone). *** ## 5. Le panneau « Conversation » Ce panneau donne à voir ce qui s'est joué « sous le capot » pendant l'échange. Il s'adresse à un usage plus analytique. ### Parcours joués La liste des **parcours** (déterministes) que l'agent a empruntés pendant la conversation, sous forme d'étiquettes (ex. *welcome*, *fallback*, *recherche de commande*, *escalade*). Elle vous permet de comprendre le chemin suivi par l'agent, étape par étape. La couleur des étiquettes distingue leur origine : en **vert**, les parcours créés spécifiquement pour votre agent ; en **bleu**, les parcours génériques mis à disposition par Yelda. ### Slots persistants Les **slots persistants** sont les variables retenues par l'agent au fil de la conversation (identifiants, statuts, valeurs calculées, données remontées d'un système tiers). Chaque slot affiche sa valeur, avec un bouton de copie et une info-bulle d'aide. Il s'agit d'une **zone de référence technique** : son contenu dépend entièrement de la configuration de votre agent et des intégrations en place. En pilotage courant, vous n'avez pas besoin d'agir dessus ; elle est utile pour diagnostiquer un comportement précis ou vérifier une donnée transmise. ### Metadata Selon la configuration de l'agent, le panneau peut aussi présenter un bloc **Metadata** : des données qualifiant la conversation (par exemple une thématique principale, une information manquante, ou une satisfaction perçue). Comme les slots, chaque métadonnée affiche sa valeur avec un bouton de copie et une info-bulle d'aide, et son contenu varie selon l'agent. *** ## 6. Les actions disponibles Depuis le détail d'une conversation, vous pouvez : * **Ouvrir un ticket de support** — pour signaler un problème lié à cette conversation au support Yelda. * **Copier le lien** — pour partager un accès direct à cette conversation. * **Naviguer** entre les conversations grâce aux flèches précédent / suivant, sans revenir à la liste. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.yelda.fr/pilotage/conversations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.