> 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/build-a-playbook.md).

# Créer un Playbook

Définissez les entrées, sections, outils, artefacts, révisions et déclencheurs dans un Playbook

Les Playbooks sont construits à partir d’Inputs, de Sections, d’outils, d’artefacts, de blocs de revue humaine et de déclencheurs. Définissez clairement chaque partie afin que l’agent dispose du bon contexte et que les réviseurs aient les bons points de contrôle.

## Choisissez un modèle

Utilisez la fonctionnalité **Modèle** sélecteur dans l’éditeur de Playbook pour choisir **Auto** ou un modèle disponible. Les options affichées dépendent de votre espace de travail et des fournisseurs disponibles.

**GPT-6 Sol**, **GPT-6 Luna**, **Claude Opus 5.5**, **Claude Sonnet 5.5**, et **Kimi K3** sont disponibles dans le sélecteur. Choisissez Sol ou Opus 5.5 pour les tâches complexes, ou Luna lorsque la vitesse et le coût comptent davantage.

### Comparer les notes des modèles

Développez un modèle pour ajuster son **effort de raisonnement** pris en charge et comparer les notes disponibles pour cette sélection :

| Note                     | Ce que signifient davantage de barres                                          |
| ------------------------ | ------------------------------------------------------------------------------ |
| **Vitesse**              | Achèvement moyen plus rapide lors des exécutions de benchmark                  |
| **Intelligence**         | Capacité générale supérieure basée sur le benchmark public Artificial Analysis |
| **Efficacité des coûts** | Moins de tâches consommées par exécution de benchmark                          |

Les notes changent avec l’effort de raisonnement sélectionné lorsque des données de benchmark sont disponibles. Certains modèles et certains réglages d’effort n’ont pas de notes. Considérez les barres comme un repère comparatif : votre Playbook, vos Inputs et vos outils influencent le temps d’exécution réel, l’utilisation des tâches et la qualité du résultat. Auto n’a pas de benchmark fixe de modèle et d’effort.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-931066925d9c8a7297d5b2aa5f05f6558ba3142b%2Fbuild-playbook-01-model-selector.png?alt=media" alt="Playbook model selector grouped by provider, with Kimi K3 expanded to show reasoning effort and Speed, Intelligence, and Cost efficiency ratings"><figcaption><p>Développez un modèle pour comparer ses notes à chaque effort de raisonnement.</p></figcaption></figure>

## Choisissez un mode d’exécution

Utilisez **Rapide** ou **Max** dans l’éditeur de Playbook pour choisir à quel point le Playbook vérifie son travail en profondeur :

| Mode       | À utiliser quand                                                                                                                        |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Rapide** | Vous souhaitez rédiger plus rapidement avec une vérification ciblée des faits et moins de boucles de validation.                        |
| **Max**    | Vous avez besoin d’une vérification approfondie des faits, de la collecte de sources et de contrôles répétés. C’est le mode par défaut. |

Publiez le Playbook pour enregistrer le mode avec cette version. Une Session conserve le mode de la version qu’elle a exécutée, et vous pouvez l’inspecter dans Session **Détails**. Modifier le brouillon ne change pas le mode d’une Session existante ni d’une version épinglée.

## 1. Définir les Inputs

Les Inputs sont la manière dont un Playbook reçoit des informations au moment de l’exécution.

| Tapez     | À utiliser pour                                                               |
| --------- | ----------------------------------------------------------------------------- |
| Texte     | Mots-clés, URL, prompts, chaînes libres.                                      |
| Nombre    | Comptes, seuils, classements.                                                 |
| Fichier   | Documents, briefs et exports que le Playbook doit lire pendant une exécution. |
| Brand Kit | Ton, règles de rédaction, audiences, régions et directives visuelles.         |

Cliquez sur **Afficher les paramètres avancés** sur un Input pour définir son nom de variable, sa description, son texte indicatif et sa valeur par défaut.

