> ## 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 — Playbook e Runbook

> Automatizza le tue operazioni con Books: Runbook riutilizzabili e Playbook orchestrati che puoi creare in linguaggio naturale, pianificare ed eseguire — con l'IA a fare il lavoro.

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

**Books** è dove trasformi ciò che fai a mano in automazione ripetibile. Descrivi ciò che vuoi in linguaggio naturale, Myrmex lo assembla in un workflow revisionabile e — una volta approvato — gli agenti lo eseguono su una pianificazione, su richiesta o da un webhook. Due blocchi lo compongono: **Runbook** e **Playbook**.

<Note>
  Apri Books dall'azione rapida **Automation** nel [Directory](/it/documentation/ai-workspace/overview).
  Si apre nel Workspace con due tab — **Playbooks** e **Runbooks** — più un
  singolo pulsante **Automation** per creare qualcosa di nuovo.
</Note>

## Runbook vs. Playbook

<CardGroup cols={2}>
  <Card title="Runbook — il passaggio riutilizzabile" icon="file-lines">
    Una procedura singola e autosufficiente: un'istruzione in linguaggio naturale
    per l'IA, un'azione di tool, o uno script in sandbox. L'unità atomica con cui
    componi.
  </Card>

  <Card title="Playbook — l'orchestrazione" icon="diagram-project">
    Un workflow che concatena i runbook in ordine, passando l'output di ogni
    passaggio al successivo, e vi allega un **trigger** (pianificazione, webhook o
    su richiesta). Questa è l'automazione che effettivamente gira.
  </Card>
</CardGroup>

### Tipi di runbook

Un runbook è di uno di questi tipi, così un passaggio può essere semplice come un prompt o preciso come una singola chiamata API:

| Tipo                | Cosa fa                                                                                                                                                                             |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Centurion (LLM)** | Un'istruzione in linguaggio naturale che l'IA esegue — il tipo più flessibile. Scrivila come chiederesti in chat, `@`-menzionando dispositivi e integrazioni.                       |
| **Tool**            | Un'azione di catalogo verso un'integrazione — un verbo specifico (arricchire una offense, elencare gli alert, aprire un ticket) eseguito in un modo scelto con parametri tipizzati. |
| **Script**          | Una procedura in Go in sandbox (`Run(ctx)`) per logica deterministica, limitata a una allowlist di integrazioni che tu specifichi.                                                  |

## Costruire un Playbook

Un playbook è un workflow visuale. I suoi passaggi sono runbook disposti dall'alto verso il basso; il trigger sta all'inizio.

<Steps>
  <Step title="Aggiungi i passaggi">
    Aggiungi runbook come passaggi — un'istruzione Centurion, un'azione di tool o
    uno script. Girano in ordine, e ogni passaggio può referenziare l'output di
    un passaggio precedente con i binding `{{steps.N.output...}}`.
  </Step>

  <Step title="Aggiungi condizioni (opzionale)">
    Un passaggio può fare **loop** su un elenco (`for each`), girare solo **se**
    una condizione è vera, o **fermare** il playbook quando una lo è — così il
    workflow si adatta a ciò che trova.
  </Step>

  <Step title="Scegli un trigger">
    Decidi come parte il playbook (vedi sotto).
  </Step>

  <Step title="Imposta il service user">
    Un playbook gira come un **service user** che scegli — l'identità il cui
    accesso e approvazioni le sue azioni usano. Un playbook non può girare
    finché non ne è impostato uno.
  </Step>

  <Step title="Salva ed esegui">
    Salva il playbook, poi eseguilo — manualmente, o lascia che il suo trigger lo
    faccia partire.
  </Step>
</Steps>

<Warning>
  I passaggi che **cambiano** un sistema (chiudere un ticket, isolare un host,
  bloccare un indirizzo) sono marcati **WRITES** nell'editor. L'automazione
  rispetta comunque le protezioni di Myrmex — revisiona ciò che un playbook fa
  prima di abilitarlo.
</Warning>

### Trigger

