> 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 requête cible, recherche les réponses de recherche des LLM à partir d’AirOps Insights et des 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 propriétaire 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 relecture 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 meilleure qualité de sortie, configurez les deux sources de contexte dont ce Playbook dépend :

* **AirOps Insights :** Suivez les prompts, sujets, concurrents et pages qui vous importent. Le Playbook utilise AirOps Insights pour rechercher les réponses de recherche des LLM, les citations dans ces réponses et les opportunités AEO pour la requête cible.
* **Brand Kit :** Gardez votre Brand Kit à jour afin que le Playbook puisse utiliser votre positionnement, votre audience, votre ton, vos règles de rédaction, vos gammes de produits et le contexte concurrentiel.

## Ce que vous allez construire

Le Playbook va :

1. Accepter un mot-clé principal, une requête cible et un Brand Kit comme entrées.
2. Rechercher les réponses de recherche des LLM à partir d’AirOps Insights et les comparer avec les 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 l’article final.
5. Mettre en pause pour relecture humaine avant l’approbation de l’article final.

## Étape 1 : Créez 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 Outils, Entrées, Artefacts et **Ajouter un déclencheur**, ainsi que des actions en haut à droite pour **Exécuter le Playbook**, **Publier**, et **Historique des exécutions**.

## É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     | Le prompt 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, l’audience, le ton 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 barre oblique. Utilisez-le pour insérer directement des outils, des entrées, des artefacts et d’autres références dans les instructions du Playbook.

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 :** Extraire 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 :** Diagnostiquez une URL détenue sur les performances de recherche, la visibilité IA, la fraîcheur, les signaux d’autorité et le contenu de la page.
* **Page Versus Report :** Comparez une URL détenue aux pages gagnantes dans les résultats de recherche et les réponses IA, puis faites 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 lorsque c’est nécessaire.

{% hint style="info" %}
Vous n’avez pas besoin de tous les outils pour la première version. Commencez avec 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 résultats durables produits par le Playbook. Ajoutez ces artefacts avant d’écrire les sections afin de pouvoir les référencer 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 d’AirOps Insights.       |
| **Analyse concurrentielle.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 rédactionnel.                                                             |
| **Article Draft.md**           | Markdown | Stocke le premier brouillon complet de l’article.                                                                       |
| **Carte des liens.json**       | JSON     | Mappe les liens internes et externes aux sections de l’article.                                                         |
| **Article final.md**           | Markdown | Stocke l’article terminé avec les liens.                                                                                |

Utilisez le menu barre oblique pour insérer des références aux artefacts dans les sections suivantes. Référez-vous aux artefacts par leur nom, et non par le nom de fichier généré à partir 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 chemin principal.

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

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

Indiquez au Playbook de :

* Vérifier le site de la marque pour trouver le contenu existant lié au mot-clé ou au prompt.
* Utiliser AirOps Insights pour rechercher les réponses de recherche des LLM et les citations pour le prompt cible.
* Utiliser Google Search et les outils SEO pour collecter les principaux résultats Google pour le mot-clé principal.
* Exclure les réseaux sociaux, les forums et les domaines concurrents lorsque c’est possible.
* Écrire les résultats dans **AI & Google Results.md**.

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

Indiquez au Playbook de :

* Extraire les titres, le contenu principal, le nombre de mots et les sections FAQ des pages citées et classées les plus solides.
* Analyser l’intention de recherche, la couverture du sujet, la structure, les mots-clés, les FAQ et les lacunes.
* Utiliser le Brand Kit pour identifier les angles que la marque peut légitimement s’approprier.
* Écrire l’analyse dans **Analyse concurrentielle.md**.

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

Indiquez au Playbook de :

* Élaborer un programme de recherche à partir de **Analyse concurrentielle.md**.
* Trouver des statistiques récentes, des points de vue d’experts, des exemples concrets et des affirmations obsolètes de concurrents.
* Privilégier les sources primaires et faisant autorité.
* Écrire les résultats dans **Topic Research.md**.

### Section D : Créer le plan

Indiquez au Playbook de :

* Utiliser **Analyse concurrentielle.md**, **Topic Research.md**, et le Brand Kit pour définir la stratégie de l’article.
* Inclure 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.
* Écrire le plan dans **Content Outline.md**.

### Section E : Rédiger et réviser l’article

Indiquez au Playbook de :

* Rédiger l’article à partir de **Content Outline.md**.
* Utiliser **Topic Research.md** pour les faits, les exemples et les sources.
* Suivre la voix du Brand Kit, l’audience, les règles de rédaction et les conventions du type de contenu.
* Écrire le brouillon dans **Article Draft.md**.
* Suspendre pour relecture humaine avant de finaliser.

### Section F : Ajouter des liens et finaliser

Indiquez au Playbook de :

* Ajouter des liens internes pertinents depuis le site de la marque.
* Ajouter des liens externes qui étayent des affirmations spécifiques.
* Écrire le plan de liens dans **Carte des liens.json**.
* Écrire l’article final dans **Article final.md**.

## Étape 6 : Exécuter et publier

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

Les Playbooks publiés peuvent s’exécuter à partir de Grids et de déclencheurs. Utilisez un [déclencheur Webhook](/docs/fr/actions/playbooks/triggers.md) lorsqu’un système externe doit lancer un Playbook par programmation. Les modifications de 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 prompts.
* Ajouter un déclencheur de planification, Webhook ou Monitor.
* Utiliser [Quill](/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 meilleure pratique consiste à séparer la création de contenu et la publication CMS. Exécutez d’abord le Playbook de contenu, examinez le résultat, puis publiez via une colonne de Grid, un Playbook de publication séparé ou un CMS MCP. Si un Playbook ou un CMS MCP publie ou actualise 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 variations de performance à cette mise à jour de contenu.
{% endhint %}

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

Cette présentation 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é, prompt cible et Brand Kit si vous voulez comparer les résultats et voir comment une version plus complète traite le même brief.

Pour une référence plus approfondie, consultez [Créer un Playbook](/docs/fr/actions/playbooks/create-a-playbook.md), [Construire un Playbook](/docs/fr/actions/playbooks/build-a-playbook.md), et [Exécuter un Playbook](/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.