## 2. Définir les Sections

Les Sections constituent l’ossature structurelle d’un Playbook. Chaque Section contient des instructions et peut éventuellement se terminer par un bloc de revue humaine.

Organisez les Sections par phase logique, et non par réviseur. Un pipeline de contenu pourrait utiliser :

1. **Ingestion et validation :** Analyser l’Input, le valider et collecter le contexte.
2. **Recherche et stratégie :** Rechercher dans les bases de connaissances, analyser les SERP et examiner les concurrents.
3. **Compilation du brief :** Synthétiser la recherche en un brief actionnable.
4. **Rédaction de l’article et maillage :** Générer le contenu et ajouter des liens internes.
5. **Revue finale :** Faire une pause pour une revue humaine avant la publication.

Les modèles utilisent une structure cohérente à l’intérieur de chaque Section. Utilisez ce modèle comme point de départ, puis adaptez-le au travail :

* **Objectif :** Définir ce que la Section doit accomplir.
* **Inputs et références :** Nommez les Inputs, les artefacts, les champs du Brand Kit, les outils et les bases de connaissances que la Section doit utiliser. Insérez-les depuis le menu barre oblique lorsque c’est possible.
* **Instructions :** Listez le travail en étapes numérotées claires.
* **Sortie :** Nommez l’artefact que la Section doit écrire et le format qu’elle doit utiliser.

## 3. Ajouter des outils

Tapez `/` dans n’importe quelle Section pour ouvrir le menu barre oblique. Utilisez-le pour insérer des outils, des Inputs, des artefacts et d’autres références dans les instructions du Playbook.

Les Inputs, les artefacts et les outils deviennent plus faciles à réutiliser lorsque vous les insérez depuis le menu barre oblique 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-e1b0b98c35cd159dda4994c870bebaa731e1edcf%2Fbuild-playbook-02-slash-menu.png?alt=media" alt="Slash menu in a Playbook Section showing Inputs, Artifacts, Tools, Brand Kit, and formatting options, with the Tools submenu open"><figcaption><p>Tapez / pour insérer des outils, des Inputs et des artefacts en tant que références.</p></figcaption></figure>

