> 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/content-gaps.md).

# Lacunes de contenu

Trouvez les questions auxquelles votre documentation ne répond pas, classées par gravité, et comblez-les avec GitBook Agent

{% hint style="info" %}
Les lacunes de contenu sont en version bêta et disponibles avec le forfait de site Ultimate.
{% endhint %}

Les lacunes de contenu vous montrent ce que votre documentation ne répond pas. GitBook analyse les questions que les visiteurs posent dans votre documentation, ainsi que les tickets d’assistance, les e-mails, les forums et d’autres enregistrements provenant des sources que vous avez connectées. Une fois par jour, il compare ces questions à votre contenu, identifie celles auxquelles votre documentation ne répond pas et les classe par ordre de gravité.

À partir de n’importe quel écart, GitBook Agent peut ouvrir une demande de modification qui le comble.

Dans la barre latérale de votre site, accédez à **Améliorer → Lacunes de contenu**.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-489320e17f7eef5f995911b381ba4de6ea54d1af%2Fcontent-gaps.png?alt=media" alt="The Content gaps screen showing summary tiles, the filter row, and a list of gaps with their topics and evidence counts"><figcaption></figcaption></figure>

Quatre vignettes en haut indiquent combien d’écarts GitBook a trouvés, combien sont de gravité élevée, combien de demandes de changement ont été fusionnées à partir d’écarts, et quelle source contribue le plus.

## Ce que GitBook détecte

GitBook signale quatre types de problème :

* **Lacunes de contenu** apparaissent lorsque GitBook constate que vos clients posent des questions sur votre produit auxquelles la documentation peine à répondre, par exemple :
  * Un client posant une question à votre équipe d’assistance qu’il n’a pas trouvée dans la documentation.
  * Un point de terminaison d’API dont la documentation est incomplète.
* **Contenu obsolète** est détecté lorsque le contenu de votre page a été remplacé par des informations trouvées dans une source externe, par exemple :
  * Une mise à jour du SDK qui a modifié la signature d’une fonction.
  * Une fonctionnalité payante passée au niveau gratuit, sans mise à jour de la documentation.
* **Contenu inexact** est signalé lorsque le contenu du site de documentation est manifestement erroné, par exemple :
  * Un guide renvoyant vers des API qui n’existent plus, ou dont la fonctionnalité a été abandonnée.
  * Des sources externes, comme votre site marketing, qui sont en désaccord avec la documentation.
* **Autre** regroupe les problèmes qui ne correspondent à aucune des catégories ci-dessus.

## Fonctionnement

{% stepper %}
{% step %}

#### Connectez vos sources

GitBook repère davantage de lacunes lorsqu’il peut comparer votre documentation aux endroits où vos clients posent déjà leurs questions : votre système de gestion des tickets d’assistance, vos forums publics ou votre site marketing. Certaines sources nécessitent une clé API ou une authentification supplémentaire avant la fin de la configuration. [En savoir plus sur les connexions.](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/connections.md)
{% endstep %}

{% step %}

#### GitBook analyse chaque jour

GitBook examine vos sources une fois par jour et compare ce qu’il trouve à votre contenu publié. Chaque question à laquelle votre documentation ne répond pas devient un écart.
{% endstep %}

{% step %}

#### Examinez les écarts

Chaque lacune décrit le problème, les preuves qui le sous-tendent, et une recommandation pour le corriger. Triez par gravité pour trouver d’abord les lacunes qui valent la peine d’être corrigées.
{% endstep %}

{% step %}

#### Combler ou rejeter

