> 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/how-gitbook-agent-enforces-your-style-guide.md).

# Comment GitBook Agent applique votre guide de style

Comment GitBook Agent lit votre guide de style et applique ses règles lorsqu'il relit et modifie le contenu.

Quand GitBook Agent travaille avec votre guide de style, sa mission est de faire en sorte que le contenu respecte vos règles, et non d’améliorer l’écriture en général. Il est conçu pour être précis et conservateur, et son objectif est de faire ressortir les mêmes problèmes à chaque vérification du même contenu.

## Ce que lit l’Agent

* **La première page, pour chaque tâche.** L’Agent charge intégralement la première page de votre guide de style chaque fois qu’il rédige, modifie ou révise du contenu.
* **Les autres pages, au besoin.** Avant que l’Agent rédige ou révise du contenu couvert par une autre page, comme une liste de mots ou un type de contenu, il consulte cette page dans la table des matières.
* **Rien d’autre.** Votre guide de style est l’unique source de règles de l’Agent. Il n’applique pas les règles d’un guide de référence, celles issues de connaissances générales sur les bonnes pratiques rédactionnelles, ni celles d’un autre guide de style. Si votre guide de style indique qu’il s’appuie sur le guide de Google ou de Microsoft, l’Agent considère que cette référence est destinée aux personnes et non qu’elle contient des règles à appliquer.

Vos modifications priment toujours : modifiez une règle et l’Agent suit votre version ; supprimez une règle et l’Agent cesse de l’appliquer.

## Quelles règles l’Agent applique

La manière dont vous rédigez une règle détermine ce que l’Agent en fait :

| Ce que vous écrivez                               | Exemple                                       | Ce que fait l’Agent                                                                                                                                                                                                                   |
| ------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Une règle avec un identifiant numéroté            | `G-11`: Utilisez la virgule de série          | Signale les violations et cite l’identifiant. Les corrige lors de la modification.                                                                                                                                                    |
| Une règle explicite, vérifiable, sans identifiant | « N’utilisez jamais de point-virgule. »       | Signale les violations et cite la règle avec une courte citation. Les corrige lors de la modification.                                                                                                                                |
| Conseil                                           | Une description de votre voix et de votre ton | L’applique lors de la rédaction de nouveau contenu. Pour le contenu existant, la propose seulement comme suggestion, jamais comme signalement.                                                                                        |
| Une règle encore à l’état d’espace réservé        | `[Add a rule]`                                | L’ignore jusqu’à ce que vous remplaciez l’espace réservé. Si la majeure partie de votre guide de style est constituée d’espaces réservés, l’Agent vous indique que sa vérification ne couvre que les règles que vous avez finalisées. |

L’Agent respecte également les exceptions de chaque règle. Un texte qui relève d’une exception listée, comme « le passif est acceptable lorsque l’agent n’est pas connu », n’est pas une violation.

Pour rédiger des règles que l’Agent peut appliquer, consultez [Créer votre guide de style](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide/build-your-style-guide.md#write-rules-the-agent-can-enforce).

## Quand l’Agent examine

Lors d’une relecture, l’Agent signale les problèmes et ne modifie rien. Chaque signalement nomme la règle, l’emplacement du problème, ce qui ne va pas et la correction. Par exemple :

| Partie     | Exemple                                                                                        |
| ---------- | ---------------------------------------------------------------------------------------------- |
| Règle      | `G-10`: Utilisez la voix active                                                                |
| Location   | « Faites pivoter votre clé API » : « La clé est renouvelée par le système tous les 90 jours. » |
| Problème   | Voix passive alors que l’agent est connu.                                                      |
| Correction | « Le système fait pivoter la clé tous les 90 jours. »                                          |

L’Agent vise environ cinq signalements par passage, afin que les problèmes les plus importants apparaissent en premier. S’il existe d’autres problèmes, il le dit et en donne le nombre. Les signalements sont classés par catégorie, dans cet ordre : choix des mots et terminologie, mise en forme et ponctuation, grammaire, puis procédures. À l’intérieur d’une catégorie, ils suivent l’ordre des pages.

Le conseil n’apparaît jamais comme un signalement. À la place, l’Agent ajoute au plus une courte note « à faire relire par un humain » par passage.

## Quand l’Agent modifie

Lorsque vous demandez à l’Agent de corriger du contenu ou de l’aligner sur votre guide de style, il applique une règle chaque fois que la correction est sans ambiguïté. Lorsqu’une règle admet deux issues raisonnables, l’Agent laisse le texte inchangé et le répertorie comme suggestion.

Après la modification, l’Agent résume ses changements par règle, avec des comptes. Par exemple : « G-7 : remplacé « click on » par « click », 6 occurrences. » Les suggestions fondées sur le conseil apparaissent dans une courte liste à la fin.

## Ce que l’Agent ne modifie jamais

Dans les relectures comme dans les modifications, l’Agent ne signale ni ne modifie jamais :

* Le contenu des blocs de code, du code en ligne, des sorties de commande ou des identifiants d’API et de produit
* Les citations directes et les éléments cités
* Texte exempté par l’exception d’une règle
* Le sens ou les faits de votre contenu

L’Agent applique les règles telles qu’elles sont rédigées. Il ne les adoucit pas, ne les renforce pas et ne les réinterprète pas pour s’adapter au contenu. Si une règle est ambiguë, l’Agent l’applique au sens littéral et mentionne l’ambiguïté dans sa note « à faire relire par un humain ».

## Sans guide de style

Si votre site n’a pas de guide de style, l’Agent ne procède pas à une relecture stylistique. Pour les demandes de modification, il ne commente que les problèmes clairs et objectifs, tels que les fautes de frappe, les contradictions, les instructions incorrectes ou les sections inachevées.

## Guides de style et instructions personnalisées

Les instructions personnalisées sont de courtes consignes spécifiques à un site pour GitBook Agent. Un guide de style est un ensemble complet et partagé de règles de rédaction. L’Agent utilise les deux, et s’ils entrent en conflit, le guide de style l’emporte.

Placez les règles de rédaction que vous souhaitez faire appliquer dans votre guide de style. Utilisez les instructions personnalisées pour d’autres consignes, comme la manière d’ajouter des liens ou les types de blocs à éviter.


---

# 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/how-gitbook-agent-enforces-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.
