> ## 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 y Runbooks

> Automatiza tus operaciones con Books: Runbooks reutilizables y Playbooks orquestados que puedes crear en lenguaje natural, programar y ejecutar — con la IA haciendo el trabajo.

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

**Books** es donde conviertes lo que haces a mano en automatización repetible. Describes lo que quieres en lenguaje natural, Myrmex arma un workflow revisable y — una vez que lo apruebas — los agentes lo ejecutan en un horario, bajo demanda o desde un webhook. Dos bloques de construcción lo forman: **Runbooks** y **Playbooks**.

<Note>
  Abre Books desde la acción rápida **Automation** en el [Directory](/es/documentation/ai-workspace/overview).
  Se abre en el Workspace con dos pestañas — **Playbooks** y **Runbooks** — y un
  único botón **Automation** para crear algo nuevo.
</Note>

## Runbooks vs. Playbooks

<CardGroup cols={2}>
  <Card title="Runbook — el paso reutilizable" icon="file-lines">
    Un procedimiento único y autocontenido: una instrucción en lenguaje natural
    para la IA, una acción de herramienta, o un script en sandbox. La unidad
    atómica con la que compones.
  </Card>

  <Card title="Playbook — la orquestación" icon="diagram-project">
    Un workflow que encadena runbooks en orden, pasando la salida de cada paso al
    siguiente, y adjunta un **trigger** (agenda, webhook, o bajo demanda). Esta es
    la automatización que efectivamente se ejecuta.
  </Card>
</CardGroup>

### Tipos de runbook

Un runbook es de uno de estos tipos, así que un paso puede ser tan simple como un prompt o tan preciso como una única llamada de API:

| Tipo                | Qué hace                                                                                                                                                                           |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Centurion (LLM)** | Una instrucción en lenguaje natural que la IA ejecuta — el tipo más flexible. Escríbelo como lo pedirías en el chat, `@`-mencionando dispositivos e integraciones.                 |
| **Tool**            | Una acción de catálogo contra una integración — un verbo específico (enriquecer una offense, listar alertas, abrir un ticket) ejecutado en un modo elegido con parámetros tipados. |
| **Script**          | Un procedimiento en Go en sandbox (`Run(ctx)`) para lógica determinística, limitado a una allowlist de integraciones que tú especificas.                                           |

## Construyendo un Playbook

Un playbook es un workflow visual. Sus pasos son runbooks dispuestos de arriba hacia abajo; el trigger va al inicio.

<Steps>
  <Step title="Agrega los pasos">
    Agrega runbooks como pasos — una instrucción Centurion, una acción de tool o
    un script. Se ejecutan en orden, y cada paso puede referenciar la salida de un
    paso anterior con bindings `{{steps.N.output...}}`.
  </Step>

  <Step title="Agrega condiciones (opcional)">
    Un paso puede hacer **loop** sobre una lista (`for each`), ejecutarse solo
    **si** una condición se cumple, o **detener** el playbook cuando una se
    cumple — para que el workflow se adapte a lo que encuentra.
  </Step>

  <Step title="Elige un trigger">
    Decide cómo inicia el playbook (ver abajo).
  </Step>

  <Step title="Define el service user">
    Un playbook se ejecuta como un **service user** que tú eliges — la identidad
    cuyo acceso y aprobaciones usan sus acciones. Un playbook no puede
    ejecutarse hasta que se defina uno.
  </Step>

  <Step title="Guarda y ejecuta">
    Guarda el playbook y ejecútalo — manualmente, o deja que su trigger lo
    dispare.
  </Step>
</Steps>

<Warning>
  Los pasos que **cambian** un sistema (cerrar un ticket, aislar un host,
  bloquear una dirección) se marcan como **WRITES** en el editor. La
  automatización sigue respetando las salvaguardas de Myrmex — revisa lo que
  hace un playbook antes de habilitarlo.
</Warning>

### Triggers

