> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/analytics/insights/ai-insights.md).
# Assistant IA
Voyez ce que vos visiteurs demandent à GitBook Assistant, dans quelle mesure votre contenu y répond, et où votre documentation montre des lacunes
La **Assistant IA** Le rapport montre ce que vos visiteurs demandent et avec quelle efficacité [Assistant GitBook](/docs/documentation/fr/ai-for-your-readers/gitbook-ai-assistant.md) y répond en utilisant votre contenu.
Pour l’ouvrir, allez à **Analyser → Assistant IA** dans la barre latérale de votre site.
Quatre métriques résument la période que vous avez sélectionnée :
* **Questions posées**: les questions que les visiteurs posent à l’Assistant.
* **Répondues**: la part des questions résolues par l’Assistant.
* **Utile**: la façon dont les visiteurs ont évalué les réponses obtenues.
* **Économies**: l’effort de support estimé évité en répondant à ces questions.
Voir [Statistiques du site](/docs/documentation/fr/analytics/insights.md) pour les filtres, les périodes et la comparaison des périodes.
Le rapport de l’Assistant IA.
## Sujets
GitBook regroupe les questions en **sujets**, afin que vous puissiez lire ce que vos visiteurs veulent au niveau d’un sujet plutôt qu’une question à la fois. Chaque sujet montre son évolution au fil du temps et la part de votre trafic qu’il représente.
Cliquez sur un sujet pour ouvrir sa vue détaillée et voir toutes les questions qu’il contient, regroupées par **Type** ou **Récence**. Servez-vous-en pour examiner les besoins récurrents, repérer les lacunes de la documentation et comprendre si votre site répond avec succès aux questions dans ce domaine.
## Répartitions
Trois cartes répartissent la période selon **Répondues** (si la réponse a résolu la question), **Catégories** (le type de question posée), et **Canaux** (où l’Assistant a été utilisé : votre site, le [Intégration Docs](/docs/documentation/fr/publish/embedding.md), ou un outil connecté). Cliquez sur une valeur pour filtrer l’ensemble du rapport selon celle-ci.
## Questions
La **Questions** carte répertorie chaque question posée à l’Assistant. Cliquez sur l’une d’elles pour voir comment GitBook l’a traitée et quel contenu a appuyé la réponse.
En haut de la vue détaillée, vous pouvez consulter la question elle-même, la fréquence à laquelle les visiteurs l’ont posée, son type et les sujets auxquels elle appartient.
### Conversations et qualité des réponses
Sous le résumé, vous pouvez consulter les conversations liées à la question et voir si GitBook y a répondu entièrement, partiellement ou pas du tout. Le panneau de conversation affiche également l’échange complet avec l’assistant, y compris les éventuelles questions de suivi et les réponses.
### Sources et contexte
La section des sources indique quelles pages, enregistrements ou [contenus liés](/docs/documentation/fr/ai-for-your-readers/connections.md) GitBook a utilisé pour répondre à la question. Servez-vous-en pour vérifier que l’IA s’est appuyée sur le bon contenu — et pour trouver les endroits où des pages pertinentes existent, mais n’ont pas été mises en avant.
### Exporter les questions et réponses
Depuis la carte Questions, cliquez sur **Exporter en CSV** et choisissez ce que vous souhaitez télécharger :
* **Résumé des questions**: une ligne par question, avec ses totaux.
* **Détails des réponses**: une ligne par réponse, avec ses sujets, sa résolution, son utilité, sa pertinence, les retours par pouce, le canal et la langue. Servez-vous-en pour voir ce que l’Assistant a répondu et si la réponse a porté ses fruits.
## FAQ
Comment utiliser le rapport de l’Assistant IA ?
Il donne à votre équipe un aperçu de la manière dont les visiteurs interagissent avec votre documentation lorsqu’ils cherchent des réponses.
Le filtrage du rapport vous aide à identifier les lacunes de contenu. Vous pouvez filtrer selon les éléments suivants :
* Les questions que les visiteurs posent le plus souvent
* Questions que les visiteurs recherchent et qui n’ont pas de réponse
* Sujets que votre documentation ne couvre pas
Combler ces lacunes aide les visiteurs à trouver des réponses plus rapidement — et à comprendre votre produit plus vite.
{% hint style="info" %}
[Lacunes de contenu](/docs/documentation/fr/analytics/content-gaps.md) regroupe ces lacunes dans une liste classée, et GitBook Agent peut ouvrir une demande de modification pour en combler une.
{% endhint %}
Comment les « Économies » sont-elles calculées ?
C’est une estimation, fondée sur l’hypothèse qu’une question résolue sur cinq serait autrement devenue un ticket de support. Un administrateur de l’organisation peut définir le coût d’un ticket de support, ou d’une heure de support, via l’API afin que l’estimation reflète votre équipe. Considérez-la comme un ordre de grandeur plutôt que comme une valeur exacte.
---
# 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://gitbook.com/docs/documentation/fr/analytics/insights/ai-insights.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.