<CardGroup cols={2}>
  <Card title="Su richiesta" icon="play">
    Gira solo quando lo avvii. Non consuma slot di pianificazione.
  </Card>

  <Card title="Pianificazione ricorrente" icon="calendar-days">
    Gira su un intervallo — da **ogni minuto** a orario, giornaliero, settimanale
    o mensile — con un orario di inizio e una data di fine opzionale.
  </Card>

  <Card title="Pianificazione singola" icon="calendar-day">
    Gira una sola volta, in una data e ora scelta da te.
  </Card>

  <Card title="Webhook" icon="link">
    Gira quando un sistema esterno chiama l'URL webhook del playbook — utile per
    collegare Myrmex ai tuoi strumenti.
  </Card>
</CardGroup>

<Note>
  I playbook pianificati e ricorrenti riservano **slot di calendario**; le
  esecuzioni su richiesta no. Mantieni un playbook **persistente** per
  conservarlo dopo l'esecuzione — altrimenti un'esecuzione singola viene ripulita
  automaticamente.
</Note>

## Crea in Linguaggio Naturale

Non devi costruire un workflow a mano. Il composer **Automation** trasforma una descrizione in un playbook pronto per la revisione:

<Steps>
  <Step title="Descrivi l'automazione">
    Scrivi ciò che vuoi — per esempio, *"Per ogni offense aperta su `@qradar`,
    arricchiscila e apri un incident su `@mio-itsm`."* `@`-menziona almeno un
    **dispositivo o integrazione**; menziona anche i **tool**, o lascia che
    Myrmex scelga quelli giusti.
  </Step>

  <Step title="Myrmex lo costruisce">
    L'IA genera un playbook bozza e i suoi runbook, con un riassunto del piano e
    le assunzioni fatte. Questo gira in modo asincrono e può richiedere qualche
    minuto — puoi continuare a lavorare.
  </Step>

  <Step title="Revisiona la bozza">
    Il risultato è mostrato come un'anteprima del workflow che puoi leggere
    passaggio per passaggio — senza bisogno di aprire l'editor. Se Myrmex ha
    bisogno di più dettagli, chiede prima domande di chiarimento.
  </Step>

  <Step title="Approve & enable">
    **Discard**, **Edit steps** nell'editor completo, o **Approve & enable** per
    attivarlo. Un'automazione generata resta una **bozza** finché non la approvi.
  </Step>
</Steps>

<Tip>
  I playbook generati sono bozze di proposito — nulla di ciò che l'IA scrive gira
  finché non l'hai letto e non hai cliccato **Approve & enable**.
</Tip>

## Eseguire e Tracciare

Esegui un playbook dal suo trigger, dall'azione **Run** nel directory, o sulla sua pianificazione. Ogni esecuzione trasmette il suo progresso — il passaggio corrente, l'output dell'agente e le chiamate di tool, e l'uso dei token — e ogni esecuzione è conservata nella **cronologia di esecuzione** del playbook così puoi vedere cosa è successo e quando.

## Chi Può Usare Books

Books è governato dai suoi permessi, così puoi separare la creazione dall'esecuzione:

| Permesso                                           | Concede                                |
| -------------------------------------------------- | -------------------------------------- |
| `books.playbooks.read` / `books.runbooks.read`     | Visualizzare playbook e runbook.       |
| `books.playbooks.create` / `books.runbooks.create` | Creare nuovi playbook e runbook.       |
| `books.playbooks.run` / `books.runbooks.run`       | Eseguire playbook e runbook esistenti. |

<Note>
  L'automazione fa parte delle capacità avanzate di Myrmex — pianificazione,
  esecuzione illimitata, intervalli al minuto e slot playbook extra variano per
  piano. Vedi [Piani e Licenze](/it/documentation/get-started/license) per cosa è
  incluso.
</Note>

## Correlato

<CardGroup cols={2}>
  <Card title="Gestione delle Modifiche" icon="clipboard-check" href="/it/documentation/change-management/overview">
    Per modifiche governate con approvazione e rollout di patch.
  </Card>

  <Card title="Il Workspace IA" icon="comments" href="/it/documentation/ai-workspace/overview">
    Dove parli con gli agenti e `@`-menzioni i dispositivi e i tool usati dalle tue automazioni.
  </Card>
</CardGroup>
