> 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 un résultat de mauvaise qualité, se bloque, achemine les révisions de manière incorrecte ou utilise la mauvaise version.

| Symptôme                                                                          | Cause probable                                                                                                     | Solution                                                                                                                                                            |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La qualité du résultat est faible                                                 | Le Brand Kit est obsolète ou utilise l’ancien format.                                                              | Migrez vers le nouveau format de Brand Kit et vérifiez le ton, les règles de rédaction, les audiences et les régions.                                               |
| Erreur « Brand Kit requis » après avoir associé un Brand Kit                      | Le type d’entrée est Texte au lieu de Brand Kit.                                                                   | Ouvrez les paramètres d’entrée et passez le type à **Brand Kit**.                                                                                                   |
| Le Playbook passe à côté d’opportunités évidentes                                 | La couverture des prompts est incomplète ou obsolète.                                                              | Auditez les prompts suivis et élargissez la couverture à partir des requêtes GSC, des appels commerciaux, des tickets d’assistance et des lacunes concurrentielles. |
| 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 effectue une recherche trop large. | 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 artefact                               | La section fait référence à l’artefact par son nom de fichier.                                                     | Référez-vous à l’artefact par son nom. Utilisez le menu / pour insérer la référence.                                                                                |
| L’exécution déclenchée utilise l’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 obligatoires 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 de la Grid échoue après modification des entrées                      | La colonne Grid utilise une version du Playbook avec des entrées obligatoires qui ne sont pas mappées.             | Ouvrez les paramètres de la colonne Grid et mettez à jour les mappages d’entrées.                                                                                   |
| Une session ne peut pas démarrer parce qu’un artefact requis n’est pas disponible | Le Playbook en amont n’a pas produit l’artefact mappé.                                                             | Terminez l’exécution en amont et confirmez que l’artefact 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 du chat s’appliquent uniquement aux artefacts.           | Ouvrez le Playbook dans l’éditeur et modifiez le Playbook avec [Quill](https://docs.airops.com/docs/fr/quill.md), ou effectuez des modifications directes.          |
| Le Playbook répliqué manque d’outils                                              | Le convertisseur de workflow n’a pas transféré toutes les références d’outils dans le Playbook.                    | Ajoutez les outils manquants avec le menu / 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’une Grid.                               | Passez au Playbook une véritable colonne d’identifiant, comme l’URL ou le slug, au lieu de `__id`.                                                                  |
| Un Playbook n’est pas disponible dans une Grid                                    | Le Playbook est encore en brouillon.                                                                               | Publiez le Playbook, puis ajoutez-le depuis l’onglet Playbooks de la Grid.                                                                                          |
| AEO Insight n’est pas disponible en tant que déclencheur                          | Les déclencheurs AEO Insight ne sont pas activés pour l’espace de travail.                                         | Utilisez Schedule, 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 le champ de texte enrichi complet.                                                           | Planifiez la structure des champs afin que le résultat du Playbook possède le champ vers lequel il exporte.                                                         |
| Les messages Slack ne taguent pas les personnes individuellement                  | 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 la 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 laisser les workflows existants s’exécuter 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 <support@airops.com> si vous avez des questions sur l’accès aux modèles dans les playbooks.

### Puis-je acheminer les révisions vers différentes personnes en fonction du type de contenu ou de la complexité ?

Pas nativement pour l’instant. La solution de contournement actuelle consiste à créer des sections séparées avec une logique de saut, par exemple « Si la complexité n’est pas 3, sautez cette section. » Chaque section peut avoir sa propre attribution de relecteur.

### Les Playbooks peuvent-ils envoyer du contenu directement à 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 Grid, un Playbook de publication distinct 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 par programme ?

Utilisez un **Webhook** déclencheur. Les webhooks sont le moyen recommandé pour lancer un Playbook publié depuis un système externe. Envoyez une `POST` requête vers l’URL du webhook avec un `objet inputs` qui utilise les noms de variables d’entrée du Playbook comme clés. Voir [Déclencheurs de Playbook](https://docs.airops.com/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 le chat de session s’appliquent aux artefacts. Pour modifier le Playbook, ouvrez-le dans l’éditeur et utilisez [Quill](https://docs.airops.com/docs/fr/quill.md) là.


---

# 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=<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.
