> 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/creer-du-contenu/styleguide/check-content-against-your-style-guide.md).

# Vérifier le contenu par rapport à votre guide de style

Relisez une page, une demande de modification ou des espaces entiers par rapport à votre guide de style avec GitBook Agent.

GitBook Agent suit votre guide de style chaque fois qu’il écrit ou modifie du contenu. Pour vérifier le contenu qui existe déjà, ou les modifications avant leur fusion, utilisez l’un des trois contrôles :

| Cochez                                                                                | Couvre                                             | Ce que fait l’Agent                                                 | À utiliser quand                                               |
| ------------------------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------- | -------------------------------------------------------------- |
| [Vérification de page](#check-a-page)                                                 | Une page                                           | Laisse des commentaires et ne modifie rien                          | Vous travaillez sur une page                                   |
| [Revue de demande de modification](#request-a-style-guide-review-on-a-change-request) | Les modifications dans une demande de modification | Demande des modifications et cite les règles enfreintes             | Vos modifications sont prêtes à être examinées                 |
| [Vérification du site](#run-a-style-guide-check-across-your-site)                     | Jusqu’à trois espaces à la fois                    | Corrige ce qu’il trouve dans une demande de modification par espace | Vous voulez que le contenu existant respecte le guide de style |

{% hint style="info" %}
Les vérifications utilisent GitBook AI, donc elle doit être activée pour votre organisation.
{% endhint %}

## Vérifier une page

Lorsque vous travaillez sur une page, utilisez **Vérifier la cohérence avec le guide de style** dans le menu **Améliorer** ou demandez à GitBook Agent dans le chat. L’Agent examine la page en fonction de votre guide de style et laisse des commentaires résumant ses conclusions. Il ne modifie pas la page.

## Demander une revue du guide de style sur une demande de modification

Lorsque votre site dispose d’un guide de style, GitBook Agent apparaît comme réviseur suggéré sur vos demandes de modification, avec l’étiquette **Vérification du guide de style**.

1. Dans votre demande de modification, cliquez sur **Demander un examen**.
2. Ajoutez un titre et une description à vos modifications, ou cliquez sur **Générer** pour que l’Agent les rédige.
3. Sous **Réviseurs**, cliquez sur **Demander** à côté de **GitBook Agent**. Vous pouvez ajouter d’autres réviseurs à ses côtés, ou laisser la liste vide pour avertir tous les réviseurs de votre organisation.

L’Agent examine vos modifications par rapport au guide de style. S’il trouve des infractions, il demande des modifications et cite la règle à l’origine de chacune.

## Lancez une vérification du guide de style sur l’ensemble de votre site

Une vérification du site examine chaque page des espaces que vous choisissez et corrige ce qu’elle trouve. Vous devez disposer des autorisations de modification sur le site et sur chaque espace que vous vérifiez.

1. Ouvrez votre guide de style, accédez à l’onglet **Vérifications** et cliquez sur **Lancer une vérification**.
2. Choisissez les espaces à vérifier. Vous pouvez vérifier jusqu’à trois espaces à la fois.
3. Examinez et fusionnez la demande de modification que GitBook Agent ouvre pour chaque espace.

Si une vérification corrige quelque chose, elle marque sa demande de modification comme prête pour examen. Si elle ne trouve rien, elle archive sa demande de modification, afin que vous ne vous retrouviez pas avec un brouillon vide.

L’onglet **Vérifications** répertorie les espaces de votre site selon sa structure, ainsi que l’état de la vérification de chaque espace :

* L’état de la demande de modification, ou un indicateur de chargement pendant l’exécution de la vérification
* Dernière exécution de la vérification
* Un badge **Guide de style modifié depuis** s’affiche lorsque vous avez modifié le guide de style après la vérification

Cliquez sur une ligne pour ouvrir sa demande de modification.

Chaque espace n’a qu’une seule demande de modification de vérification à la fois. Si vous relancez une vérification alors que la demande de modification d’un espace est toujours ouverte, l’Agent met à jour cette demande et vérifie les pages telles qu’elles sont maintenant. Une nouvelle demande de modification ne s’ouvre qu’après la fusion ou l’archivage de la précédente.

## Dépannage

### Une règle n’est pas signalée

GitBook Agent ne signale que les règles qu’il peut appliquer. Vérifiez que la règle :

* Possède un identifiant numéroté, ou est une instruction précise et vérifiable
* Ne contient plus de texte de remplacement
* N’a pas d’exception qui couvre ce texte

Si la règle se trouve sur une page autre que la première, l’Agent ne la lit que lorsqu’une tâche concerne le sujet de cette page. Placez les règles principales sur la première page.

### Les règles des instructions personnalisées ne sont pas appliquées dans les revues

GitBook Agent vérifie uniquement le style en se basant sur votre guide de style. Déplacez dans votre guide de style les règles de rédaction de vos instructions personnalisées que vous souhaitez faire signaler. Pour en savoir plus, consultez [Guides de style et instructions personnalisées](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/how-gitbook-agent-enforces-your-style-guide.md#style-guides-and-custom-instructions).

### Une revue ne montre que quelques problèmes

L’Agent vise environ cinq signalements par passage, en commençant par les plus importants. S’il existe d’autres problèmes, il en indique le nombre. Corrigez les problèmes signalés et demandez une autre revue pour voir le reste.


---

# 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/creer-du-contenu/styleguide/check-content-against-your-style-guide.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.
