> 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/getting-started/building-your-first-playbook.md).

# Créer votre premier Playbook

Créez et lancez votre premier Playbook AirOps

Dans ce tutoriel, vous allez créer un Playbook de création de contenu. Le Playbook prend un mot-clé principal ou une invite cible, recherche les réponses de recherche LLM à partir d’AirOps Insights et les résultats Google, crée un plan, rédige l’article, ajoute des liens et produit un article final en Markdown.

Cet exemple de contenu détenu montre comment transformer une opportunité de découverte par l’IA en travail d’agent répétable avec le contexte de votre marque et la revue humaine. Vous pouvez appliquer la même approche à d’autres tâches de recherche, de mise à jour et d’optimisation dans votre stratégie.

## Avant de commencer

Pour obtenir la sortie de la plus haute qualité, configurez les deux sources de contexte dont ce Playbook dépend :

* **AirOps Insights :** Suivez les invites, sujets, concurrents et pages qui vous intéressent. Le Playbook utilise AirOps Insights pour rechercher les réponses de recherche LLM, les citations dans ces réponses et les opportunités AEO pour l’invite cible.
* **Brand Kit :** Tenez votre Brand Kit à jour afin que le Playbook puisse utiliser votre positionnement, votre audience, votre voix, vos règles de rédaction, vos gammes de produits et le contexte de vos concurrents.

## Ce que vous allez créer

Le Playbook va :

1. Accepter un mot-clé principal, une invite cible et un Brand Kit comme entrées.
2. Rechercher les réponses de recherche LLM à partir d’AirOps Insights et les comparer aux résultats Google.
3. Analyser le contenu des concurrents et les lacunes de contenu.
4. Créer un plan, un brouillon, une carte des liens et un article final.
5. Faire une pause pour la revue humaine avant l’approbation de l’article final.

## Étape 1 : Créer un Playbook vierge

1. Cliquez sur **Créez**.
2. Sélectionnez **Playbook**.
3. Sélectionnez **Playbook vierge**.
4. Nommez le Playbook **Création de blog**.

AirOps ouvre l’éditeur du Playbook. L’éditeur comporte une rangée de pastilles d’en-tête pour les Outils, les Entrées, les Artefacts et **Ajouter un déclencheur**, ainsi que des actions en haut à droite pour **Exécuter le Playbook**, **Publier**, et **Historique des exécutions**.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-02e3ddae1a4e5c1808f6d515db03adc38ae25f49%2Ffirst-playbook-01-blank-editor.png?alt=media" alt="Blank Blog Creation Playbook in the AirOps Playbook editor, with 1 Tool and Add Trigger chips above an empty Section"><figcaption><p>Un nouveau Playbook vierge. Les pastilles Entrées et Artefacts apparaissent une fois que le Playbook en possède au moins une de chaque.</p></figcaption></figure>

## Étape 2 : Ajouter des entrées

Créez les entrées dont le Playbook a besoin au moment de l’exécution.

| nom de l’entrée   | Tapez     | Description                                                                          |
| ----------------- | --------- | ------------------------------------------------------------------------------------ |
| `primary_keyword` | Texte     | Le mot-clé SEO que l’article doit cibler.                                            |
| `target_prompt`   | Texte     | L’invite de recherche LLM ou la question à laquelle l’article doit aider à répondre. |
| `brand_kit`       | Brand Kit | Le Brand Kit qui doit guider le positionnement, le public, la voix et les règles.    |

Le Playbook doit fonctionner lorsque l’un ou l’autre `primary_keyword` ou `target_prompt` est fourni. Si les deux sont fournis, utilisez-les tous les deux pour orienter la recherche et la stratégie de l’article.

## Étape 3 : Ajouter des outils

Tapez `/` dans n’importe quelle section pour ouvrir le menu slash. Utilisez-le pour insérer directement dans les instructions du Playbook des outils, des entrées, des artefacts et d’autres références.

Pour ce tutoriel, ajoutez les outils connectés à votre espace de travail :

