> 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/tableau-de-bord.md).

# Le tableau de bord

Le **tableau de bord** est votre vue d'ensemble du pilotage. Il agrège l'activité de votre agent sur une période donnée : volume d'échanges, part automatisée, comportement de l'IA, parcours les plus sollicités, et indicateurs personnalisés propres à votre projet.

Il se compose de deux zones :

* une zone **Résumé**, standard, commune à tous les agents ;
* une zone **Chiffres clés**, personnalisable, que l'on configure en fonction de l'agent et de vos besoins.

> 📷 *Illustration à venir — vue d'ensemble du tableau de bord.*

***

## 1. La zone Résumé

C'est la partie standard du tableau de bord. Ses libellés s'adaptent au canal de l'agent (chat ou téléphone), mais sa structure est la même pour tous vos agents.

### Les contrôles

En haut de la zone Résumé :

* **Période** — la fenêtre de temps analysée (ex. *Derniers 7 jours*, *Derniers 30 jours*, *Derniers 90 jours*).
* **Plateforme** — filtre l'affichage par canal (ex. *Toutes les plateformes*, *Téléphone*).
* **Vue** — sélectionne une **vue** du tableau de bord (ex. *Vue principale*). Une vue filtre le tableau de bord sur un **sous-ensemble de conversations** : vous pouvez par exemple créer une vue « heures non ouvrées », ou une vue distinguant les clients des non-clients. Chaque vue recalcule alors tous les indicateurs sur ce sous-ensemble.
* **Gérer les périodes** / **Gérer les vues** — permettent de créer et paramétrer vos propres périodes et vues.
* La date de dernière mise à jour des données est indiquée à côté des contrôles.

### Le graphique principal

Un graphique retrace l'activité sur la période, en distinguant deux catégories :

* **automatisée sans intervention humaine** ;
* **transférée vers un agent** humain.

Sur un agent de **chat**, ce bloc s'intitule **Conversations** (*Historique des conversations*) ; sur un agent **vocal**, il s'intitule **Appels** (*Historique des appels*).

### Les indicateurs de synthèse

Sous le graphique, une rangée d'indicateurs résume la période. Ils diffèrent selon le canal :

* **Agent de chat** : Utilisateurs uniques · Conversations · Durée moyenne d'une conversation · Messages par conversation.
* **Agent vocal** : Appelants uniques · Appels · Taux de réitération · Durée moyenne d'une conversation · Messages par conversation.

Une flèche à côté d'une valeur indique son évolution par rapport à la **période précédente de même durée** (par exemple, les 30 derniers jours comparés aux 30 jours d'avant).

Sur les agents vocaux, le **Taux de réitération** correspond à la part de personnes ayant **rappelé sur la période avec le même numéro**.

### Automatisation

Ce bloc mesure la part prise en charge par l'agent seul :

* **Taux d'automatisation** — pourcentage d'échanges gérés sans intervention humaine.
* **Automatisées sans intervention humaine** — le volume correspondant.
* **Mise en relation avec un agent** — les transferts vers un humain, répartis en **Succès** et **Échec** (avec leur pourcentage).

### Intelligence artificielle

Ce bloc décompose la façon dont l'agent a répondu :

* **Réponses par IA générative** — part des réponses produites par l'IA générative.
* **Réponses par IA déterministe** — part des réponses issues de parcours déterministes.
* **Durée moyenne d'une interaction avec l'IA**.

### Satisfaction

Quand les utilisateurs peuvent voter, une barre de **Satisfaction** répartit leurs retours selon une échelle d'émojis (du plus insatisfait au plus satisfait), avec le nombre pour chaque niveau. Le vote se fait via des boutons ; cette barre n'est donc disponible que sur les **agents de chat** pour le moment.

### Parcours populaires

La liste des **parcours les plus déclenchés** sur la période, avec le **nombre de requêtes** et la part (%) de chacun. Chaque parcours porte une étiquette indiquant son origine :

* **personnalisé** (vert) — parcours créé spécifiquement pour votre agent ;
* **intégré** (bleu) — parcours générique fourni par Yelda.

Le bouton **Voir plus** déploie la liste complète.

### Transferts d'appels (agents vocaux)

Sur un agent vocal, une section **Transferts d'appels** détaille les mises en relation. Selon la configuration, elle se présente :

* soit comme la liste des parcours populaires ayant conduit à un transfert ;
* soit comme un **tableau des destinations**, avec pour chaque destination : le nombre de transferts, le taux de décroché / non décroché, le temps d'attente moyen avant réponse, et la durée moyenne d'un appel transféré.

L'affichage sous forme de tableau ou de liste est un **choix de configuration**, selon le type de données à présenter.

***

## 2. La zone Chiffres clés

C'est la partie **personnalisable** du tableau de bord. Contrairement au Résumé, elle n'est pas standard : on y ajoute **autant de blocs de graphiques que souhaité**, configurés en fonction de l'agent et de vos besoins métier.

* Le bouton **Ajouter une métrique** crée un nouveau bloc.
* Chaque bloc a sa **propre période** (sélecteur en tête de la zone Chiffres clés).
* Chaque bloc s'appuie sur une **source de données** de votre agent, indiquée sous son titre — par exemple un **parcours** (*Parcours : …*), un **slot** (*Slot : …*) ou une **métadonnée** (*Metadata : …*).
* Selon la source, le bloc s'affiche sous différentes formes : un **chiffre global** accompagné d'un graphique, ou une **répartition** en valeurs (ex. les catégories d'un slot ou d'une métadonnée avec leur nombre d'occurrences).

Quand aucun bloc n'est configuré, la zone affiche *« Aucun graphique à afficher »*.

Comme cette zone dépend entièrement de la configuration de votre agent, son contenu varie d'un projet à l'autre. Elle est l'endroit où suivre les indicateurs spécifiques à votre activité (motifs de mise en relation, suivi d'un parcours métier, répartition d'une donnée collectée, etc.).

> 📷 *Illustration à venir — zone Chiffres clés avec des blocs personnalisés.*


---

# 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/tableau-de-bord.md?ask=<question>&goal=<endgoal>
```

`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.
