> 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/grids/run-playbooks-in-grid.md).

# Executar Playbooks na Grid

Execute um Playbook publicado nas linhas do Grid e reveja cada Session e Artifact.

Use uma coluna de Playbook para executar o mesmo Playbook publicado em várias linhas de dados estruturados. Cada execução cria uma Sessão, e os Artefactos declarados permanecem ligados a essa Sessão para revisão e edição.

## Como configurar uma coluna de Playbook

1. Abra a Grid.
2. Clique em **+ Adicionar Coluna**.
3. Selecione o **Playbooks** separador.
4. Procure e selecione um Playbook publicado.
5. Associe cada entrada do Playbook a uma coluna da Grid, valor estático ou Brand Kit.
6. Guarde a coluna.

Se o espaço de trabalho não tiver Playbooks publicados, o **Playbooks** separador não tem um Playbook para adicionar.

## Opções de configuração

| Opção                  | Descrição                                                                                                              |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Playbook               | O Playbook publicado que é executado para cada linha selecionada.                                                      |
| Versão                 | **Predefinição** segue a versão publicada atual. Uma versão fixada continua a usar a versão selecionada até a alterar. |
| Mapeamento de entradas | Ligue cada entrada do Playbook a uma coluna da Grid, valor estático ou Brand Kit.                                      |

{% hint style="warning" %}
Quando uma nova versão do Playbook altera as suas entradas, atualize os mapeamentos das colunas da Grid antes de o executar em escala. Entradas obrigatórias em falta podem fazer com que as execuções falhem na validação ou sejam ignoradas.
{% endhint %}

## Executar o Playbook

Execute o Playbook numa linha enquanto testa os mapeamentos de entrada e a saída. Quando o resultado estiver correto, execute a coluna do Playbook em massa nas linhas que pretende processar.

A Grid usa a versão e os mapeamentos de entrada configurados na coluna do Playbook. As edições feitas numa Sessão aplicam-se aos Artefactos dessa Sessão, não ao próprio Playbook. Abra o editor do Playbook para alterar as instruções.

## Rever Sessões e Artefactos

Cada célula do Playbook mostra o respetivo estado atual da Sessão. Abra a célula para rever a Sessão, incluindo:

* As entradas usadas para a execução
* O registo de execução
* Todos os Artefactos produzidos pelo Playbook
* Estado de Revisão Humana, quando o Playbook inclui blocos de revisão

Pode interromper uma Sessão em fila ou em execução e voltar a executar uma Sessão terminal. Quando uma Sessão usou uma versão mais antiga do Playbook, a célula mostra um aviso para que a possa voltar a executar na versão atual.

As colunas de Artefactos guardam os Artefactos do Playbook diretamente na Grid. A célula da Grid e a Sessão referem o mesmo Artefacto, pelo que as edições de qualquer um dos locais permanecem sincronizadas.

## Exemplo

### Executar um Playbook de atualização de conteúdo

1. Adicione o URL da página, o prompt-alvo e qualquer contexto de apoio a colunas separadas da Grid.
2. Adicione uma coluna de Playbook e selecione o seu Playbook publicado de atualização de conteúdo.
3. Associe as entradas do Playbook às colunas correspondentes da Grid e ao Brand Kit.
4. Execute uma linha e reveja a respetiva Sessão e os seus Artefactos.
5. Corrija quaisquer mapeamentos de entrada ou atualize as instruções do Playbook.
6. Execute a coluna do Playbook nas linhas restantes.


---

# 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/grids/run-playbooks-in-grid.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.