* **Recherche Google :** Trouvez les résultats Google actuels pour le mot-clé cible.
* **Parallel Web Systems :** Utilisez l’API Parallel Search, l’API Parallel Extract et l’API Parallel Task pour rechercher le web, extraire le contenu source et structurer les résultats.
* **AirOps SEO Research :** Récupérez le mot-clé, le domaine et le contexte SEO.
* **DataForSEO**, **Moz**, ou **Google Search Console :** Ajoutez des données SEO si votre espace de travail utilise ces sources.
* **Page 360 Report :** Diagnostiquer une URL détenue sur la performance dans la recherche, la visibilité IA, la fraîcheur, les signaux d’autorité et le contenu de la page.
* **Page Versus Report :** Comparer une URL détenue avec les pages gagnantes dans la recherche et les réponses IA, puis faire ressortir les écarts à combler.
* **Web Page Scrape :** Lisez les pages spécifiques que le Playbook doit examiner.
* **Brandfetch :** Enrichissez les détails de l’entreprise ou de la marque si nécessaire.

{% hint style="info" %}
Vous n’avez pas besoin de tous les outils pour la première version. Commencez par Google Search, Parallel Web Systems, AirOps SEO Research et les rapports de pages AirOps pertinents pour l’article.
{% endhint %}

## Étape 4 : Déclarer les artefacts

Les artefacts sont les sorties durables que le Playbook produit. Ajoutez ces artefacts avant de rédiger les sections afin de pouvoir y faire référence par leur nom.

| Artefact                    | Tapez    | Objectif                                                                                                                    |
| --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| **AI & Google Results.md**  | Markdown | Capture le contenu existant, les principaux résultats Google et les citations des réponses LLM provenant d’AirOps Insights. |
| **Competitive Analysis.md** | Markdown | Résume l’intention de recherche, la structure des concurrents, les mots-clés, les FAQ, les lacunes et l’adéquation AEO.     |
| **Topic Research.md**       | Markdown | Stocke les faits vérifiés, les analyses d’experts, les exemples et les corrections d’affirmations.                          |
| **Content Outline.md**      | Markdown | Définit la structure de l’article et le brief de rédaction.                                                                 |
| **Article Draft.md**        | Markdown | Stocke la première version complète de l’article.                                                                           |
| **Link Map.json**           | JSON     | Associe les liens internes et externes aux sections de l’article.                                                           |
| **Final Article.md**        | Markdown | Stocke l’article final avec les liens.                                                                                      |

Utilisez le menu slash pour insérer des références d’artefacts dans les sections suivantes. Référencez les artefacts par leur nom, et non par le nom de fichier généré lors d’une session.

## Étape 5 : Rédiger les sections

Utilisez les sections pour décrire le travail par phases. Gardez la première version centrée sur le parcours principal.

Formatez chaque section avec un court **Objectif**, les entrées ou les artefacts qu’elle doit référencer, des **Des instructions**, et l’ **Sortie** artefact attendu. Utilisez le menu slash pour insérer des références d’entrées, d’artefacts, d’outils et de Brand Kit au lieu de taper leurs noms manuellement.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1c956159aa6f1a1843800819574df7cfab671275%2Ffirst-playbook-02-sections-and-references.png?alt=media" alt="Blog Creation Playbook with 6 Tools, 3 Inputs, and 7 Artifacts, and a Section referencing Inputs, Tools, and the AI &#x26; Google Results Artifact as pills"><figcaption><p>Insérez les entrées, les outils et les artefacts depuis le menu slash afin qu’ils apparaissent sous forme de pastilles.</p></figcaption></figure>

### Section A : Rechercher les réponses LLM et les résultats Google

Indiquez au Playbook de :

* Vérifier le site de la marque pour voir s’il existe déjà du contenu lié au mot-clé ou à l’invite.
* Utiliser AirOps Insights pour rechercher les réponses de recherche LLM et les citations pour l’invite cible.
* Utiliser Google Search et les outils SEO pour collecter les meilleurs résultats Google pour le mot-clé principal.
* Exclure les réseaux sociaux, les forums et les domaines concurrents lorsque c’est possible.
* Écrivez les résultats dans **AI & Google Results.md**.

### Section B : Analyser les concurrents et les lacunes

Indiquez au Playbook de :

* Extrayez les titres, le contenu principal, le nombre de mots et les sections FAQ des pages les mieux classées et les plus citées.
* Analysez l’intention de recherche, la couverture du sujet, la structure, les mots-clés, les FAQ et les lacunes.
* Utilisez le Brand Kit pour identifier les angles que la marque peut légitimement s’approprier.
* Écrivez l’analyse dans **Competitive Analysis.md**.

### Section C : Rassembler la recherche sur le sujet

Indiquez au Playbook de :

* Élaborez un programme de recherche à partir de **Competitive Analysis.md**.
* Trouvez des statistiques à jour, des points de vue d’experts, des exemples concrets et des affirmations obsolètes des concurrents.
* Privilégiez les sources primaires et faisant autorité.
* Écrivez les résultats dans **Topic Research.md**.

