> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Books — Playbooks e Runbooks

> Automatize suas operações com Books: Runbooks reutilizáveis e Playbooks orquestrados que você pode criar em linguagem natural, agendar e executar — com a IA fazendo o trabalho.

import { CardGroup, Card, Note, Tip, Warning, Steps, Step } from '@mintlify/components';

**Books** é onde você transforma o que faz à mão em automação repetível. Você descreve o que quer em linguagem natural, o Myrmex monta um workflow revisável e — uma vez aprovado — os agentes rodam num agendamento, sob demanda ou a partir de um webhook. Dois blocos de construção o compõem: **Runbooks** e **Playbooks**.

<Note>
  Abra Books pela ação rápida **Automation** no [Directory](/pt/documentation/ai-workspace/overview).
  Ele abre no Workspace com duas abas — **Playbooks** e **Runbooks** — mais um
  único botão **Automation** para criar algo novo.
</Note>

## Runbooks vs. Playbooks

<CardGroup cols={2}>
  <Card title="Runbook — o passo reutilizável" icon="file-lines">
    Um procedimento único e autocontido: uma instrução em linguagem natural para a
    IA, uma ação de ferramenta, ou um script em sandbox. A unidade atômica com a
    qual você compõe.
  </Card>

  <Card title="Playbook — a orquestração" icon="diagram-project">
    Um workflow que encadeia runbooks em ordem, passando a saída de cada passo
    para o próximo, e anexa um **trigger** (agendamento, webhook ou sob demanda).
    Essa é a automação que efetivamente roda.
  </Card>
</CardGroup>

### Tipos de runbook

Um runbook é de um destes tipos, então um passo pode ser tão simples quanto um prompt ou tão preciso quanto uma única chamada de API:

| Tipo                | O que faz                                                                                                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Centurion (LLM)** | Uma instrução em linguagem natural que a IA executa — o tipo mais flexível. Escreva como se estivesse pedindo no chat, `@`-mencionando dispositivos e integrações.              |
| **Tool**            | Uma ação de catálogo contra uma integração — um verbo específico (enriquecer uma offense, listar alertas, abrir um ticket) executado num modo escolhido com parâmetros tipados. |
| **Script**          | Um procedimento em Go em sandbox (`Run(ctx)`) para lógica determinística, limitado a uma allowlist de integrações que você especifica.                                          |

## Construindo um Playbook

Um playbook é um workflow visual. Seus passos são runbooks dispostos de cima para baixo; o trigger fica no início.

<Steps>
  <Step title="Adicione os passos">
    Adicione runbooks como passos — uma instrução Centurion, uma ação de tool ou
    um script. Eles rodam em ordem, e cada passo pode referenciar a saída de um
    passo anterior com `{{steps.N.output...}}` bindings.
  </Step>

  <Step title="Adicione condições (opcional)">
    Um passo pode fazer **loop** sobre uma lista (`for each`), rodar apenas **se**
    uma condição valer, ou **parar** o playbook quando uma valer — para que o
    workflow se adapte ao que encontra.
  </Step>

  <Step title="Escolha um trigger">
    Decida como o playbook começa (veja abaixo).
  </Step>

  <Step title="Defina o service user">
    Um playbook roda como um **service user** que você escolhe — a identidade cujo
    acesso e aprovações suas ações usam. Um playbook não pode rodar até que um
    seja definido.
  </Step>

  <Step title="Salve e execute">
    Salve o playbook e execute — manualmente ou deixe seu trigger disparar.
  </Step>
</Steps>

<Warning>
  Passos que **alteram** um sistema (fecham um ticket, isolam um host, bloqueiam
  um endereço) são marcados como **WRITES** no editor. A automação ainda respeita
  as proteções do Myrmex — revise o que um playbook faz antes de habilitá-lo.
</Warning>

### Triggers

