> For the complete documentation index, see [llms.txt](https://docs.praiz.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.praiz.io/interroger-et-analyser/insights.md).

# Insights

Analysez l'ensemble de vos conversations à partir de la donnée extraite par un agent.

Vous choisissez l'agent, la période et le contexte de l'analyse. Praiz génère un rapport à partir de toutes les données extraites par cet agent. Par exemple : les objections les plus fréquentes, les concurrents les plus cités, ou n'importe quelle autre analyse selon les champs de l'agent.

{% hint style="info" %}
Prérequis : un agent appliqué à au moins 3 appels. Les Insights portent sur la donnée extraite par cet agent.
{% endhint %}

## Créer un rapport

Ouvrez « Insights » dans le menu de gauche. Chaque rapport est dans un onglet. Cliquez sur « + » pour créer un onglet, ou ouvrez un onglet existant.

![Page Insights avec les onglets de rapports et les réglages](https://3785996597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU54oKzNb3EyinriyUP5P%2Fuploads%2FQcvx8JEZrOGSQ5mdPJIK%2F26-insights-top.png?alt=media)

{% stepper %}
{% step %}

### Agent

Dans « Select an agent », choisissez l'agent dont vous voulez analyser la donnée.

{% hint style="info" %}
La génération demande au moins 3 lignes de données pour cet agent (« Generate Insights requires at least 3 rows in Agent data »).
{% endhint %}
{% endstep %}

{% step %}

### Période

Sélectionnez la plage à couvrir : semaine, mois, trimestre, ou plage personnalisée.
{% endstep %}

{% step %}

### Filtres (optionnel)

Restreignez l'analyse à une partie de vos appels : personnes, équipes, ligne Aircall utilisée pour appeler, ou valeur d'un champ extrait par l'agent.

Le nombre d'appels qui correspondent à vos filtres s'affiche dès que vous changez un filtre, avant de lancer le rapport. Vos filtres sont conservés quand vous relancez le rapport.
{% endstep %}

{% step %}

### Configurer

Cliquez sur « Configure Insights » pour définir les réglages du rapport : langue, longueur, affichage des graphiques et des emojis, et un contexte libre pour orienter l'analyse (« Context for AI »). Le contexte saisi est conservé après la génération : vous pouvez relancer le rapport sans le ressaisir.

![Fenêtre Configure Insights avec les réglages du rapport](https://3785996597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU54oKzNb3EyinriyUP5P%2Fuploads%2Fke71Ly6SYoFdUW6OsUL4%2F27-insights-settings.png?alt=media)
{% endstep %}

{% step %}

### Générer

Cliquez sur « Generate Insights ».
{% endstep %}
{% endstepper %}

Résultat attendu : le rapport est affiché dans l'onglet. Vous pouvez le lire, le copier (« Copy ») ou le télécharger en PDF (« Download as PDF »). Quand le rapport cite un appel, le lien ouvre directement l'enregistrement. Les onglets sont conservés : vous gardez plusieurs analyses côte à côte, et lancer un second rapport n'interrompt pas la génération du premier.

## Exporter la donnée brute de l'agent

Sous le rapport, la page liste toutes les données extraites par l'agent sur la période, appel par appel (30 enregistrements par page, boutons « Previous » et « Next »). Cliquez sur « Download CSV » en bas de la page pour télécharger toute cette donnée brute au format CSV.

![Bouton Download CSV sous la liste des données de l'agent](https://3785996597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU54oKzNb3EyinriyUP5P%2Fuploads%2FOifDqymQOXRaUU9IyFJi%2F29-insights-download-csv.png?alt=media)

## Exemples d'analyses

| Question                                      | Ce que les Insights vous montrent                                |
| --------------------------------------------- | ---------------------------------------------------------------- |
| Quelles objections reviennent le plus ?       | Les objections les plus fréquentes, et leur évolution            |
| Quel concurrent nous coûte le plus de deals ? | La pression concurrentielle mesurée sur toutes vos conversations |
| Que demandent nos clients ?                   | Les retours produit consolidés, par thème et par fréquence       |
| Où sont nos risques clients ?                 | Les signaux de churn détectés sur le portefeuille                |

## Recevoir le rapport automatiquement

Cliquez sur « Schedule recurring insights » pour programmer le rapport. Praiz le génère et l'envoie par email ou sur Slack, à la fréquence de votre choix. Voir [Recurring Insights](/automatiser/recurring-insights.md).

## Insights ou Analytics

Les Insights portent sur le contenu des conversations. La page [Analytics](/interroger-et-analyser/analytics.md) porte sur l'usage de Praiz : durée et nombre d'appels, part visio et téléphonie, utilisateurs actifs, tendance mensuelle et usage par utilisateur, avec export CSV.

## Aller plus loin

Pour interroger votre base de données conversationnelle depuis Claude, ChatGPT ou Gemini, voir [Serveur MCP](/interroger-et-analyser/serveur-mcp.md).