### Section D : Créer le plan

Indiquez au Playbook de :

* Utilisez **Competitive Analysis.md**, **Topic Research.md**, ainsi que le Brand Kit pour définir la stratégie de l’article.
* Incluez le H1, les H2, les H3, le nombre de mots cible, les points clés, les mots-clés, les notes de recherche, les questions des lecteurs et l’angle de marque.
* Écrivez le plan dans **Content Outline.md**.

### Section E : Rédiger et relire l’article

Indiquez au Playbook de :

* Rédigez l’article à partir de **Content Outline.md**.
* Utilisez **Topic Research.md** pour les faits, les exemples et les sources.
* Suivez la voix, le public, les règles de rédaction et les conventions de type de contenu du Brand Kit.
* Écrivez le brouillon dans **Article Draft.md**.
* Faites une pause pour la revue humaine avant la finalisation.

### Section F : Ajouter les liens et finaliser

Indiquez au Playbook de :

* Ajoutez les liens internes pertinents du site de la marque.
* Ajoutez des liens externes qui étayent des affirmations précises.
* Écrivez le plan de liens dans **Link Map.json**.
* Écrivez l’article final dans **Final Article.md**.

## Étape 6 : Exécuter et publier

1. Cliquez sur **Exécuter le Playbook**.
2. Saisissez un mot-clé principal, une invite cible ou les deux.
3. Sélectionnez le Brand Kit.
4. Passez en revue chaque artefact au fur et à mesure de sa création.
5. Terminez l’étape de revue humaine depuis la boîte de réception ou la vue Session.
6. Confirmez que **Final Article.md** est terminé.
7. Cliquez sur **Publier** lorsque la structure du Playbook fonctionne de manière fiable.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2a18e6088e125da3f7b4baa05b1f0a9e775fbfa1%2Ffirst-playbook-03-session-human-review.png?alt=media" alt="Blog Creation Session paused for Human Review, with Article Draft.md open, 4 of 6 steps complete, and Request Changes and Approve buttons"><figcaption><p>Passez en revue chaque artefact, puis approuvez le brouillon ou demandez des modifications avant la rédaction de l’article final.</p></figcaption></figure>

Les Playbooks publiés peuvent s’exécuter depuis des Grids et des déclencheurs. Utilisez un [déclencheur Webhook](https://docs.airops.com/docs/fr/actions/playbooks/triggers.md) lorsqu’un système externe doit démarrer un Playbook de manière programmatique. Les modifications du brouillon restent modifiables, mais les exécutions en aval utilisent une version publiée.

## Développez votre Playbook

Après la publication, vous pouvez :

* Ajouter le Playbook à une Grid pour créer des articles sur de nombreux mots-clés ou invites.
* Ajouter un déclencheur Schedule, Webhook ou Monitor.
* Utilisez [Quill](https://docs.airops.com/docs/fr/quill.md) pour réviser le Playbook à partir d’instructions en langage naturel.
* Créer un flux de publication séparé pour les mises à jour du CMS.

{% hint style="info" %}
La bonne pratique consiste à garder la création de contenu et la publication CMS séparées. Exécutez d’abord le Playbook de contenu, examinez le résultat, puis publiez via une colonne Grid, un Playbook de publication séparé ou un CMS MCP. Si un Playbook ou un CMS MCP publie ou met à jour une page, utilisez l’outil AirOps MCP `track_aeo_page_content_update` avec l’URL de la page et le type de mise à jour afin qu’AirOps Insights puisse relier les futures évolutions de performances à cette mise à jour de contenu.
{% endhint %}

Félicitations, vous avez créé et exécuté votre premier Playbook de création de contenu.

Ce guide suit la même structure générale que le **Création de blog** modèle. Exécutez le modèle avec le même mot-clé, la même invite cible et le même Brand Kit si vous souhaitez comparer les résultats et voir comment une version plus complète traite le même brief.

Pour une référence plus approfondie, voir [Créer un Playbook](https://docs.airops.com/docs/fr/actions/playbooks/create-a-playbook.md), [Construire un Playbook](https://docs.airops.com/docs/fr/actions/playbooks/build-a-playbook.md), et [Exécuter un Playbook](https://docs.airops.com/docs/fr/actions/playbooks/run-a-playbook.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/getting-started/building-your-first-playbook.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.
