> 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/troubleshooting.md). # Dépannage Résolvez les problèmes courants de configuration et d’exécution des Playbooks Utilisez ce guide lorsqu’un Playbook produit une sortie médiocre, se bloque, oriente la relecture de façon incorrecte ou utilise la mauvaise version. | Symptôme | Cause probable | Solution | | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | La qualité de sortie est faible | Le Brand Kit est obsolète ou utilise l’ancien format. | Migrez vers le nouveau format de Brand Kit et auditez le ton, les règles de rédaction, les audiences et les régions. | | Erreur « Brand Kit required » après avoir attaché un Brand Kit | Le type d’entrée est Texte au lieu de Brand Kit. | Ouvrez les paramètres d’entrée et basculez le type sur **Brand Kit**. | | Le Playbook manque des opportunités évidentes | La couverture des prompts est incomplète ou obsolète. | Auditez les prompts suivis et étendez la couverture à partir des requêtes GSC, des appels commerciaux, des tickets de support et des lacunes face aux concurrents. | | La recherche dans la base de connaissances renvoie des résultats non pertinents | La mauvaise base de connaissances est sélectionnée, ou la sélection automatique recherche trop largement. | Sélectionnez la base de connaissances par son nom dans le sélecteur de base de connaissances de l’étape. | | Une Section en aval ne peut pas trouver un Artifact | La Section fait référence à l’Artifact par son nom de fichier. | Référencez l’Artifact par son nom. Utilisez le menu slash pour insérer la référence. | | L’exécution déclenchée utilise un ancien contenu du Playbook | Le déclencheur est épinglé à une version publiée plus ancienne. | Ouvrez le déclencheur et sélectionnez **par défaut** ou la version publiée que vous souhaitez exécuter. | | L’exécution déclenchée échoue après modification des entrées | La version active du Playbook comporte des entrées requises qui ne sont pas configurées sur le déclencheur. | Ouvrez les paramètres du déclencheur et mettez à jour la configuration des entrées. | | L’exécution du Grid échoue après modification des entrées | La colonne du Grid utilise une version du Playbook avec des entrées requises qui ne sont pas mappées. | Ouvrez les paramètres de la colonne du Grid et mettez à jour le mappage des entrées. | | Une Session ne peut pas démarrer parce qu’un Artifact requis n’est pas disponible | Un Playbook en amont n’a pas produit l’Artifact mappé. | Terminez l’exécution en amont et confirmez que l’Artifact requis existe, puis réessayez la Session en aval. | | Les modifications dans le chat de Session ne mettent pas à jour le Playbook | La Session exécute une version publiée. Les modifications dans le chat s’appliquent uniquement aux Artifacts. | Ouvrez le Playbook dans l’éditeur et modifiez le Playbook avec [Quill](/docs/fr/quill.md), ou effectuez des modifications directes. | | Le Playbook répliqué manque d’Outils | Le convertisseur de Workflow n’a pas repris chaque référence d’Outil dans le Playbook. | Ajoutez les Outils manquants avec le menu slash avant de publier. | | Le Playbook se bloque à la Section 1 en demandant quelle ligne exécuter | L’exécution utilise la `__id` colonne interne comme identifiant de ligne d’un Grid. | Transmettez au Playbook une vraie colonne d’identifiant, comme une URL ou un slug, au lieu de `__id`. | | Un Playbook n’est pas disponible dans un Grid | Le Playbook est encore en brouillon. | Publiez le Playbook, puis ajoutez-le depuis l’onglet Playbooks du Grid. | | AEO Insight n’est pas disponible comme déclencheur | Les déclencheurs AEO Insight ne sont pas activés pour l’espace de travail. | Utilisez Planification, Webhook ou Monitor, ou contactez votre équipe de compte au sujet des déclencheurs AEO Insight. | | L’export Webflow a écrasé le contenu personnalisé | L’export natif envoie l’intégralité du champ de texte enrichi. | Planifiez la structure des champs afin que la sortie du Playbook prenne en charge le champ vers lequel il exporte. | | Les messages Slack ne marquent pas les individus | Les @mentions individuelles ne sont pas encore prises en charge dans les étapes Slack des Playbooks. | Nommez la personne dans le corps du message et demandez aux relecteurs de surveiller le canal concerné. | ## Reprendre après une limite d’exécution Si une Session dépasse la limite d’exécution de deux heures, AirOps l’annule et affiche une erreur expliquant que vous pouvez reprendre. Ouvrez la Session et reprenez-la pour continuer le travail. La même limite s’applique à une Session reprise. ## Questions fréquentes ### Puis-je conserver les Workflows existants en cours d’exécution pendant que je crée des Playbooks ? Oui. Les Playbooks et les Workflows peuvent s’exécuter en parallèle pendant la migration. ### Les Playbooks prennent-ils en charge le BYOK ? Les Playbooks ne prennent actuellement pas en charge le BYOK. Contactez si vous avez des questions sur l'accès aux modèles dans les Playbooks. ### Puis-je diriger les relectures vers différentes personnes en fonction du type de contenu ou de la complexité ? Pas encore nativement. La solution de contournement actuelle consiste à créer des Sections séparées avec une logique d’omission, par exemple : « Si la complexité n’est pas 3, sautez cette Section. » Chaque Section peut avoir sa propre affectation de relecteur. ### Les Playbooks peuvent-ils envoyer du contenu directement vers mon CMS ? Oui, mais séparez la publication de la création de contenu lorsque c’est possible. Créez et relisez d’abord le contenu, puis publiez-le depuis une colonne du Grid, un Playbook de publication séparé ou un CMS MCP. Si un Playbook ou un CMS MCP publie ou actualise une page, appelez l’AirOps MCP `track_aeo_page_content_update` avec l’URL de la page et le type de mise à jour afin qu’AirOps Insights puisse suivre la mise à jour du contenu. ### Quels outils SEO sont disponibles dans les Playbooks ? Les Playbooks peuvent utiliser AirOps SEO Research, DataForSEO, Moz, Google Search Console, Page 360 Report et Page Versus Report. Ils peuvent également utiliser des outils de recherche web comme Google Search, Parallel Web Systems, Firecrawl, Reddit et Web Page Scrape. ### Comment déclencher un Playbook de manière programmatique ? Utilisez un **Webhook** déclencheur. Les webhooks sont la méthode recommandée pour lancer un Playbook publié depuis un système externe. Envoyez une `POST` requête à l’URL du webhook avec un `inputs` objet qui utilise les noms des variables d’entrée du Playbook comme clés. Voir [Déclencheurs de Playbook](/docs/fr/actions/playbooks/triggers.md#webhook-payload-format) pour le format de la charge utile. Le déclencheur exécute sa version sélectionnée : **par défaut** suit la version publiée actuelle, et un déclencheur épinglé continue d’utiliser la version sélectionnée jusqu’à ce que vous la modifiiez. Si les entrées du Playbook changent, mettez à jour la configuration des entrées du déclencheur avant d’envoyer des requêtes de production. ### Quill peut-il modifier un Playbook depuis une Session en cours ? Non. Les modifications dans un chat de Session s’appliquent aux Artifacts. Pour modifier le Playbook, ouvrez-le dans l’éditeur et utilisez [Quill](/docs/fr/quill.md) là. ### Un Playbook peut-il se souvenir de choses d’une exécution à l’autre ? Oui. La mémoire conserve les informations d’une Session à l’autre. Un schéma courant consiste à utiliser un Playbook qui surveille les données et évite de recommander le même contenu à actualiser sur une fenêtre glissante, par exemple 60 jours. --- # 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/troubleshooting.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.