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

# Ejecutar un Playbook

Ejecuta Playbooks manualmente, desde Grids o con desencadenadores

Puede ejecutar un Playbook manualmente desde el editor, desde una Grid o automáticamente con un Trigger. Cada ejecución crea una Session con detalles de ejecución y Artifacts.

## Ejecutar manualmente

Use una ejecución manual cuando esté probando un Playbook o ejecutándolo para un solo caso de uso.

1. Abre el editor del Playbook.
2. Haz clic en **Ejecutar Playbook**.
3. Proporcione los Inputs requeridos.
4. Revise el resultado de la Session y los Artifacts.

<figure><img src="https://3036434873-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>Proporcione los Inputs requeridos cuando ejecute un Playbook.</p></figcaption></figure>

{% hint style="info" %}
Las ejecuciones iniciadas desde el editor de Playbook usan tareas de prueba antes que tareas de producción. Cada espacio de trabajo tiene 50.000 tareas de prueba gratuitas por mes que se pueden usar para pruebas de Workflow y Playbook. Si su espacio de trabajo usa todas las tareas de prueba, AirOps usa tareas de producción para ejecuciones adicionales desde el editor. Puede revisar el uso de tareas de prueba en el **Uso** pestaña de la Campaña.
{% endhint %}

## Ejecutar desde una Grid

Use una Grid cuando quiera ejecutar un Playbook publicado en filas de datos estructurados.

1. Abre la Cuadrícula.
2. Haz clic en **+ Añadir columna**.
3. Selecciona el **Playbooks** pestaña de la Campaña.
4. Busque el Playbook.
5. Asigne columnas de la Grid, valores estáticos o Brand Kits a los Inputs del Playbook.
6. Ejecute el Playbook para una fila o en bloque.

{% hint style="info" %}
Cuando un Playbook se ejecuta desde una Grid, usa la versión y los mapeos de Inputs configurados en esa columna de la Grid. Los cambios que haga en el chat de la Session se aplican a los Artifacts, no al Playbook. Para cambiar el Playbook en sí, ábralo en el editor.
{% endhint %}

Ver [Ejecute Playbooks en la Grid](https://docs.airops.com/docs/es/acciones/grids/run-playbooks-in-grid.md) para la selección de versión, ejecuciones masivas, el estado de la Session y la revisión de Artifacts.

### Volver a la Grid de origen

Después de abrir un Playbook desde una Grid, seleccione **Volver a la Grid** desde las acciones rápidas del editor para volver a la hoja de origen. Si abrió el Playbook directamente, AirOps volverá a su Grid vinculada o mostrará un selector cuando haya varias Grids vinculadas. La opción se oculta cuando no hay Grids vinculadas activas.

## Ejecutar automáticamente

Use un Trigger cuando el Playbook deba iniciarse según una programación, a partir de un evento externo o de una señal de AirOps.

Los tipos de Trigger incluyen:

* **Programación:** Ejecute de forma recurrente.
* **Webhook:** Ejecute a partir de una solicitud HTTP.
* **Monitor:** Ejecute cuando Parallel Web Systems detecte una condición de su consulta de monitorización.
* **Insight de AEO:** Ejecute cuando se alcance un umbral de Insights habilitado.

Las ejecuciones activadas aparecen en Run History. Las ejecuciones que necesitan Human Review también aparecen en la Inbox.

{% hint style="info" %}
Para la configuración de Triggers, los ajustes de versión y ejemplos de carga útil de webhook, consulte [Disparadores de Playbooks](https://docs.airops.com/docs/es/acciones/playbooks/triggers.md).
{% endhint %}

## Cambios de versión y de Inputs

Las columnas de la Grid y los Triggers pueden usar **Predeterminado** o una versión del Playbook fijada.

* **Predeterminado** sigue la versión publicada actual.
* **Fijado** sigue usando la versión seleccionada hasta que la cambie.

{% hint style="warning" %}
Si una nueva versión del Playbook cambia los Inputs, actualice cualquier mapeo de columnas de la Grid y la configuración de Inputs del Trigger antes de ejecutar a escala. Los nuevos Inputs obligatorios sin valores mapeados o configurados pueden hacer que las ejecuciones fallen en la validación o se omitan.
{% endhint %}

## Revisar Sessions

Cada ejecución produce una Session. Una Session contiene:

* El registro completo de ejecución.
* Los Inputs utilizados para la ejecución.
* El modelo utilizado y sus detalles de razonamiento, cuando estén disponibles.
* La **Rápido** o **Máximo** modo de ejecución, mostrado en la Session **Detalles**. Consulte [Elige un modo de ejecución](https://docs.airops.com/docs/es/acciones/playbooks/build-a-playbook.md#choose-an-execution-mode).
* Cada Artifact que produjo el Playbook.
* El estado de Human Review, cuando el Playbook incluye bloques de revisión.

<figure><img src="https://3036434873-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>Los detalles de la Session registran cómo se configuró una ejecución del Playbook.</p></figcaption></figure>

Las Sessions son visibles en **Historial de ejecuciones** desde la parte superior derecha del editor de Playbook y en la Inbox cuando se requiere revisión.

La actividad de la Session también muestra el progreso de la revisión. La actividad del revisor se agrupa bajo el intento de comprobación que la produjo, mientras que las correcciones realizadas por el agente principal permanecen en la cronología principal. Puede revisar esta actividad durante una ejecución o después de actualizar la Session.

## Colabore en los Artifacts

Los Artifacts admiten comentarios, sugerencias, menciones, historial de versiones y ediciones asistidas por IA. Use estos controles cuando el resultado de una Session necesite revisión antes de publicarse o utilizarse aguas abajo. Las ediciones afectan al Artifact de esa Session, no a las instrucciones del Playbook.

Ver [Artefactos](https://docs.airops.com/docs/es/acciones/playbooks/artifacts.md) para la colaboración completa, la recuperación, el enlace estable y el flujo de trabajo de la Grid.

## Interrumpa o vuelva a ejecutar una Session de la Grid

Si una Session está marcada como **Archivada**, puede revisar su historial y sus artifacts, pero no puede enviarle nuevos mensajes. Inicie una nueva Session para continuar el trabajo.

En una Grid, las celdas del Playbook muestran el estado actual de la Session. Puede abrir la Session desde la celda, interrumpir una Session en cola o en ejecución y volver a ejecutar Sessions terminales. Si una Session se ejecutó en una versión anterior del Playbook, la celda muestra una advertencia para que pueda volver a ejecutarla en la versión actual.

## Use dos Playbooks para la monitorización y la acción

Muchas configuraciones de Playbook usan un patrón de dos Playbooks.

El primer Playbook monitorea los datos y encuentra trabajo para usted. Puede ejecutarse con un Trigger, analizar AirOps Insights, identificar oportunidades y enviarlas a una Grid con AirOps MCP, como URLs para actualizar o prompts a los que dirigirse.

El segundo Playbook actúa sobre esas filas y produce el resultado. Puede ejecutarlo manualmente o como una acción de la Grid sobre la fila producida por el primer Playbook, como redactar una entrada de blog para un prompt objetivo o actualizar una página existente.

Un Playbook encuentra el trabajo. El otro Playbook hace el trabajo y le lleva a un resultado. Puede usar cualquiera de los dos patrones por separado, pero normalmente se combinan.

Para evitar repetir trabajo entre ejecuciones, registre los elementos completados en una Grid y haga que el Playbook de monitorización compruebe ese registro antes de recomendar nuevo trabajo.


---

# 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/es/acciones/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.
