> 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/playbooks/run-a-playbook.md).

# Executar um Playbook

Execute Playbooks manualmente, a partir de Grids ou com Triggers

Pode executar um Playbook manualmente no editor, a partir de uma Grid ou automaticamente com um Trigger. Cada execução cria uma Sessão com detalhes de execução e Artefactos.

## Executar manualmente

Use uma execução manual quando estiver a testar um Playbook ou a executá-lo para um único caso de utilização.

1. Abra o editor de Playbook.
2. Clique em **Executar Playbook**.
3. Forneça quaisquer Inputs necessários.
4. Revise o resultado da Sessão e os Artefactos.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-668e8ceeb89da177a56995e3337f0812686cc19f%2Frun-playbook-01-run-inputs.png?alt=media" alt="Enter Inputs panel for a Playbook run with page URL, target prompt, refresh brief, and Brand Kit Inputs, Advanced Settings, and the Fast and Max mode toggle in the header"><figcaption><p>Forneça os Inputs necessários ao executar um Playbook.</p></figcaption></figure>

{% hint style="info" %}
As execuções iniciadas a partir do editor do Playbook usam tarefas de teste antes das tarefas de produção. Cada workspace tem 50.000 tarefas de teste gratuitas por mês que podem ser usadas para teste de Workflow e Playbook. Se o seu workspace usar todas as tarefas de teste, a AirOps usa tarefas de produção para execuções adicionais no editor. Pode rever a utilização de tarefas de teste em **Utilização** guia da Campanha.
{% endhint %}

## Executar a partir de uma Grid

Use uma Grid quando quiser executar um Playbook publicado em linhas de dados estruturados.

1. Abra a Grid.
2. Clique em **+ Adicionar Coluna**.
3. Selecione o **Playbooks** guia da Campanha.
4. Procure o Playbook.
5. Mapeie colunas da Grid, valores estáticos ou Brand Kits para os Inputs do Playbook.
6. Execute o Playbook para uma linha ou em massa.

{% hint style="info" %}
Quando um Playbook é executado a partir de uma Grid, usa a versão e os mapeamentos de Input configurados nessa coluna da Grid. As edições que fizer no chat da Sessão aplicam-se aos Artefactos, não ao Playbook. Para alterar o próprio Playbook, abra-o no editor.
{% endhint %}