<CardGroup cols={2}>
  <Card title="Sob demanda" icon="play">
    Roda apenas quando você inicia. Não consome slots de agendamento.
  </Card>

  <Card title="Agenda recorrente" icon="calendar-days">
    Roda em um intervalo — de **cada minuto** até horário, diário, semanal ou
    mensal — com um horário de início e uma data final opcional.
  </Card>

  <Card title="Agenda única" icon="calendar-day">
    Roda uma vez, numa data e hora escolhidas.
  </Card>

  <Card title="Webhook" icon="link">
    Roda quando um sistema externo chama a URL de webhook do playbook — útil para
    ligar o Myrmex às suas próprias ferramentas.
  </Card>
</CardGroup>

<Note>
  Playbooks agendados e recorrentes reservam **slots de calendário**; execuções
  sob demanda não. Mantenha um playbook **persistente** para retê-lo depois de
  rodar — caso contrário uma execução única é limpa automaticamente.
</Note>

## Crie em Linguagem Natural

Você não precisa construir um workflow à mão. O composer **Automation** transforma uma descrição num playbook pronto para revisão:

<Steps>
  <Step title="Descreva a automação">
    Escreva o que você quer — por exemplo, *"Para cada offense aberta no `@qradar`,
    enriqueça e abra um incidente no `@meu-itsm`."* `@`-mencione ao menos um
    **dispositivo ou integração**; mencione **tools** também, ou deixe o Myrmex
    escolher as certas.
  </Step>

  <Step title="O Myrmex monta">
    A IA gera um rascunho de playbook e seus runbooks, com um resumo do plano e as
    suposições feitas. Isso roda de forma assíncrona e pode levar alguns minutos —
    você pode continuar trabalhando.
  </Step>

  <Step title="Revise o rascunho">
    O resultado é renderizado como uma prévia de workflow que você lê passo a
    passo — sem precisar abrir o editor. Se o Myrmex precisar de mais detalhes, ele
    pergunta primeiro para esclarecer.
  </Step>

  <Step title="Approve & enable">
    **Discard**, **Edit steps** no editor completo, ou **Approve & enable** para
    ativar. Uma automação gerada permanece como **rascunho** até você aprovar.
  </Step>
</Steps>

<Tip>
  Playbooks gerados são rascunhos de propósito — nada que a IA escreve roda até
  você ter lido e clicado em **Approve & enable**.
</Tip>

## Executando e Acompanhando

Execute um playbook pelo seu trigger, pela ação **Run** no diretório, ou no seu agendamento. Cada execução transmite seu progresso — o passo atual, a saída do agente e as chamadas de tool, e uso de tokens — e toda execução é mantida no **histórico de execução** do playbook para você ver o que aconteceu e quando.

## Quem Pode Usar Books

Books é governado por permissões próprias, para que você possa separar autoria de execução:

| Permissão                                          | Concede                                   |
| -------------------------------------------------- | ----------------------------------------- |
| `books.playbooks.read` / `books.runbooks.read`     | Visualizar playbooks e runbooks.          |
| `books.playbooks.create` / `books.runbooks.create` | Criar novos playbooks e runbooks.         |
| `books.playbooks.run` / `books.runbooks.run`       | Executar playbooks e runbooks existentes. |

<Note>
  Automação faz parte dos recursos avançados do Myrmex — agendamento, execução
  ilimitada, intervalos por minuto e slots extras de playbook variam por plano.
  Veja [Planos e Licenciamento](/pt/documentation/get-started/license) para o que
  está incluído.
</Note>

## Relacionado

<CardGroup cols={2}>
  <Card title="Gestão de Mudanças" icon="clipboard-check" href="/pt/documentation/change-management/overview">
    Para mudanças governadas com aprovação e implantação de patches.
  </Card>

  <Card title="O Workspace de IA" icon="comments" href="/pt/documentation/ai-workspace/overview">
    Onde você conversa com os agentes e `@`-menciona os dispositivos e tools que suas automações usam.
  </Card>
</CardGroup>