Pour le catalogue complet des outils, les connecteurs MCP et les bonnes pratiques, voir [Outils](https://docs.airops.com/docs/fr/actions/playbooks/tools.md).

### AirOps

* **AirOps MCP :** Accédez à vos données AirOps, y compris les données Insights, les Brand Kits, les bases de connaissances et les Grilles.
* **AirOps SEO Research :** Recherche de mots-clés, analyse de domaine et données de backlinks.
* **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 :** Extraire le contenu des pages web.

### Recherche SEO

* **DataForSEO :** Données SEO et recherche de mots-clés.
* **Moz :** SEO et analyse de domaine.
* **Google Search Console :** Données GSC.

### Recherche Web

* **Recherche Google :** Rechercher et récupérer les résultats Google.
* **Parallel Web Systems :** Utilisez l’API Parallel Search, l’API Parallel Extract et l’API Parallel Task pour effectuer des recherches web, extraire des données structurées à partir d’URL et transformer des entrées de recherche en sorties structurées.
* **Firecrawl :** Explorer et extraire le contenu des pages web.
* **Reddit :** Pour plus de détails, [Contacter les ventes](https://www.airops.com/book-a-call).

### Image et vidéo

* **Génération d’images :** Générez ou modifiez des images hébergées avec GPT Image 2.5 Sunburst, GPT Image 2.5 Flare, GPT Image 2 ou Nano Banana 2. Voir [Outils Image et Vidéo](https://docs.airops.com/docs/fr/actions/playbooks/tools/image-and-video.md) pour des conseils sur les modèles.
* **Images de stock :** Recherchez des images Getty Images ou Unsplash, puis récupérez une image sélectionnée par ID pour l’utiliser dans un artefact ou une étape de publication.

### Gestion des connaissances

* **Slack :** Lire l’historique des canaux et envoyer des messages.
* **Google Docs :** Lire et modifier des documents Google Docs.

### Enrichissement B2B

* **Brandfetch :** Récupérer des éléments de marque et des informations.
* **Hunter.io :** Trouver et vérifier des adresses e-mail. Pour plus de détails, [Contacter les ventes](https://www.airops.com/book-a-call).

### Publicités

* **OpenAI Ads :** Récupérer les performances du compte. Créez et gérez des campagnes, des groupes d’annonces et des annonces lorsque les outils d’écriture sont activés. Voir [Outils Ads](https://docs.airops.com/docs/fr/actions/playbooks/tools/ads.md) pour la disponibilité et les étapes de revue.

Vous pouvez ajouter tout connecteur MCP dont vous avez besoin depuis les paramètres des connecteurs MCP de votre espace de travail. Les outils MCP connectés apparaissent dans la liste Outils de l’éditeur de Playbook.

{% hint style="info" %}
Lorsque vous ajoutez une étape de recherche dans une base de connaissances, référencez la base de connaissances par son nom dans le sélecteur de base de connaissances de l’étape. Ne vous fiez pas à la sélection automatique lorsque le Playbook a besoin d’une source précise.
{% endhint %}

## 4. Ajouter une revue humaine

Placez la revue humaine comme bloc à la fin d’une Section existante. Ne créez pas une Section séparée uniquement pour la revue.

Utilisez la revue humaine lorsqu’une personne doit approuver un texte, choisir parmi des options ou modifier le résultat généré avant que la Section suivante ne s’exécute.

Les options de réviseur incluent :

* **Personne nommée :** Un membre précis de l’équipe.
* **Utilisateur actuel :** La personne qui a déclenché le Playbook.
* **Tout membre peut réviser :** N’importe quel membre de l’espace de travail peut réviser.

Les revues apparaissent dans la boîte de réception.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-aa59d35d0bf59d0595c551ddcf26add728f5cd0c%2Fbuild-playbook-03-human-review.png?alt=media" alt="Reviewer menu on a Section&#x27;s Human Review block, with Any member can review, Current user, and teammates listed, and Maya Chen selected"><figcaption><p>Ajoutez la revue humaine à la fin d’une Section. Les revues apparaissent dans la boîte de réception.</p></figcaption></figure>

{% hint style="info" %}
Le routage conditionnel natif vers plusieurs réviseurs n’est pas encore disponible. La solution de contournement actuelle consiste à prévoir une Section par réviseur, avec une logique de saut dans les instructions de la Section. Par exemple : « Si la complexité n’est pas 3, sautez cette Section. »
{% endhint %}

## 5. Déclarer les artefacts

Les artefacts sont les sorties persistantes produites par un Playbook. Déclarez-en un lorsqu’un résultat doit être stocké, révisé, partagé, réutilisé en aval ou publié après la fin de la Session.

Les types d’artefacts pris en charge incluent :

* Markdown
* HTML
* JSON
* CSV
* PNG
* JPG
* GIF

Donnez à chaque artefact un nom clair, puis référencez-le depuis la Section qui doit y écrire. Si une Section ne produit pas d’artefact, son contenu reste dans le contexte de la Session.

Pour les liens stables, les commentaires, les suggestions, les mentions, la modification avec l’IA, l’historique des versions et la réutilisation dans les Grilles, voir [Artefacts](https://docs.airops.com/docs/fr/actions/playbooks/artifacts.md).

## 6. Configurer un déclencheur

Les déclencheurs déterminent comment un Playbook démarre.

| Déclencheur   | Fonctionnement                                                                                                                                          | Idéal pour                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Planification | S’exécute selon une cadence récurrente, par exemple tous les lundis à 9 h.                                                                              | Audits de contenu hebdomadaires, vérifications de fraîcheur du Brand Kit, rapports récurrents. |
| Webhook       | Démarre lorsqu’un système externe envoie une requête HTTP à l’URL du webhook du Playbook.                                                               | Événements de publication CMS, soumissions de formulaires, intégrations tierces.               |
| Surveillance  | Utilise Parallel Web Systems pour vérifier une requête de surveillance toutes les 12 heures et lance le Playbook lorsque la condition est détectée.     | Alertes concurrentielles, surveillance du marché, surveillance de la santé du contenu.         |
| AEO Insight   | Démarre lorsque les seuils AEO Insight activés sont atteints, par exemple lorsque le taux de mentions, la part de voix ou le taux de citation évoluent. | Actualisation programmatique, réponse concurrentielle, lacunes de couverture AEO.              |

{% hint style="info" %}
Les déclencheurs peuvent utiliser **Par défaut** ou une version épinglée du Playbook. **Par défaut** suit la version publiée actuelle. Un déclencheur épinglé continue d’utiliser la version sélectionnée jusqu’à ce que vous la modifiiez. Si une nouvelle version modifie les Inputs, mettez à jour la configuration des Inputs du déclencheur avant de vous fier aux exécutions futures. Voir [Déclencheurs de Playbook](https://docs.airops.com/docs/fr/actions/playbooks/triggers.md) pour les étapes de configuration et des exemples de charge utile de webhook.
{% endhint %}

## 7. Utiliser Quill pour itérer

Quill est le capitaine agent d’AirOps pour la création de Playbooks. Cliquez sur le bouton flottant vert en bas à droite de l’éditeur.

[Quill](https://docs.airops.com/docs/fr/quill.md) peut :

* Modifier votre Playbook à partir de prompts en langage naturel.
* Réécrire un prompt de Workflow en une instruction d’agent concise avec contexte.
* Utiliser des pièces jointes de fichiers et d’images pour mettre à jour le Playbook ou le Brand Kit.
* Analyser la structure du Playbook et proposer des réorganisations.

Donnez d’emblée tout le contexte à Quill. Dans le chat, **Entrée** envoie le message, donc gardez chaque instruction dans un seul paragraphe.

Dupliquez un Playbook avant une réécriture structurelle importante afin d’avoir un point de retour en arrière propre.

## Vérifier la santé du Playbook

Examiner **Santé** dans la liste des Playbooks ou ouvrez le contrôle Santé dans l’éditeur pour voir les vérifications qui nécessitent une attention avant de publier ou d’exécuter le Playbook.

## 8. Publier

La publication crée un instantané versionné que les consommateurs en aval peuvent exécuter depuis les Grilles et les déclencheurs. Utilisez un déclencheur Webhook lorsqu’un système externe doit lancer un Playbook par programme. Les brouillons restent modifiables. Les versions publiées sont des références exécutables.

Si vous avez modifié des Inputs, mettez à jour les mappages de Grille et la configuration des Inputs du déclencheur qui utilisent ce Playbook avant de l’exécuter à grande échelle.

### Restaurer une version précédente

Ouvrez l’historique des versions depuis l’éditeur de Playbook, sélectionnez la version souhaitée, puis cliquez sur **Restaurer**. AirOps copie cette version dans le brouillon actuel afin que vous puissiez l’examiner avant de la publier.

La restauration d’une version remplace le brouillon actuel. Téléchargez ou publiez toutes les modifications du brouillon que vous souhaitez conserver avant de restaurer une version plus ancienne.

La restauration est disponible dans les offres Free, Starter, Pro, Pro Plus et Platform.

## Importer ou exporter un Playbook

L’éditeur peut télécharger un Playbook au format Markdown ou JSON. Il peut également importer du Markdown ou du JSON dans un Playbook existant.

{% hint style="warning" %}
L’importation de Markdown ou de JSON écrase le contenu actuel du Playbook. Téléchargez d’abord le Playbook existant si vous avez besoin d’un point de retour en arrière.
{% endhint %}


---

# 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/build-a-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.
