> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/actions/playbooks.md). # Playbooks Créez et exécutez des Playbooks à l'aide d'instructions en langage naturel Les Playbooks vous permettent de décrire le travail sous forme d’instructions en langage naturel, d’y associer un contexte comme un Brand Kit, et d’exécuter le processus de bout en bout tout en tenant les réviseurs informés. {% hint style="warning" %} Les Playbooks ne peuvent pas être utilisés à l’intérieur des Workflows. Vous pouvez créer un Playbook à partir d’un Workflow existant, mais vous ne pouvez pas ajouter un Playbook en tant qu’étape de Workflow. {% endhint %} Un Playbook se compose de : * **Un Playbook de type document** qui décrit ce que l’agent doit faire. * **Entrées** que le Playbook accepte au moment de l’exécution, comme du texte, des nombres, des fichiers ou un Brand Kit. * **Sections** qui contiennent des instructions, des appels d’outils et des points de contrôle de Revue humaine. * **Outils** que l’agent peut utiliser, notamment la recherche SEO, la recherche web, l’image et la vidéo, les connecteurs MCP, et plus encore. * **Artefacts** que le Playbook produit, comme des fichiers Markdown, HTML, JSON, CSV, PNG, JPG ou GIF. * **Déclencheurs** qui déterminent comment un Playbook démarre, y compris Planification, Webhook, Surveillance et AEO Insight lorsque cette option est activée. ## Concepts clés | Terme | Définition | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Playbook | La définition de l’agent avec des Entrées, des Sections, des Outils, des Artefacts et un Déclencheur. L’exécution d’un Playbook produit une Session. | | Section | Une unité de travail dans un Playbook. Chaque Section peut inclure des instructions, des appels d’outils et un bloc de Revue humaine. | | Entrée | Informations que vous fournissez lorsqu’un Playbook s’exécute, comme un mot-clé, une URL cible, un fichier importé ou un Brand Kit. | | Outil | Une action que l’agent peut effectuer, de la recherche web et SEO aux outils natifs comme Slack et aux outils fournis par les connecteurs MCP. | | Artefact | Une sortie persistante produite par le Playbook, comme un article de blog, une image, une analyse ou des données structurées. | | Déclencheur | Une condition qui lance automatiquement un Playbook. Les types de déclenchement incluent Planification, Webhook, Surveillance et AEO Insight lorsque cette option est activée. | | Session | Une exécution unique de Playbook. Chaque Session produit des Artefacts et consigne le travail effectué par l’agent. | | Boîte de réception | La file d’attente au niveau de l’espace de travail où les réviseurs voient les étapes de Revue humaine en attente et les résultats des Sessions nécessitant une attention particulière. | | Historique des exécutions | L’enregistrement de chaque Session produite par un Playbook. | | Revue humaine | Un point d’arrêt où une personne doit approuver ou modifier le travail de l’agent avant qu’il ne continue. | | Quill | Le capitaine agent d’AirOps qui vous aide à créer et modifier des Playbooks à partir d’instructions en langage naturel. Voir [Quill](/docs/fr/quill.md). | | Mémoire | La persistance entre les Sessions, utilisée lorsqu’un Playbook doit se souvenir de ce qu’il a déjà mis en évidence ou accompli. | ## Les deux sources de contexte qui pilotent la qualité Avant de créer un Playbook, assurez-vous qu’AirOps Insights et votre Brand Kit sont à jour. Ces deux sources de contexte façonnent la qualité de chaque Session. ### Configurer AirOps Insights AirOps Insights est la source des données de visibilité dans la recherche IA, notamment les prompts suivis, les réponses de recherche LLM, les citations, la présence des concurrents et les opportunités de contenu. Lorsqu’un Playbook recherche des opportunités AEO ou des réponses de recherche LLM, il doit utiliser les données suivies dans AirOps Insights plutôt que de traiter la recherche IA comme une simple recherche web générique. Couvrez les thèmes, personas, régions et étapes du funnel qui vous importent. Étendez la couverture à partir de sources comme les requêtes de Google Search Console, le langage des appels commerciaux, les tickets de support et les écarts de citations des concurrents. Le schéma courant est le suivant : AirOps Insights suit les prompts et les réponses de recherche LLM, un Playbook surveille ces données et identifie des opportunités, puis un second Playbook passe à l’action et crée ou actualise le résultat. ### Maintenir votre Brand Kit à jour Chaque Playbook peut hériter de votre Brand Kit, de sorte que les modifications de ton, de règles de rédaction, d’audiences, de régions, de gammes de produits, de directives visuelles et de contexte concurrentiel se répercutent sur la sortie du Playbook. Un Brand Kit obsolète dégrade la qualité des résultats en aval. Auditez le Brand Kit à intervalles réguliers. Mettez-le à jour lorsque vous lancez un produit, changez de positionnement, ajoutez une nouvelle audience ou vous étendez à une nouvelle région. Utiliser [Actualisation du Brand Kit](/docs/fr/contexte/brand-kit/refresh.md) pour surveiller les sources en direct et proposer des modifications du Brand Kit pour validation humaine. {% hint style="warning" %} Utilisez le nouveau format de Brand Kit avec les Playbooks. Les Brand Kits hérités fonctionnent moins bien avec les Playbooks et peuvent réduire la qualité de la sortie. {% endhint %} ## Anatomie d’un Playbook Lorsque vous ouvrez l’éditeur de Playbook, vous verrez : * Une rangée de pastilles d’en-tête au-dessus de la première Section affichant les Outils, les Entrées, les Artefacts et **Ajouter un déclencheur**. * Actions en haut à droite pour **Exécuter le Playbook**, **Publier**, et **Historique des exécutions**. * **Quill, le capitaine agent d’AirOps,** sous forme de bouton flottant vert en bas à droite de l’éditeur. * Référencez des pastilles en ligne pendant que vous écrivez. Les Entrées et les Brand Kits apparaissent sous forme de pastilles vertes. Les Outils apparaissent sous forme de pastilles grises avec des icônes. Tapez `/` dans n’importe quelle Section pour ouvrir le menu slash. Le menu slash affiche les Outils, les Entrées, les Artefacts et d’autres références que vous pouvez insérer dans vos instructions. ## Guides Playbook * [Créer un Playbook](/docs/fr/actions/playbooks/create-a-playbook.md) * [Construire un Playbook](/docs/fr/actions/playbooks/build-a-playbook.md) * [Travailler avec les Artefacts](/docs/fr/actions/playbooks/artifacts.md) * [Outils](/docs/fr/actions/playbooks/tools.md) * [Exécuter un Playbook](/docs/fr/actions/playbooks/run-a-playbook.md) * [Déclencheurs de Playbook](/docs/fr/actions/playbooks/triggers.md) * [Connecter des Playbooks à d’autres outils](/docs/fr/actions/playbooks/integrations.md) * [Appliquer les bonnes pratiques des Playbooks](/docs/fr/actions/playbooks/best-practices.md) * [Dépanner les Playbooks](/docs/fr/actions/playbooks/troubleshooting.md) --- # 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://docs.airops.com/docs/fr/actions/playbooks.md?ask=&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.