> 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 Playbook para executar o mesmo Playbook publicado em linhas de dados estruturados. Cada execução cria uma Session, e os Artifacts declarados permanecem ligados a essa Session para revisão e edição.

## Como configurar uma coluna Playbook

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

Se o workspace não tiver Playbooks publicados, o **Playbooks** separador não tem nenhum 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é que a altere. |
| Mapeamento de inputs | Ligue cada Input do Playbook a uma coluna da Grid, valor estático ou Brand Kit.                                           |

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

## Executar o Playbook

Execute o Playbook para uma linha enquanto testa os seus mapeamentos de Input e o resultado. Assim que o resultado estiver correto, execute a coluna Playbook em massa nas linhas que pretende processar.

A Grid usa a versão e os mapeamentos de Input configurados na coluna Playbook. As edições feitas numa Session aplicam-se aos Artifacts dessa Session, não ao Playbook em si. Abra o editor do Playbook para alterar as suas instruções.

## Rever Sessions e Artifacts

Cada célula do Playbook mostra o estado atual da sua Session. Abra a célula para rever a Session, incluindo:

* Os Inputs usados para a execução
* O registo de execução
* Cada Artifact produzido pelo Playbook
* Estado da Revisão Humana, quando o Playbook inclui blocos de revisão

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0b7b2dc3a6d0a62163dd1b062c43bc1bdb7ec6df%2Fgrid-playbook-01-session-from-cell.png?alt=media" alt="Playbook cell opened from a Grid row, showing the Refreshed Article Artifact with Agent Notes, Inputs, and Details"><figcaption><p>Abra uma célula do Playbook para rever o Artifact, os Inputs e os Detalhes dessa linha.</p></figcaption></figure>

Pode interromper uma Session em fila ou em execução e voltar a executar uma Session terminal. Quando uma Session 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 Artifact guardam os Artifacts do Playbook diretamente na Grid. A célula da Grid e a Session referem-se ao mesmo Artifact, por isso as edições feitas em qualquer uma das localizações mantêm-se sincronizadas.

## Exemplo

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

1. Adicione o URL da página, o prompt de destino e qualquer contexto de apoio a colunas separadas da Grid.
2. Adicione uma coluna Playbook e selecione o seu Playbook publicado de atualização de conteúdo.
3. Mapeie os Inputs do Playbook para as colunas correspondentes da Grid e o Brand Kit.
4. Execute uma linha e reveja a sua Session e os seus Artifacts.
5. Corrija quaisquer mapeamentos de Input ou atualize as instruções do Playbook.
6. Execute a coluna 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.
