> 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/workflow-concepts/workflow-steps/flow/human-review.md).

# Révision humaine

Exiger une révision humaine des résultats avant de poursuivre un workflow

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-691860a5345af5d23d0795f9eb0c767a52c74cc2%2Fhuman-review-step-01-overview.png?alt=media" alt="Run Once page of the Launch Blog Post Generator with the Review Needed panel showing a Blog Title, and Cancel Execution and Accept Output buttons"><figcaption><p>La révision humaine met en pause un workflow jusqu’à ce que quelqu’un examine la sortie.</p></figcaption></figure>

Avec l’étape de révision humaine, l’utilisateur peut être invité à examiner, valider et modifier une valeur de texte (*Élément unique*) ou à sélectionner et modifier plusieurs valeurs (*Valeurs multiples*) avant de poursuivre un workflow.

Par exemple, vous pourriez créer une liste de 5 titres d’articles de blog parmi lesquels un utilisateur peut choisir, demander à l’utilisateur de vérifier et de sélectionner les titres à publier avec une étape de révision, puis publier le contenu sélectionné sur votre blog.

## Canaux de notification Slack

Vous pouvez envoyer des notifications de révision à un canal public ou à un canal privé auquel le bot AirOps a été ajouté. Invitez le bot dans un canal privé avant de le sélectionner. Les canaux récemment rejoints peuvent prendre jusqu’à cinq minutes avant d’apparaître dans le sélecteur.

## Réviser un élément unique

### Qu’est-ce qu’un élément unique ?

L’élément unique permet à l’utilisateur de modifier le texte dans une zone de texte à une seule ligne :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-8d15450bf89869f9574c9d6dbfafaf0629a3af2f%2Fhuman-review-step-02-single-item.png?alt=media" alt="Details tab of a test run with Review Content showing a single editable Blog Title"><figcaption><p>Révision d’un élément unique.</p></figcaption></figure>

### Comment configurer un élément unique

1. **Étiquetez l’élément :** l’étiquette créera automatiquement le nom de variable associé à votre étiquette. Dans l’exemple ci-dessous, nous étiquetons notre élément « Blog Title », ce qui a également créé la variable `blog_title`
2. **Attribuez la valeur de l’élément :** utilisez la syntaxe Liquid pour transmettre la valeur que vous souhaitez que l’utilisateur modifie et examine. Dans l’exemple ci-dessous, il s’agit de `{{step_2.output}}`
3. **(Facultatif) Envoyer une notification à un canal Slack :** choisissez un canal Slack qui notifiera les utilisateurs de réviser la sortie

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-c1cbb469bb5f69199f2041766c84642657f3bf5a%2Fhuman-review-step-03-single-config.png?alt=media" alt="Human Review step with a Blog Title in the Single Item content format and a Configure Slack to enable notifications button"><figcaption><p>Configuration d’un élément unique.</p></figcaption></figure>

## Réviser plusieurs valeurs

### Qu’est-ce que sont plusieurs valeurs ?

Les valeurs multiples permettent à l’utilisateur de sélectionner et de modifier plusieurs valeurs à la fois :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0aa7ef995db044757bcd7d3f7dd1b8dcfb33ab40%2Fhuman-review-step-04-multiple-values.png?alt=media" alt="Details tab of a test run with Review Content listing five blog titles, two of them selected"><figcaption><p>Révision de sélection multiple.</p></figcaption></figure>

### Comment configurer plusieurs valeurs

1. Définissez une liste d’options :

   1. **Générez une liste :** utilisez une étape LLM pour générer une liste d’éléments, elle doit être un tableau

      <figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-16cd4dabbcb491e1c2eacf14784b13129db7c8bb%2Fhuman-review-step-05-title-list.png?alt=media" alt="Generate blog titles step output in the run Logs, a JSON array of five blog titles"><figcaption><p>Une liste de cinq titres d’articles de blog.</p></figcaption></figure>
   2. **Étiquetez l’élément :** l’étiquette créera automatiquement le nom de variable associé à votre étiquette. Dans l’exemple ci-dessous, nous étiquetons notre élément « Blog Titles », ce qui a également créé la variable `blog_titles`
   3. **Attribuez la valeur de l’élément :** utilisez la syntaxe Liquid pour transmettre la liste que vous avez générée à l’étape 1. Dans l’exemple ci-dessous, il s’agit de `{{step_2.output}}`
   4. **(Facultatif) Envoyer une notification à un canal Slack :** choisissez un canal Slack qui notifiera les utilisateurs de réviser la sortie

   <figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-8f4f957ed676b5b7074b5e872d6091ea96bcb42e%2Fhuman-review-step-06-multiple-config.png?alt=media" alt="Human Review step with Blog Titles in the Multi Selection (Checkbox List) content format"><figcaption><p>Configuration de sélection multiple (liste de cases à cocher).</p></figcaption></figure>

