Rédiger avec GitBook Agent

Utilisez GitBook Agent pour générer et créer 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 petites sections de texte sur votre page à la modification de blocs existants et à la création de nouvelles pages, sections et plus encore dans une demande de modification.

GitBook Agent suit votre guide de style

Vous pouvez ajoutez votre propre guide de style et vos instructions personnalisées au niveau du site — ainsi, l’Agent correspondra toujours à votre ton et à votre style chaque fois que vous lui demanderez de vous aider.

Que peut faire GitBook Agent ?

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

Cela signifie que vous pouvez utiliser l’Agent pour :

• Rédiger du nouveau contenu à partir de vos prompts

• 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 des exemples de code

• Déplacer du contenu entre les pages

• Ajouter de nouvelles pages à des emplacements spécifiques

Comment interagir avec GitBook Agent

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

• Ouvrez l’Agent dans une demande de modification existante et dites-lui ce dont vous avez besoin

• Planifier et mettre en œuvre une nouvelle demande de modification avec GitBook Agent

• Mentionnez l’Agent dans un commentaire sur un bloc

• Créer un nouveau contenu sur une ligne vide de votre page

Passons chacun de ces points en revue pour découvrir comment ils fonctionnent.

Ouvrir la fenêtre de discussion de GitBook Agent dans n’importe quelle demande de modification

Vous pouvez ouvrir la fenêtre de discussion de l’Agent dans une demande de modification à tout moment en cliquant sur le Agent GitBook bouton dans la barre d’en-tête de l’espace. Cela ouvrira la fenêtre de discussion de l’Agent à droite de l’application.

Ouvrir GitBook Agent dans une demande de modification

Ici, vous pouvez rédiger un prompt que l’Agent suivra — il expliquera ce qu’il fait au fur et à mesure qu’il suit vos instructions, et les changements apparaîtront dans votre espace au fur et à mesure.

Vous pouvez donner des instructions de suivi ou clarifier des étapes, ou modifier directement le contenu de votre espace à 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 le Agent GitBook section du Modifier bouton en haut à droite d’un espace pour ouvrir une fenêtre modale.

Ici, vous pouvez rédiger un prompt pour indiquer à l’Agent ce que vous souhaitez inclure dans votre demande de modification, puis ajouter des pages de référence qui pourraient être utiles comme contexte pour les changements.

Une fois que vous cliquez sur Démarrer la demande de modification l’Agent ouvrira une demande de modification pour vous et commencera à exécuter vos instructions. À chaque étape, l’Agent vous indiquera ce qu’il fait dans la fenêtre de discussion sur le côté droit de l’application.

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

Mentionner GitBook Agent dans un commentaire

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

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

Améliorer le contenu de la page avec GitBook Agent

La Améliorer le menu vous propose un choix de préréglages qui demandent à GitBook Agent d’effectuer des actions courantes pour améliorer le contenu de votre page.

Vous pouvez accéder au Améliorer menu depuis l’éditeur en survolant le titre de la page, ou en ouvrant le menu Actions .

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

• Ajouter une icône à la page

• Générer une description de la 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 (SEO)

• Ajouter une section de résumé et d’étapes suivantes

• Créer des liens vers les sujets et pages associés

• 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.

Sélectionnez 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 — formatés en Markdown — y compris des exemples de code, des modèles, des résumés de page et plus encore.

Appuyez sur Espace sur n’importe quelle ligne vide, ou tapez / et choisissez Écrire avec l’IA pour lancer GitBook Agent.

Vous pouvez commencer immédiatement à saisir le prompt de votre choix. GitBook Agent analysera le prompt et générera du contenu en conséquence. Par exemple :

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

Sinon, vous pouvez choisir parmi l’un des prompts suggérés ou des amorces de prompt :

• Continuer à écrire – GitBook Agent analysera le contenu de votre page actuelle puis générera davantage de contenu en fonction de celui-ci.

• Expliquer… – Choisissez cette option, puis dites à GitBook Agent ce que vous voulez qu’il explique. Cela n’est pas limité au contenu de votre page, vous pouvez donc lui demander d’expliquer n’importe quoi.

• Résumer – Résume tout le contenu de votre page. C’est idéal pour rédiger un TL;DR au bas d’un document détaillé, ou pour ajouter un bref résumé en haut pour les personnes qui le consultent rapidement.

• Expliquer ceci – Cela expliquera les informations complexes de votre page dans un langage plus simple — y compris l’explication des acronymes et autres jargon. C’est parfait si la page que vous lisez contient beaucoup d’informations complexes, ou si vous souhaitez ajouter une explication pour des personnes moins techniques.

• Traduire – Traduisez votre page actuelle dans l’une des langues proposées. Si vous souhaitez traduire vers une langue qui n’est pas dans la liste, saisissez simplement son nom dans la zone de prompt.

Rédiger des prompts efficaces pour GitBook Agent

GitBook Agent est comme un coéquipier très doué pour suivre des consignes. Vous devez lui donner des instructions claires et du contexte pour obtenir les meilleurs résultats.

Voici quelques conseils rapides pour rédiger de bons prompts :

• Décomposez la tâche – L’Agent est plus performant pour accomplir des tâches ciblées. Décomposez les projets complexes en étapes plus petites et demandez à l’Agent de les réaliser une par une.

• Soyez précis – Les prompts génériques comme @gitbook améliore cette page appliqueront les meilleures pratiques générales, mais sans indication plus précise l’Agent risque de ne pas atteindre l’objectif que vous aviez en tête.

• Concentrez-vous sur les résultats – Si vous entendez parler d’un problème précis rencontré par les clients, dites à l’Agent quels sont ces problèmes — ou les résultats que vous souhaitez obtenir. Il proposera des améliorations basées sur ces résultats.

• Donnez des instructions directes – Si vous souhaitez que l’Agent utilise un bloc stepper pour un guide étape par étape, ou ajoute une section FAQ avec plusieurs blocs repliables, dites-lui précisément quoi faire pour obtenir le bon résultat du premier coup.

• Utilisez des prompts larges pour des améliorations plus globales – 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 remplace toutes les occurrences de v2.3.9 par v2.4.0.