> 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/agent-gitbook/write-and-edit-with-ai.md).

# Écrire avec GitBook Agent

Utilisez GitBook Agent pour générer et construire du contenu pour votre page

GitBook Agent est un outil puissant pour générer du contenu pour votre documentation dans GitBook.

L’agent peut tout faire, de la rédaction de courts passages de texte sur votre page à la modification de blocs existants, en passant par la création de nouvelles pages et bien plus encore dans le cadre d’une demande de modification.

{% hint style="info" %}

#### GitBook Agent suit votre guide de style

Définissez les règles rédactionnelles de votre équipe dans un [guide de style](https://gitbook.com/docs/documentation/fr/creer-du-contenu/styleguide.md), et l’Agent le considérera comme la référence à suivre chaque fois que vous lui demanderez de l’aide. Il charge la **première page** de votre guide de style dans son contexte pour chaque tâche : veillez donc à y inclure vos règles principales.

Vous pouvez également [ajouter de brèves instructions personnalisées](https://gitbook.com/docs/documentation/fr/agent-gitbook/overview.md#add-a-style-guide-and-custom-instructions) au niveau d’un site.
{% endhint %}

### Que peut faire GitBook Agent ?

GitBook Agent est profondément intégré à l’application GitBook, donc il comprend les blocs que vous pouvez créer dans l’éditeur, ainsi que le contenu plus large de votre section.

Cela signifie que vous pouvez utiliser l’Agent pour :

* Rédiger du nouveau contenu à partir de vos invites
* Rechercher dans les pages existantes et mettre à jour un contenu spécifique
* Reformater le contenu pour tirer le meilleur parti des différents blocs de GitBook
* Mettre à jour les exemples de code
* Déplacer du contenu entre les pages
* Ajouter de nouvelles pages à des emplacements précis

### Comment interagir avec GitBook Agent

Il existe plusieurs façons de travailler avec GitBook Agent :

* Ouvrez l’Agent depuis n’importe où dans GitBook et dites-lui ce dont vous avez besoin
* Planifiez et implémentez une nouvelle demande de modification avec GitBook Agent
* Mentionnez l’Agent dans un commentaire sur un bloc
* Créez du nouveau contenu sur une ligne vide de votre page

Passons en revue chacune de ces options pour voir comment elles fonctionnent.

#### Ouvrir GitBook Agent

GitBook Agent est disponible partout dans votre organisation, et pas seulement dans une demande de modification. Cliquez sur **Agent** dans l’angle inférieur droit de l’application pour ouvrir une nouvelle conversation. Celle-ci reste active lorsque vous passez d’une page à l’autre.

Une nouvelle conversation vous propose quelques invites pour commencer, comme **Que contient cet espace ?** ou **Repérer les contenus obsolètes**. GitBook Agent lit l’espace dans lequel vous vous trouvez et ouvre une demande de modification lorsque vous lui demandez d’effectuer des changements.

Chaque conversation s’ouvre dans un onglet, à côté du bouton **Agent** . Utilisez les boutons de l’en-tête de la conversation pour :

* **Ancrer comme panneau latéral :** garder l’Agent à l’écran pendant que vous travaillez
* **Réduire :** masquer la conversation et y revenir plus tard
* **Fermer :** fermer la conversation

Pour retrouver une ancienne conversation, cliquez sur l’icône de l’historique des conversations à côté du bouton **Agent** . Les conversations sont regroupées par date et vous pouvez les filtrer par nom.

GitBook Agent nomme chaque conversation pour vous. Pour en renommer une, cliquez sur son nom en haut de la conversation et saisissez un nouveau nom.

Vous pouvez également ouvrir l’Agent depuis l’éditeur. Sélectionnez du texte, commencez un bloc vide, utilisez **Améliorer** dans l’en-tête de la page ou utilisez les actions d’un commentaire. La conversation s’ouvre avec la page et votre sélection déjà jointes.

L’Agent fonctionne avec vos autorisations. Il lit ce que vous pouvez lire, et modifie et commente uniquement là où vous le pouvez.

Rédigez une invite à suivre pour l’Agent — il expliquera ce qu’il fait au fur et à mesure qu’il suit vos instructions, les modifications apparaissant dans votre section pendant qu’il travaille.

Vous pouvez donner des instructions de suivi ou préciser certaines étapes, ou modifier directement le contenu de votre section à tout moment, ce qui vous permet de travailler aux côtés de GitBook Agent.

#### Mettre en œuvre une demande de modification avec GitBook Agent

Cliquez sur **Modifier** dans l’en-tête de section pour ouvrir la boîte de dialogue de demande de modification.

Saisissez un **Titre** pour la demande de modification, puis décrivez les changements souhaités dans la **Description**. GitBook Agent utilise les deux.

Cliquez sur **Mettre en œuvre avec GitBook Agent**. GitBook crée la demande de modification et l’Agent commence à suivre vos instructions. À chaque étape, l’Agent vous explique ce qu’il fait dans la conversation.

Une fois terminé, vous pouvez modifier vous-même le contenu directement sur la page, ou donner à l’Agent d’autres instructions pour continuer à affiner vos modifications.

#### Mentionner GitBook Agent dans un commentaire

Si vous souhaitez que l’Agent examine un bloc précis de votre page, vous pouvez le mentionner dans un commentaire et lui expliquer ce dont vous avez besoin. Cliquez sur **Commenter le bloc** et mentionnez @gitbook pour identifier l’Agent, puis dites-lui ce que vous voulez qu’il fasse.

GitBook Agent mettra à jour le contenu en fonction de votre invite, puis répondra à votre commentaire pour vous dire ce qu’il a fait.

#### Améliorer le contenu de la page avec GitBook Agent

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-9e09b8690b432a41c9d3afcef8cdfdef1fd07eac%2F26_01_14_improve_page_actions.png?alt=media" alt=""><figcaption></figcaption></figure>

Le menu **Améliorer** propose plusieurs actions prédéfinies permettant à GitBook Agent d’améliorer le contenu de votre page.

Vous pouvez accéder au menu **Améliorer** depuis l’éditeur en passant le curseur sur le titre de la page, ou en ouvrant le menu **Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt=""></picture>.

Depuis le menu Améliorer, vous pouvez demander à l’Agent de :

* Ajouter une icône à la page
* Générer une description de page à partir de son contenu
* Corriger l’orthographe et la grammaire
* Réécrire pour assurer la cohérence avec les autres pages
* Optimiser pour le référencement
* Ajouter une section de résumé et prochaines étapes
* Ajouter des liens vers des sujets et des pages connexes
* Diviser la page unique en plusieurs pages

Les deux premières options sont conditionnelles — elles changent en fonction du contenu de votre page. Donc, si votre page a déjà une icône et une description, vous ne verrez pas ces choix dans le menu.

Cliquez sur n’importe quelle option et l’Agent se mettra immédiatement au travail sur votre tâche.

#### Créer du nouveau contenu dans un bloc vide

Vous pouvez utiliser GitBook Agent pour créer du contenu sur n’importe quelle ligne vide de votre page. Il peut créer toutes sortes de contenus — mis en forme en Markdown — y compris des exemples de code, des modèles, des résumés de page et bien plus encore.

Appuyez sur `Space` sur une ligne vide, ou saisissez `/` et choisissez **Écrire avec l’IA** pour lancer GitBook Agent.

Vous pouvez commencer à taper immédiatement n’importe quelle invite que vous voulez. GitBook Agent analysera l’invite et générera du contenu en fonction de celle-ci. Par exemple :

> Rédigez-moi un aperçu en deux paragraphes expliquant pourquoi la documentation est importante pour les équipes produit.

Vous pouvez aussi choisir l’une des invites suggérées ou l’un des amorces d’invite :

* **Continuer la rédaction** – GitBook Agent analysera le contenu de la page actuelle, puis générera du contenu supplémentaire à partir de celui-ci.
* **Expliquer…** – Choisissez cette option, puis indiquez à GitBook Agent ce que vous souhaitez qu’il explique. Cette option n’est pas limitée au contenu de votre page : vous pouvez lui demander d’expliquer absolument n’importe quoi.
* **Résumer** – Résumez tout le contenu de votre page. Cette option est idéale pour rédiger un TL;DR à la fin d’un document détaillé ou ajouter un bref résumé en haut de page, à l’intention des personnes qui veulent simplement se tenir au courant.
* **Expliquer ce contenu** – Cette option explique les informations complexes de votre page dans un langage plus simple, notamment les acronymes et autres termes spécialisés. Elle est idéale si la page que vous lisez contient beaucoup d’informations complexes ou si vous souhaitez ajouter des explications pour les personnes moins à l’aise avec les aspects techniques.
* **Traduire** – Traduisez la page actuelle dans l’une des langues proposées. Si la langue souhaitée ne figure pas dans la liste, saisissez-la simplement dans le champ de prompt.

### Rédigez des invites efficaces pour GitBook Agent <a href="#write-effective-prompts" id="write-effective-prompts"></a>

GitBook Agent est comme un coéquipier excellent pour suivre des instructions. Vous devez lui donner des instructions et un contexte clairs pour obtenir les meilleurs résultats.

Voici quelques conseils rapides pour rédiger de bonnes invites :

* **Décomposer** – L’Agent est plus efficace lorsqu’il s’agit de tâches ciblées. Décomposez les projets complexes en étapes plus petites et demandez à l’Agent de les réaliser une à la fois.
* **Soyez précis** – Les prompts génériques comme `@gitbook improve this page` appliquera les bonnes pratiques générales, mais sans consignes plus précises, l’Agent risque de ne pas atteindre l’objectif que vous aviez en tête.
* **Misez sur les résultats** – Si vous avez connaissance d’un problème précis rencontré par les clients, indiquez-le à l’Agent — ou précisez les résultats que vous souhaitez obtenir. Il vous proposera des améliorations en fonction de ces résultats.
* **Donnez des instructions précises** – Si vous voulez que l’Agent utilise un bloc Étapes pour créer un guide pas à pas, ou ajoute une FAQ avec plusieurs blocs dépliables, indiquez-lui précisément quoi faire pour obtenir le bon résultat dès la première fois.
* **Utilisez des demandes générales pour des améliorations plus larges** – Pour les tâches de maintenance, comme corriger des fautes de frappe, mettre à jour le nom d’une fonctionnalité sur plusieurs pages ou supprimer certains types de blocs de votre documentation, vous pouvez utiliser des commandes comme `@gitbook replace all instances of v2.3.9 with v2.4.0`.


---

# 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/agent-gitbook/write-and-edit-with-ai.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.