## Référencer l’étape de révision humaine

### Comment référencer un élément unique

Pour référencer un élément unique à partir de l’étape de révision humaine, utilisez la variable correspondant à l’étiquette que vous avez fournie.

Dans cet exemple, nous avons nommé l’élément « Blog Title », ce qui a créé la variable `{{step_3.output.blog_title}}` :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-6814fe29c7cf6c6dd29fd9bbe3e84949b9882282%2Fhuman-review-step-07-reference-single.png?alt=media" alt="Human Review Single Item Blog Title referenced as step_3.output.blog_title"><figcaption><p>Référencer un élément unique.</p></figcaption></figure>

### Comment référencer plusieurs valeurs

Pour référencer plusieurs valeurs à partir de l’étape de révision humaine, utilisez la variable correspondant à l’étiquette que vous avez fournie.

Cependant, contrairement au référencement d’un élément unique, la sortie d’une révision à valeurs multiples est une liste :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b61c2f1ba32a0aeb9d6f6cefa7a8f5460f0d1b4f%2Fhuman-review-step-08-reference-multiple.png?alt=media" alt="Human Review step output in the run Logs with the two selected titles in a blog_titles list"><figcaption><p>Référencer les valeurs sélectionnées.</p></figcaption></figure>

En d’autres termes, `{{step_3.output.blog_titles}}` dans l’exemple ci-dessus, donne à l’utilisateur une liste de titres d’articles de blog. Si vous souhaitez ne référencer que le premier titre d’article de blog, vous devrez modifier votre syntaxe en `{{step_3.output.blog_titles[0]}}`.

## Session de révision

Lorsqu’un workflow atteint l’étape de révision, l’exécution est mise en pause, le workflow reste dans un état en attente de révision, et une session de révision est créée où l’utilisateur peut examiner le contenu.

### Comment réviser la sortie

* **Pour les éléments uniques,** vous pouvez modifier le contenu en utilisant *markdown* la syntaxe.
* **Pour plusieurs valeurs,** vous pouvez modifier les valeurs et les sélectionner/désélectionner.
* Après modification, vous pouvez soit choisir d’accepter le contenu révisé, soit annuler l’exécution.

### Réviser dans le panneau de test

Lorsque vous testez votre workflow, vous pouvez accéder à la session de révision en cliquant sur « Réviser » :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-50250d9fd1b4d86c00869377481d1f4d5907c7f5%2Fhuman-review-step-09-test-panel.png?alt=media" alt="Logs tab of a test run with the review banner and a Review Content button, and the Human Review step marked Needs Review"><figcaption><p>Révision dans le panneau de test.</p></figcaption></figure>

### Réviser en temps réel lors d’une exécution unique

Lorsque vous lancez une exécution unique, la session de révision apparaîtra automatiquement, et votre utilisateur pourra examiner les sorties en temps réel :

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f3d327e0755401ecfd40b3459f3f3da72af539b5%2Fhuman-review-step-10-run-once.png?alt=media" alt="Run Once page of the Launch Blog Title Picker with the Review Needed panel listing blog titles to select"><figcaption><p>Révision lors d’une exécution unique.</p></figcaption></figure>

### Révision asynchrone dans l’historique

Pour réviser les exécutions de manière asynchrone, vous pouvez les consulter dans l’ **Historique** onglet :

1. Cliquez sur **Historique** pour afficher toutes les exécutions
2. Filtrez la **Statut** à **Révision requise**
3. Cliquez sur **Afficher** dans la colonne Actions
4. Cliquez sur **Examiner** pour examiner la sortie et poursuivre l’exécution

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-734c757f05f6eaaf361010983bad2c6814926971%2Fhuman-review-step-11-history.png?alt=media" alt="History tab with an execution marked Review needed and its Details tab open on Review Content"><figcaption><p>Révision depuis l’onglet Historique.</p></figcaption></figure>


---

# 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/workflow-concepts/workflow-steps/flow/human-review.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.
