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

# Revisão Humana

Exija revisão humana dos resultados antes de continuar um workflow

<figure><img src="https://31915162-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>A Revisão Humana pausa um workflow até que alguém reveja o resultado.</p></figcaption></figure>

Com a etapa de Revisão Humana, o utilizador pode ser solicitado a rever, validar e editar um valor de texto (*Item Único*) ou selecionar e editar vários valores (*Vários Valores*) antes de continuar um workflow.

Por exemplo, poderia criar uma lista de 5 títulos de blog para o utilizador escolher, pedir ao utilizador para rever e selecionar os títulos a publicar com uma etapa de revisão e, por fim, publicar o conteúdo selecionado no seu blog.

## Canais de notificações do Slack

Pode enviar notificações de revisão para um canal público ou para um canal privado ao qual o bot da AirOps tenha aderido. Convide o bot para um canal privado antes de o selecionar. Os canais recém-aderidos podem demorar até cinco minutos a aparecer no seletor.

## Rever um Item Único

### O que é um Item Único?

O item único permite que o utilizador edite o texto de uma caixa de texto de uma linha:

<figure><img src="https://31915162-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>Revisão de Item Único.</p></figcaption></figure>

### Como Configurar um Item Único

1. **Atribua uma etiqueta ao item:** a etiqueta criará automaticamente o nome da variável associado à sua etiqueta. No exemplo abaixo, etiquetamos o nosso item "Blog Title", o que também criou a variável `blog_title`
2. **Atribua o valor do item:** use a sintaxe Liquid para passar o valor que pretende que o utilizador edite e reveja. No exemplo abaixo, este é `{{step_2.output}}`
3. **(Opcional) Notifique um canal do Slack:** escolha um canal do Slack que notificará os utilizadores para rever o resultado

<figure><img src="https://31915162-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>Configuração de Item Único.</p></figcaption></figure>

## Rever Vários Valores

### O que são Vários Valores?

Vários valores permitem ao utilizador selecionar e editar vários valores de uma só vez:

<figure><img src="https://31915162-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>Revisão de seleção múltipla.</p></figcaption></figure>

### Como Configurar Vários Valores

1. Configure uma lista de opções:

   1. **Gere uma lista:** use uma etapa de LLM para gerar uma lista de itens; tem de ser um Array

      <figure><img src="https://31915162-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>Uma lista de cinco títulos de blog.</p></figcaption></figure>
   2. **Atribua uma etiqueta ao item:** a etiqueta criará automaticamente o nome da variável associado à sua etiqueta. No exemplo abaixo, etiquetamos o nosso item "Blog Titles", o que também criou a variável `blog_titles`
   3. **Atribua o valor do item:** use a sintaxe Liquid para passar a lista que gerou na Etapa 1. No exemplo abaixo, este é `{{step_2.output}}`
   4. **(Opcional) Notifique um canal do Slack:** escolha um canal do Slack que notificará os utilizadores para rever o resultado

   <figure><img src="https://31915162-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>Configuração de Seleção Múltipla (Lista de Caixas de Seleção).</p></figcaption></figure>

## Referenciar a Etapa de Revisão Humana

### Como Referenciar um Item Único

Para referenciar um item único a partir da etapa de Revisão Humana, use a variável correspondente à etiqueta que forneceu.

Neste exemplo, demos ao item o nome "Blog Title", o que criou a variável `{{step_3.output.blog_title}}` :

<figure><img src="https://31915162-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>Referência de um Item Único.</p></figcaption></figure>

### Como Referenciar Vários Valores

Para referenciar vários valores a partir da etapa de Revisão Humana, use a variável correspondente à etiqueta que forneceu.

No entanto, ao contrário de referenciar um item único, o resultado de uma revisão de vários valores é uma lista:

<figure><img src="https://31915162-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>Referenciar os valores selecionados.</p></figcaption></figure>

Por outras palavras, `{{step_3.output.blog_titles}}` do exemplo acima dá ao utilizador uma lista de títulos de blog. Se quiser referenciar apenas o primeiro título de blog, terá de modificar a sua sintaxe para `{{step_3.output.blog_titles[0]}}`.

## Sessão de Revisão

Quando um workflow chega à etapa de revisão, pausa a execução, deixa o workflow num estado pendente para revisão e cria uma sessão de revisão onde o utilizador pode rever o conteúdo.

### Como Rever o Resultado

* **Para itens únicos,** pode editar o conteúdo usando *markdown* sintaxe.
* **Para vários valores,** pode editar os valores e selecioná-los/deselecioná-los.
* Depois de editar, pode escolher aceitar o conteúdo revisto ou cancelar a execução.

### Rever no Painel de Teste

À medida que testa o seu workflow, pode aceder à sessão de revisão clicando em "Rever":

<figure><img src="https://31915162-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>Rever no painel de teste.</p></figcaption></figure>

### Rever em Tempo Real ao Executar Uma Vez

Quando executa uma vez, a sessão de revisão aparecerá automaticamente, e o seu utilizador pode rever os resultados em tempo real:

<figure><img src="https://31915162-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>Rever ao executar uma vez.</p></figcaption></figure>

### Rever de Forma Assíncrona no Histórico

Para rever execuções de forma assíncrona, pode revê-las no **Histórico** separador:

1. Clique em **Histórico** para ver todas as execuções
2. Filtre a **Status** para **Revisão necessária**
3. Clique em **Ver** na coluna Ações
4. Clique em **Rever** para rever o resultado e continuar a execução

<figure><img src="https://31915162-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>Rever no separador Histórico.</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/pt/acoes/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.
