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

# Exécuter un Playbook

Exécutez les Playbooks manuellement, depuis les Grids ou avec des déclencheurs

Vous pouvez exécuter un Playbook manuellement depuis l’éditeur, depuis une grille ou automatiquement avec un déclencheur. Chaque exécution crée une Session avec des détails d’exécution et des artefacts.

## Exécuter manuellement

Utilisez une exécution manuelle lorsque vous testez un Playbook ou que vous l’utilisez pour un cas d’usage unique.

1. Ouvrez l'éditeur de Playbook.
2. Cliquez sur **Exécuter le Playbook**.
3. Fournissez les entrées requises.
4. Vérifiez la sortie de la Session et les artefacts.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-668e8ceeb89da177a56995e3337f0812686cc19f%2Frun-playbook-01-run-inputs.png?alt=media" alt="Enter Inputs panel for a Playbook run with page URL, target prompt, refresh brief, and Brand Kit Inputs, Advanced Settings, and the Fast and Max mode toggle in the header"><figcaption><p>Fournissez les entrées requises lorsque vous exécutez un Playbook.</p></figcaption></figure>

{% hint style="info" %}
Les exécutions lancées depuis l’éditeur de Playbook utilisent d’abord des tâches de test, avant les tâches de production. Chaque espace de travail dispose de 50 000 tâches de test gratuites par mois, utilisables pour tester des workflows et des Playbooks. Si votre espace de travail utilise toutes les tâches de test, AirOps utilise des tâches de production pour les exécutions supplémentaires depuis l’éditeur. Vous pouvez consulter l’utilisation des tâches de test dans le **Utilisation** onglet de la Campagne.
{% endhint %}

## Exécuter depuis une grille

Utilisez une grille lorsque vous souhaitez exécuter un Playbook publié sur des lignes de données structurées.

1. Ouvrez le Grid.
2. Cliquez sur **+ Ajouter une colonne**.
3. Sélectionnez le **Playbooks** onglet de la Campagne.
4. Recherchez le Playbook.
5. Associez les colonnes de la grille, des valeurs statiques ou des kits de marque aux entrées du Playbook.
6. Exécutez le Playbook sur une ligne ou en masse.

{% hint style="info" %}
Lorsqu’un Playbook s’exécute depuis une grille, il utilise la version et les mappages d’entrées configurés sur cette colonne de grille. Les modifications que vous apportez dans le chat de la Session s’appliquent aux artefacts, pas au Playbook. Pour modifier le Playbook lui-même, ouvrez-le dans l’éditeur.
{% endhint %}