Veja [Executar Playbooks na Grid](https://docs.airops.com/docs/pt/acoes/grids/run-playbooks-in-grid.md) para seleção de versão, execuções em massa, estado da Sessão e revisão de Artefactos.

### Voltar à Grid de origem

Depois de abrir um Playbook a partir de uma Grid, selecione **Voltar à Grid** nas ações rápidas do editor para regressar à folha de origem. Se abriu o Playbook diretamente, a AirOps regressa à sua Grid ligada ou oferece um seletor quando existem várias Grids ligadas. A opção fica oculta quando não existem Grids ligadas ativas.

## Executar automaticamente

Use um Trigger quando o Playbook deva iniciar numa agenda, a partir de um evento externo ou de um sinal da AirOps.

Os tipos de Trigger incluem:

* **Agenda:** Executar numa cadência recorrente.
* **Webhook:** Executar a partir de um pedido HTTP.
* **Monitor:** Executar quando o Parallel Web Systems detetar uma condição da sua consulta de monitorização.
* **AEO Insight:** Executar quando for atingido um limite de Insights ativado.

As execuções acionadas aparecem no Histórico de Execuções. As execuções que necessitam de Revisão Humana também aparecem na Caixa de Entrada.

{% hint style="info" %}
Para configuração de Trigger, definições de versão e exemplos de payload do webhook, consulte [Acionadores de Playbook](https://docs.airops.com/docs/pt/acoes/playbooks/triggers.md).
{% endhint %}

## Versões e alterações de Inputs

As colunas da Grid e os Triggers podem usar **Predefinido** ou uma versão fixada do Playbook.

* **Predefinido** segue a versão publicada atual.
* **Fixado** continua a usar a versão selecionada até a alterar.

{% hint style="warning" %}
Se uma nova versão do Playbook alterar os Inputs, atualize quaisquer mapeamentos de colunas da Grid e a configuração de Inputs do Trigger antes de executar em escala. Novos Inputs obrigatórios sem valores mapeados ou configurados podem fazer com que as execuções falhem na validação ou sejam ignoradas.
{% endhint %}

## Rever Sessões

Cada execução produz uma Sessão. Uma Sessão contém:

* O registo completo de execução.
* Inputs usados na execução.
* O modelo utilizado e os respetivos detalhes de raciocínio, quando disponíveis.
* A **Rápido** ou **Máximo** modo de execução, mostrado na Sessão **Detalhes**. Ver [Escolha um modo de execução](https://docs.airops.com/docs/pt/acoes/playbooks/build-a-playbook.md#choose-an-execution-mode).
* Todos os Artefactos produzidos pelo Playbook.
* estado de 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-024ac77ad6972adc41ca7777511390c7e7f7f923%2Frun-playbook-02-session-details.png?alt=media" alt="Playbook Session Details with status, version, Max mode, time, runtime, tasks, UUID, source, and model"><figcaption><p>Os Detalhes da Sessão registam como uma execução do Playbook foi configurada.</p></figcaption></figure>

As Sessões são visíveis em **Histórico de execuções** no canto superior direito do editor do Playbook e na Caixa de Entrada quando é necessária revisão.

A atividade da Sessão também mostra o progresso da revisão. A atividade do revisor é agrupada sob a tentativa de verificação que a produziu, enquanto as correções feitas pelo agente principal permanecem na linha temporal principal. Pode rever esta atividade durante uma execução ou depois de atualizar a Sessão.

## Colaborar nos Artefactos

Os Artefactos suportam comentários, sugestões, menções, histórico de versões e edições assistidas por IA. Use estes controlos quando o resultado da Sessão precisar de revisão antes da publicação ou utilização a jusante. As edições afetam o Artefacto dessa Sessão, não as instruções do Playbook.

Veja [Artefactos](https://docs.airops.com/docs/pt/acoes/playbooks/artifacts.md) para a colaboração completa, recuperação, ligação estável e fluxo de trabalho da Grid.

## Interromper ou voltar a executar uma Sessão da Grid

Se uma Sessão estiver marcada como **Arquivada**, pode rever o respetivo histórico e artefactos, mas não pode enviar novas mensagens para a mesma. Inicie uma nova Sessão para continuar o trabalho.

Numa Grid, as células do Playbook mostram o estado atual da Sessão. Pode abrir a Sessão a partir da célula, interromper uma Sessão em fila ou em execução e voltar a executar Sessões terminais. Se uma Sessão tiver sido executada numa versão anterior do Playbook, a célula mostra um aviso para que a possa voltar a executar na versão atual.

## Use dois Playbooks para monitorização e ação

Muitas configurações de Playbook usam um padrão de dois Playbooks.

O primeiro Playbook monitoriza dados e encontra trabalho para si. Pode ser executado num Trigger, analisar a AirOps Insights, identificar oportunidades e enviá-las para uma Grid com o AirOps MCP, como URLs para atualizar ou prompts para direcionar.

O segundo Playbook age sobre essas linhas e produz o resultado. Pode executá-lo manualmente ou como uma ação da Grid na linha produzida pelo primeiro Playbook, como redigir uma publicação de blogue para um prompt-alvo ou atualizar uma página existente.

Um Playbook encontra o trabalho. O outro Playbook faz o trabalho e leva-o a um resultado. Pode usar qualquer um dos padrões isoladamente, mas são frequentemente compostos.

Para evitar repetir trabalho entre execuções, registe os itens concluídos numa Grid e faça com que o Playbook de monitorização verifique esse registo antes de recomendar novo trabalho.


---

# 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/playbooks/run-a-playbook.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.
