> 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/artifacts.md).

# Artefacts et collaboration

Stockez, examinez et réutilisez des sorties persistantes de Playbook

Les artefacts sont les sorties persistantes produites par un Playbook. Utilisez un artefact lorsqu’un résultat doit être relu, partagé, réutilisé dans un autre processus ou publié une fois l’exécution du Playbook terminée.

## Comment configurer un artefact

1. Ouvrez l'éditeur de Playbook.
2. Ouvrez **Artefacts** à partir de la rangée de puces d’en-tête et ajoutez un artefact.
3. Attribuez à l’artefact un nom clair et sélectionnez son type.
4. Dans la section qui doit créer la sortie, saisissez `/` et insérez l’artefact dans les instructions.
5. Décrivez ce que la section doit écrire dans l’artefact, y compris la structure ou le format attendus.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b456c32778de62d99a1897b9851e221a9d6dde8f%2Fartifacts-01-artifacts-panel.png?alt=media" alt="Artifacts panel in the Playbook editor listing the Refresh Brief, Refreshed Article, Link Map, Citation Gaps, and Hero Image Artifacts, with Add Artifact"><figcaption><p>Ajoutez et nommez des artefacts à partir de la rangée de puces d’en-tête.</p></figcaption></figure>

Ajoutez un artefact distinct pour chaque sortie qui nécessite sa propre révision ou une utilisation en aval.

## Artefacts et sessions

Chaque exécution de Playbook crée une session. La session enregistre les entrées, les détails d’exécution, l’état de la revue humaine et les artefacts créés pendant cette exécution.

Le contenu qui n’est pas écrit dans un artefact reste dans le contexte de la session. Déclarez un artefact lorsque vous avez besoin d’une sortie durable, comme un brief, un article, un rapport, un jeu de données structuré ou une image.

Les types d’artefacts pris en charge incluent :

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

Attribuez à chaque artefact un nom clair et stable afin qu’il soit facile à référencer dans les instructions du Playbook et les étapes en aval. Chaque artefact généré dispose également d’un lien profond stable que vous pouvez utiliser pour y revenir ou le partager avec les coéquipiers qui y ont accès.

## Relire et modifier un artefact

Ouvrez un artefact depuis sa session ou depuis une cellule d’artefact liée dans une grille. Vous pouvez collaborer sur la sortie sans modifier le Playbook qui l’a produite :

* **Commentaires :** Sélectionnez une partie d’un artefact et laissez une question ou un retour.
* **Suggestions :** Proposez une modification qu’un relecteur peut accepter ou rejeter.
* **Mentions :** Mentionnez un coéquipier dans un commentaire ou un fil de suggestions lorsque sa relecture est nécessaire.
* **Modifier avec l’IA :** Sélectionnez le contenu et décrivez comment vous souhaitez réviser cette sélection.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-05f85592649f83de33a37d3e7a7902fedda787da%2Fartifacts-02-review-comments.png?alt=media" alt="Playbook Artifact with a comment thread mentioning Maya Chen and a pending suggestion with Accept and Reject"><figcaption><p>Commentez, proposez des modifications et réécrivez des parties d’un artefact.</p></figcaption></figure>

Les commentaires et les suggestions restent attachés à l’artefact, conservant la discussion de relecture avec la sortie à laquelle elle se rapporte.

{% hint style="info" %}
La modification d’un artefact change cette sortie de session. Elle ne met pas à jour les instructions du Playbook. Pour modifier les exécutions futures, modifiez et publiez le Playbook.
{% endhint %}

Pour les vérifications automatisées de la découvrabilité de l’IA et du respect de la marque, voir [Relecture du contenu et scores de qualité](https://docs.airops.com/docs/fr/actions/grids/review-content-in-the-grid/content-review.md).

## Ajouter des images à un artefact

Dans un artefact Markdown ou HTML modifiable, utilisez le bouton d’image pour téléverser un fichier ou insérer l’URL d’une image existante. Vous pouvez également coller un fichier image, comme une capture d’écran, dans l’éditeur.

Les fichiers téléversés et collés utilisent des URL d’images hébergées par AirOps. Les images insérées par URL conservent leur adresse d’origine, alors assurez-vous que la source reste accessible.

## Comparer ou restaurer des versions

L’historique des versions de l’artefact conserve les versions antérieures à mesure que la sortie change.

Ouvrir l’historique des versions pour :

* Voir quand chaque version a été créée.
* Comparer une version antérieure avec le contenu actuel.
* Revenir à une version antérieure lorsque vous devez récupérer des modifications écrasées ou indésirables.

Utilisez l’historique des versions avant la publication lorsque plusieurs personnes ou des modifications assistées par l’IA ont changé la même sortie.

## Utiliser des artefacts dans les grilles

Une colonne d’artefact relie une cellule de grille à l’artefact du Playbook dans sa session. Le lien est bidirectionnel :

* Une modification effectuée depuis la session apparaît dans la cellule de la grille.
* Une modification ouverte depuis la cellule de la grille met à jour le même artefact de session.

Cela permet aux équipes de rechercher et de trier les sorties dans une grille, d’utiliser un artefact comme entrée d’un Playbook ou d’un workflow en aval, et d’intégrer la sortie relue dans la publication CMS sans la copier dans une colonne de contenu séparée.

Voir [Ajouter des colonnes dans la grille](https://docs.airops.com/docs/fr/actions/grids/add-columns-in-the-grid.md#artifact-columns) pour ajouter et utiliser une colonne d’artefact.


---

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