Comblez une lacune en créant une [demande de modification](https://gitbook.com/docs/documentation/fr/collaborate/change-requests.md) à partir de celle-ci, ou rejetez celles auxquelles vous ne souhaitez pas donner suite. GitBook ne rouvrira pas une lacune que vous avez rejetée.
{% endstep %}
{% endstepper %}

## Filtrer la liste

Un site avec un vaste catalogue d’archives peut faire apparaître des milliers de lacunes d’un coup. Filtrez la liste pour trouver celles qui valent la peine d’être traitées :

| Filtrer       | Options                                                       | À utiliser pour                                                                                                                                                                                        |
| ------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Statut        | **Ouvert**, **Modifié**, **Rejeté**, **Résolu**               | Séparez les lacunes intactes de celles déjà couvertes par une demande de changement, des suggestions que votre équipe a rejetées, et de celles qu’une demande de changement fusionnée a déjà résolues. |
| Gravité       | **Élevée**, **Moyenne**, **Faible**                           | Traitez d’abord les lacunes à plus fort impact.                                                                                                                                                        |
| Date          | **7 derniers jours**, **30 derniers jours**                   | Voyez ce qu’une version récente ou un pic de support a fait ressortir.                                                                                                                                 |
| Sujet         | N’importe quel sujet sur votre site                           | Concentrez-vous sur une zone de votre documentation. Les sujets sont regroupés de la même manière que dans le rapport de l’Assistant IA.                                                               |
| Type          | lacune de contenu, contenu obsolète, contenu incorrect, autre | Séparez la documentation manquante de la documentation qui a déraillé.                                                                                                                                 |
| Source        | N’importe quelle source connectée                             | Vérifiez ce qu’une source unique signale, comme les lacunes que seul Intercom voit.                                                                                                                    |
| Agent GitBook | Pris en charge, non pris en charge                            | Trouvez les lacunes dont personne ne s’est encore occupé.                                                                                                                                              |

Triez la liste filtrée par gravité pour faire remonter en tête les écarts les plus dommageables.

Le rejet d’une lacune indique que votre équipe a examiné la suggestion et décidé de ne pas y donner suite. Elle n’apparaît alors plus dans la liste des lacunes ouvertes, sans que la décision soit masquée. Filtrez par **Résolu** pour trouver les lacunes déjà comblées par une demande de modification fusionnée.

## Examiner une lacune

L’examen d’un écart suit toujours le même parcours :

1. Sur la page Lacunes de contenu, filtrez la liste pour afficher les lacunes sur lesquelles vous souhaitez travailler.
2. Cliquez sur une lacune pour l’ouvrir.
3. Lisez le **Problème**, **Éléments de preuve**, et la **Recommandation** pour déterminer si la lacune est réelle et mérite d’être comblée.
4. Ouvrez les enregistrements source liés pour vérifier vous-même les preuves.
5. Cliquez sur **Créer une ou plusieurs demandes de modification**, ou sur **Rejeter** si la lacune ne mérite pas d’être comblée.
6. Examinez la demande de changement que GitBook Agent rédige, puis fusionnez-la.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-42b4c70f8e2337ff35332e9dec1383df4bf35e2f%2F25_03_30_site_findings%402x.png?alt=media" alt="A single content gap showing its status, severity, type, and topic, with Reject and Create change request actions above the motivation"><figcaption></figcaption></figure>

### Ce qu’une lacune montre

Une lacune s’ouvre avec son nom, son statut, son niveau de gravité, son type et son sujet. Le statut est un menu déroulant : vous pouvez donc le modifier sans quitter la lacune. En dessous, une section **Motivation** présente les arguments en trois parties :

* **Problème** décrit ce que la documentation n’explique pas et les conséquences pour le lecteur.
* **Éléments de preuve** présente les résultats de l’analyse de GitBook : les pages qui traitent actuellement du sujet, ce qu’elles omettent et ce que révèlent les sources sur les questions posées.
* **Recommandation** propose le contenu à rédiger et son emplacement, ainsi que les pages depuis lesquelles y créer un lien.

Sous la motivation, GitBook liste les enregistrements source sur lesquels repose le constat — les conversations d’assistance, discussions ou pages individuelles, chacune liée afin que vous puissiez ouvrir l’original et le lire intégralement.

{% hint style="info" %}
Les données des sources n’apparaissent que pour les sources que vous avez connectées. Une lacune relevée dans des conversations avec l’assistance n’affiche ces conversations que si la plateforme d’assistance correspondante est connectée. Consultez [Connexions](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/connections.md) pour en configurer une.
{% endhint %}

### Créer une demande de changement à partir d’une lacune

Lorsqu’une lacune peut être corrigée automatiquement, une bannière indique que le constat peut être résolu dans des demandes de changement, et propose deux actions.

Cliquez sur **Créer une ou plusieurs demandes de modification** pour transmettre le manque à GitBook Agent. L’Agent analyse le constat et les pages qu’il mentionne, puis prépare une modification. Un manque peut donner lieu à plusieurs demandes de modification si sa résolution concerne plusieurs pages.

L’écran affiche la progression du travail de l’Agent, puis répertorie les éléments produits avec un lien pour examiner chacun d’eux. À partir de là, ils fonctionnent comme n’importe quelle autre [demande de modification](https://gitbook.com/docs/documentation/fr/collaborate/change-requests.md)  : vous voyez précisément le contenu modifié, et vos règles habituelles de révision et de fusion s’appliquent. Consultez [Examiner les demandes de modification avec GitBook Agent](https://gitbook.com/docs/documentation/fr/agent-gitbook/review-change-requests-with-gitbook-agent.md) pour savoir comment l’Agent peut vous aider à la réviser.

La fusion de la demande de modification résout le manque et le retire de la file d’attente. Filtrez par **Résolu** pour le retrouver.

### Rejeter une lacune

Cliquez sur **Rejeter** lorsqu’il ne vaut pas la peine de combler un manque : la question est hors sujet, la page y répond déjà ou le constat interprète mal les éléments disponibles. Le rejet retire le manque de la liste des éléments ouverts, et GitBook ne le rouvrira pas.

{% hint style="info" %}
Modifier le statut d’une lacune, y compris la rejeter, nécessite des autorisations de modification sur le site. Les actions que vous ne pouvez pas utiliser apparaissent grisées, avec une explication.
{% endhint %}

## Travaillez sur les lacunes depuis votre propre agent

Tout ce qui figure sur la page « Lacunes de contenu » est également accessible via l’ [API GitBook](https://gitbook.com/docs/developers/gitbook-api/api-reference) et le [serveur MCP GitBook](https://gitbook.com/docs/documentation/fr/docs-as-code/gitbook-mcp.md), ce qui permet à votre propre agent ou script de traiter les manques en dehors de l’application GitBook. Votre agent ou script peut effectuer les opérations suivantes :

* Lister les lacunes d’un site et lire les éléments de preuve derrière chacune : les enregistrements sources, les questions de l’Assistant IA et les pages concernées.
* Résoudre, rejeter ou rouvrir une lacune.
* Demander à GitBook Agent de corriger un manque en générant une demande de modification, comme le fait **Créer une ou plusieurs demandes de modification** dans l’application.
* Associer au manque une demande de modification que vous avez rédigée vous-même, en définissant son `siteFindingId`. Lorsque toutes les demandes de modification associées au manque sont fusionnées, celui-ci est résolu.

## Paramètres

Sur la page « Lacunes de contenu », cliquez sur **Paramètres** pour voir les sources analysées par GitBook et les éléments apportés par chacune.

### Sources

La liste des **Sources** répertorie chaque connexion qui ingère des données, les éléments qu’elle a analysés et le nombre de manques qui en proviennent. Chaque source indique ses données dans ses propres unités : pages pour un site Web, vidéos pour une chaîne YouTube, discussions pour GitHub Discussions et conversations pour une plateforme d’assistance.

Votre documentation constitue une source à part entière. **L’assistant IA** signale à la fois les questions restées sans réponse posées par les visiteurs sur votre site et les manques qui en découlent. Consultez le [Assistant IA](https://gitbook.com/docs/documentation/fr/analytics/insights/ai-insights.md) rapport pour examiner ces questions en détail.

Chaque source apparaît sous l’étiquette que vous avez donnée à la connexion, donc deux connexions de site web s’affichent séparément plutôt que d’être fusionnées en une seule entrée.

Cliquez sur **Afficher les lacunes de contenu** sur n’importe quelle source pour filtrer la liste et n’afficher que les manques qui en proviennent.

### Connexions

La section **Connexions** répertorie les sources que vous n’avez pas encore connectées, comme Zendesk, Freshdesk, Front, HubSpot, Zoho Desk, Pylon, GitHub Issues et un serveur MCP.

Cliquez sur **Gérer les connexions** pour ouvrir la page « Connexions », où vous pouvez ajouter une source, vérifier l’état de la synchronisation et le nombre d’enregistrements, définir le classement des résultats de recherche et parcourir les enregistrements individuels ingérés par GitBook. Consultez [Connexions](https://gitbook.com/docs/documentation/fr/ai-for-your-readers/connections.md) pour savoir ce que chaque connecteur indexe et comment le configurer.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/analytics/content-gaps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
