> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tableaux de bord en langage naturel

> Transformez une question analytique en langage courant en insights de tableau de bord prêts à être vérifiés

Les tableaux de bord en langage naturel vous permettent de décrire une vue analytique en langage courant. Famulor prépare un aperçu, et rien n’est ajouté à votre tableau de bord tant que vous ne l’avez pas confirmé.

## Construire une vue de tableau de bord

1. Ouvrez un [tableau de bord personnalisé](/fr/analytics/custom-dashboards).
2. Sélectionnez **Create with Milian**.
3. Décrivez les métriques, la période, la comparaison et les filtres dont vous avez besoin.
4. Sélectionnez **Preview insights** et vérifiez chaque carte proposée.
5. Sélectionnez **Add insights** pour enregistrer les cartes.

Par exemple :

> Affiche le taux de réussite et la durée moyenne des appels sortants des 30 derniers jours.

Les cartes générées fonctionnent comme des [widgets de tableau de bord](/fr/analytics/dashboard-widgets) créés manuellement. Vous pouvez ensuite les modifier, les redimensionner, les réordonner ou les supprimer.

## Questions prises en charge

Vous pouvez interroger le volume de conversations, l’activité dans le temps, le taux de réussite, la durée des appels, la performance des assistants et des campagnes, les résultats, le statut, le sens, le sentiment et les conversations récentes. Les périodes prises en charge sont 7, 14, 30 et 90 jours, avec une comparaison facultative à la période précédente.

Les filtres utilisent les valeurs disponibles dans Famulor. Si une demande ne peut pas être représentée, l’aperçu explique ce qu’il faut modifier plutôt que d’ajouter un résultat incertain.

<Note>
  Les tableaux de bord utilisent toujours les données de l’espace de travail actif. Vérifiez chaque carte proposée avant de l’ajouter, en particulier lorsque votre question contient plusieurs filtres.
</Note>

## API publique

Utilisez `POST /api/v1/dashboards/{id}/natural-language` pour générer un aperçu. Envoyez le plan renvoyé à `PUT /api/v1/dashboards/{id}/natural-language` pour le valider et enregistrer ses widgets.

Les deux opérations nécessitent la portée `dashboards:write`. Consultez la référence de l’API pour le schéma complet des requêtes et des réponses.