<CardGroup cols={2}>
  <Card title="Bajo demanda" icon="play">
    Se ejecuta solo cuando lo inicias. No consume slots de agenda.
  </Card>

  <Card title="Agenda recurrente" icon="calendar-days">
    Se ejecuta en un intervalo — desde **cada minuto** hasta horario, diario,
    semanal o mensual — con una hora de inicio y una fecha final opcional.
  </Card>

  <Card title="Agenda única" icon="calendar-day">
    Se ejecuta una vez, en una fecha y hora que tú eliges.
  </Card>

  <Card title="Webhook" icon="link">
    Se ejecuta cuando un sistema externo llama a la URL de webhook del playbook —
    útil para conectar Myrmex con tus propias herramientas.
  </Card>
</CardGroup>

<Note>
  Los playbooks programados y recurrentes reservan **slots de calendario**; las
  ejecuciones bajo demanda no. Mantén un playbook **persistente** para retenerlo
  después de ejecutarse — de lo contrario una ejecución única se limpia
  automáticamente.
</Note>

## Crea en Lenguaje Natural

No tienes que construir un workflow a mano. El composer **Automation** convierte una descripción en un playbook listo para revisar:

<Steps>
  <Step title="Describe la automatización">
    Escribe lo que quieres — por ejemplo, *"Por cada offense abierta en `@qradar`,
    enriquécela y abre un incidente en `@mi-itsm`."* `@`-menciona al menos un
    **dispositivo o integración**; menciona **tools** también, o deja que
    Myrmex elija las correctas.
  </Step>

  <Step title="Myrmex lo arma">
    La IA genera un playbook borrador y sus runbooks, con un resumen del plan y
    los supuestos que hizo. Esto se ejecuta de forma asíncrona y puede tardar unos
    minutos — puedes seguir trabajando.
  </Step>

  <Step title="Revisa el borrador">
    El resultado se renderiza como una vista previa del workflow que puedes leer
    paso a paso — sin necesidad de abrir el editor. Si Myrmex necesita más
    detalles, primero hace preguntas de aclaración.
  </Step>

  <Step title="Approve & enable">
    **Discard**, **Edit steps** en el editor completo, o **Approve & enable**
    para activarlo. Una automatización generada se queda como **borrador** hasta
    que la apruebas.
  </Step>
</Steps>

<Tip>
  Los playbooks generados son borradores a propósito — nada de lo que la IA
  escribe se ejecuta hasta que lo hayas leído y hayas hecho clic en **Approve &
  enable**.
</Tip>

## Ejecutando y Rastreando

Ejecuta un playbook desde su trigger, desde la acción **Run** en el directorio, o en su agenda. Cada ejecución transmite su progreso — el paso actual, la salida del agente y las llamadas de tool, y el uso de tokens — y toda ejecución se conserva en el **historial de ejecución** del playbook para que veas qué pasó y cuándo.

## Quién Puede Usar Books

Books está gobernado por sus propios permisos, para que puedas separar la autoría de la ejecución:

| Permiso                                            | Otorga                                    |
| -------------------------------------------------- | ----------------------------------------- |
| `books.playbooks.read` / `books.runbooks.read`     | Ver playbooks y runbooks.                 |
| `books.playbooks.create` / `books.runbooks.create` | Crear nuevos playbooks y runbooks.        |
| `books.playbooks.run` / `books.runbooks.run`       | Ejecutar playbooks y runbooks existentes. |

<Note>
  La automatización forma parte de las capacidades avanzadas de Myrmex —
  agenda, ejecución ilimitada, intervalos por minuto y slots extra de playbook
  varían por plan. Consulta [Planes y Licenciamiento](/es/documentation/get-started/license)
  para lo que está incluido.
</Note>

## Relacionado

<CardGroup cols={2}>
  <Card title="Gestión de Cambios" icon="clipboard-check" href="/es/documentation/change-management/overview">
    Para cambios gobernados con aprobación y despliegue de parches.
  </Card>

  <Card title="El Workspace de IA" icon="comments" href="/es/documentation/ai-workspace/overview">
    Donde hablas con los agentes y `@`-mencionas los dispositivos y tools que usan tus automatizaciones.
  </Card>
</CardGroup>