Voir [Exécuter des Playbooks dans la grille](https://docs.airops.com/docs/fr/actions/grids/run-playbooks-in-grid.md) pour la sélection de version, les exécutions en masse, l’état de la Session et la consultation des artefacts.

### Retourner à la grille source

Après avoir ouvert un Playbook depuis une grille, sélectionnez **Retour à la grille** dans les actions rapides de l’éditeur pour revenir à la feuille d’origine. Si vous avez ouvert le Playbook directement, AirOps revient à sa grille liée ou propose un sélecteur lorsque plusieurs grilles sont liées. L’option est masquée lorsqu’il n’y a pas de grilles liées actives.

## Exécuter automatiquement

Utilisez un déclencheur lorsque le Playbook doit démarrer selon un calendrier, à partir d’un événement externe ou d’un signal AirOps.

Les types de déclencheurs incluent :

* **Planification :** Exécution selon une cadence récurrente.
* **Webhook :** Exécution à partir d’une requête HTTP.
* **Surveillance :** Exécution lorsque Parallel Web Systems détecte une condition à partir de votre requête de surveillance.
* **AEO Insight :** Exécution lorsqu’un seuil Insights activé est atteint.

Les exécutions déclenchées apparaissent dans l’historique des exécutions. Les exécutions nécessitant une révision humaine apparaissent également dans la boîte de réception.

{% hint style="info" %}
Pour la configuration des déclencheurs, les paramètres de version et des exemples de charge utile webhook, consultez [Déclencheurs de Playbook](https://docs.airops.com/docs/fr/actions/playbooks/triggers.md).
{% endhint %}

## Versions et modifications des entrées

Les colonnes de grille et les déclencheurs peuvent utiliser **Par défaut** ou une version épinglée du Playbook.

* **Par défaut** suit la version publiée actuelle.
* **Épinglé** continue d’utiliser la version sélectionnée jusqu’à ce que vous la modifiiez.

{% hint style="warning" %}
Si une nouvelle version du Playbook modifie les entrées, mettez à jour les mappages de colonnes de grille et la configuration des entrées du déclencheur avant de passer à l’échelle. De nouvelles entrées requises sans valeurs mappées ou configurées peuvent faire échouer la validation des exécutions ou les faire ignorer.
{% endhint %}

## Consulter les Sessions

Chaque exécution produit une Session. Une Session contient :

* Le journal d’exécution complet.
* Les entrées utilisées pour l’exécution.
* Le modèle utilisé et ses détails de raisonnement, lorsqu’ils sont disponibles.
* La **Rapide** ou **Max** mode d’exécution, affiché dans la Session **Détails**. Voir [Choisissez un mode d’exécution](https://docs.airops.com/docs/fr/actions/playbooks/build-a-playbook.md#choose-an-execution-mode).
* Chaque artefact produit par le Playbook.
* L’état de révision humaine, lorsque le Playbook inclut des blocs de révision.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-024ac77ad6972adc41ca7777511390c7e7f7f923%2Frun-playbook-02-session-details.png?alt=media" alt="Playbook Session Details with status, version, Max mode, time, runtime, tasks, UUID, source, and model"><figcaption><p>Les détails de la Session indiquent comment une exécution du Playbook a été configurée.</p></figcaption></figure>

Les Sessions sont visibles dans **Historique des exécutions** depuis le coin supérieur droit de l’éditeur de Playbook et dans la boîte de réception lorsque une révision est requise.

L’activité de la Session affiche également la progression de la révision. L’activité des réviseurs est regroupée sous la tentative de vérification qui l’a produite, tandis que les corrections apportées par l’agent principal restent dans la chronologie principale. Vous pouvez consulter cette activité pendant une exécution ou après avoir actualisé la Session.

## Collaborer sur les artefacts

Les artefacts prennent en charge les commentaires, les suggestions, les mentions, l’historique des versions et les modifications assistées par l’IA. Utilisez ces contrôles lorsqu’une sortie de Session doit être révisée avant publication ou utilisation en aval. Les modifications affectent l’artefact de cette Session, pas les instructions du Playbook.

Voir [Artefacts](https://docs.airops.com/docs/fr/actions/playbooks/artifacts.md) pour la collaboration complète, la récupération, le lien stable et le flux de travail Grid.

## Interrompre ou relancer une Session de grille

Si une Session est marquée **Archivée**, vous pouvez consulter son historique et ses artefacts, mais vous ne pouvez pas lui envoyer de nouveaux messages. Démarrez une nouvelle Session pour poursuivre le travail.

Dans une grille, les cellules du Playbook affichent l’état actuel de la Session. Vous pouvez ouvrir la Session depuis la cellule, interrompre une Session en file d’attente ou en cours d’exécution, et relancer des Sessions terminales. Si une Session s’est exécutée sur une ancienne version du Playbook, la cellule affiche un avertissement afin que vous puissiez la relancer sur la version actuelle.

## Utiliser deux Playbooks pour la surveillance et l’action

De nombreuses configurations de Playbook utilisent un modèle à deux Playbooks.

Le premier Playbook surveille les données et trouve du travail pour vous. Il peut s’exécuter sur un déclencheur, analyser AirOps Insights, identifier des opportunités et les envoyer vers une grille avec AirOps MCP, par exemple des URL à actualiser ou des prompts à cibler.

Le second Playbook agit sur ces lignes et produit le résultat. Vous pouvez l’exécuter manuellement ou comme action de grille sur la ligne produite par le premier Playbook, par exemple en rédigeant un article de blog pour un prompt cible ou en actualisant une page existante.

Un Playbook trouve le travail. L’autre Playbook réalise le travail et vous conduit à une sortie. Vous pouvez utiliser l’un ou l’autre schéma seul, mais ils sont souvent composés.

Pour éviter de répéter le travail d’une exécution à l’autre, consignez les éléments terminés dans une grille et demandez au Playbook de surveillance de vérifier cet enregistrement avant de recommander de nouvelles tâches.


---

# 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/run-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.
