> 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’Artifacts, de blocs de relecture humaine et de Triggers. Définissez clairement chaque partie afin que l’agent dispose du bon contexte et que les relecteurs aient les bons points de contrôle. ## Choisissez un modèle Utilisez la **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**, et **Claude Opus 5.5** 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 évaluations des modèles Développez un modèle pour ajuster son **effort de raisonnement** pris en charge et comparer les évaluations disponibles pour cette sélection : | Évaluation | Ce que signifient plus de barres | | --------------------------- | ------------------------------------------------------------------------------- | | **Vitesse** | Achèvement moyen plus rapide lors des exécutions de benchmark | | **Intelligence** | Capacité générale plus élevée basée sur le benchmark public Artificial Analysis | | **Rapport coût-efficacité** | Moins de tâches consommées par exécution de benchmark | Les évaluations 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 d’évaluations. Considérez les barres comme un guide comparatif : votre Playbook, vos Inputs et vos Outils influencent le temps d’exécution réel, l’utilisation des tâches et la qualité de sortie. Auto n’a pas de benchmark fixe de modèle et d’effort. ## 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 | Comptages, seuils, classements. | | Fichier | Documents, briefs et exports que le Playbook doit lire pendant une exécution. | | Brand Kit | Voix, règles de rédaction, audiences, régions et consignes visuelles. | Cliquez sur **Afficher les paramètres avancés** sur un Input pour définir son nom de variable, sa description, son placeholder et sa valeur par défaut. ## 2. Définir les Sections Les Sections sont l’ossature structurelle d’un Playbook. Chaque Section contient des instructions et peut éventuellement se terminer par un bloc de relecture humaine. Organisez les Sections par phase logique, et non par relecteur. Un pipeline de contenu pourrait utiliser : 1. **Ingestion et validation :** Analyser l’Input, le valider et rassembler 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. **Relecture finale :** Faire une pause pour une relecture humaine avant la publication. Les modèles utilisent une structure cohérente à l’intérieur de chaque Section. Utilisez ce schéma 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 Artifacts, les champs du Brand Kit, les Outils et les bases de connaissances que la Section doit utiliser. Insérez-les via le menu oblique lorsque c’est possible. * **Instructions :** Listez le travail en étapes numérotées claires. * **Sortie :** Nommez l’Artifact que la Section doit produire et le format qu’elle doit utiliser. ## 3. Ajouter des Outils Tapez `/` dans n’importe quelle Section pour ouvrir le menu oblique. Utilisez-le pour insérer des Outils, des Inputs, des Artifacts et d’autres références dans les instructions du Playbook. Les Inputs, les Artifacts et les Outils deviennent plus faciles à réutiliser lorsque vous les insérez via le menu oblique au lieu de saisir leurs noms manuellement. Pour le catalogue complet des Outils, les connecteurs MCP et les bonnes pratiques, voir [Outils](/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 Grids. * **AirOps SEO Research :** Recherche de mots-clés, analyse de domaine et données de backlinks. * **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 :** Récupérer 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 récupérer 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 d’image et de vidéo](/docs/fr/actions/playbooks/tools/image-and-video.md) pour des conseils sur les modèles. * **Images de stock :** Recherchez dans Getty Images ou Unsplash, puis récupérez une image sélectionnée par ID pour l’utiliser dans un Artifact 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 les ressources et informations de marque. * **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). ### Annonces * **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](/docs/fr/actions/playbooks/tools/ads.md) pour la disponibilité et les étapes de relecture. 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 comptez pas sur la sélection automatique lorsque le Playbook a besoin d’une source spécifique. {% endhint %} ## 4. Ajouter une relecture humaine Placez la relecture humaine comme bloc à la fin d’une Section existante. Ne créez pas une Section séparée uniquement pour la relecture. Utilisez la relecture humaine lorsque quelqu’un doit approuver un texte, choisir entre des options ou modifier la sortie générée avant l’exécution de la Section suivante. Les options de relecteur incluent : * **Personne nommée :** Un membre spécifique de l’équipe. * **Utilisateur actuel :** La personne qui a déclenché le Playbook. * **Tout membre peut relire :** Tout membre de l’espace de travail peut relire. Les relectures apparaissent dans la boîte de réception. {% hint style="info" %} Le routage conditionnel natif vers plusieurs relecteurs n’est pas encore disponible. La solution actuelle consiste à utiliser une Section par relecteur, avec une logique de saut dans les instructions de la Section. Par exemple : « Si la complexité n’est pas 3, ignorez cette Section. » {% endhint %} ## 5. Déclarer les Artifacts Les Artifacts sont les sorties persistantes qu’un Playbook produit. Déclarez-en un lorsqu’un résultat doit être stocké, relu, partagé, réutilisé en aval ou publié après la fin de la session. Les types d’Artifact pris en charge incluent : * Markdown * HTML * JSON * CSV * PNG * JPG * GIF Donnez à chaque Artifact un nom clair, puis référencez-le depuis la Section qui doit écrire dedans. Si une Section ne produit pas d’Artifact, son contenu reste dans le contexte de la session. Pour des liens stables, des commentaires, des suggestions, des mentions, Edit with AI, l’historique des versions et la réutilisation des Grids, voir [Artefacts](/docs/fr/actions/playbooks/artifacts.md). ## 6. Configurer un Trigger Les Triggers déterminent comment un Playbook démarre. | Déclencheur | Fonctionnement | Idéal pour | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | Planification | S’exécute selon une cadence récurrente, par exemple chaque lundi à 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 démarre 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, comme une modification du taux de mentions, de la part de voix ou du taux de citation. | Actualisation programmatique, réponse concurrentielle, lacunes de couverture AEO. | {% hint style="info" %} Les Triggers peuvent utiliser **par défaut** ou une version épinglée du Playbook. **par défaut** suit la version publiée actuelle. Un Trigger é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 Trigger avant de vous appuyer sur les exécutions futures. Voir [Déclencheurs de Playbook](/docs/fr/actions/playbooks/triggers.md) pour les étapes de configuration et des exemples de charge utile webhook. {% endhint %} ## 7. Utiliser Quill pour itérer Quill est le capitaine agent d’AirOps pour l’édition de Playbooks. Cliquez sur le bouton flottant vert en bas à droite de l’éditeur. [Quill](/docs/fr/quill.md) peut : * Modifier votre Playbook à partir de prompts en langage naturel. * Réécrire un prompt de Workflow sous forme de courte instruction d’agent avec contexte. * Utiliser des pièces jointes de fichiers et d’images pour mettre à jour le Playbook ou le Brand Kit. * Raisonner sur la structure du Playbook et suggérer des réorganisations. Donnez à Quill tout le contexte dès le départ. Dans le chat, **Entrée** soumet, donc gardez chaque instruction dans un seul paragraphe. Dupliquez un Playbook avant une grande réécriture structurelle afin d’avoir un point de retour propre. ## Vérifier la santé du Playbook Vérifier **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é à partir duquel les consommateurs en aval peuvent exécuter des Grids et des Triggers. Utilisez un Trigger Webhook lorsqu’un système externe doit démarrer un Playbook par programmation. Les brouillons restent modifiables. Les versions publiées sont des références exécutables. Si vous avez modifié les Inputs, mettez à jour les mappages de Grid et la configuration des Inputs du Trigger 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 la relire avant publication. La restauration d’une version remplace le brouillon actuel. Téléchargez ou publiez toute modification de brouillon que vous souhaitez conserver avant de restaurer une version plus ancienne. La restauration est disponible dans les niveaux 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. {% 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=&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.