> 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 Puedes 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 Usa una ejecución manual cuando estés probando un Playbook o ejecutándolo para un solo caso de uso. 1. Abre el editor de Playbook. 2. Haz clic en **Ejecutar Playbook**. 3. Proporciona cualquier Input requerido. 4. Revisa la salida de la Session y los Artifacts. {% 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 al mes que pueden usarse para pruebas de Workflow y Playbook. Si tu espacio de trabajo usa todas las tareas de prueba, AirOps utiliza tareas de producción para ejecuciones adicionales del editor. Puedes revisar el uso de tareas de prueba en el **Uso** pestaña de la Campaña. {% endhint %} ## Ejecutar desde una Grid Usa una Grid cuando quieras ejecutar un Playbook publicado a través de 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. Busca el Playbook. 5. Asigna columnas de la Grid, valores estáticos o Brand Kits a los Inputs del Playbook. 6. Ejecuta el Playbook para una fila o en masa. {% hint style="info" %} Cuando un Playbook se ejecuta desde una Grid, usa la versión y los mapeos de Input configurados en esa columna de la Grid. Las ediciones que hagas en el chat de la Session se aplican a los Artifacts, no al Playbook. Para cambiar el Playbook en sí, ábrelo en el editor. {% endhint %} Ver [Ejecuta Playbooks en la Grid](/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, selecciona **Volver a Grid** desde las acciones rápidas del editor para volver a la hoja de origen. Si abriste el Playbook directamente, AirOps vuelve a su Grid vinculada o muestra un selector cuando hay varias Grids vinculadas. La opción se oculta cuando no hay Grids vinculadas activas. ## Ejecutar automáticamente Usa un Trigger cuando el Playbook deba iniciarse según un horario, a partir de un evento externo o de una señal de AirOps. Los tipos de Trigger incluyen: * **Programación:** Ejecuta con una cadencia recurrente. * **Webhook:** Ejecuta desde una solicitud HTTP. * **Monitor:** Ejecuta cuando Parallel Web Systems detecta una condición en tu consulta de monitoreo. * **AEO Insight:** Ejecuta cuando se cumple 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 del Trigger, los ajustes de versión y ejemplos de carga útil del webhook, consulta [Disparadores de Playbook](/docs/es/acciones/playbooks/triggers.md). {% endhint %} ## Versiones y cambios de Input Las columnas de la Grid y los Triggers pueden usar **Predeterminado** o una versión fijada del Playbook. * **Predeterminado** sigue la versión publicada actual. * **Fijado** sigue usando la versión seleccionada hasta que la cambies. {% hint style="warning" %} Si una nueva versión del Playbook cambia los Inputs, actualiza cualquier mapeo de columnas de la Grid y la configuración de Inputs del Trigger antes de ejecutar a gran escala. Los nuevos Inputs obligatorios sin valores asignados 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 usados para la ejecución. * El modelo utilizado y los detalles de su razonamiento, cuando estén disponibles. * Cada Artifact que produjo el Playbook. * El estado de Human Review, cuando el Playbook incluye bloques de revisión. Las Sessions son visibles en **Historial de ejecuciones** desde la esquina 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 verificación que la produjo, mientras que las correcciones realizadas por el agente principal permanecen en la línea de tiempo principal. Puedes revisar esta actividad durante una ejecución o después de actualizar la Session. ## Colabora en los Artifacts Los Artifacts admiten comentarios, sugerencias, menciones, historial de versiones y ediciones asistidas por IA. Usa estos controles cuando la salida de una Session necesite revisión antes de publicarla o usarla en procesos posteriores. Las ediciones afectan al Artifact de esa Session, no a las instrucciones del Playbook. Ver [Artefactos](/docs/es/acciones/playbooks/artifacts.md) para la colaboración completa, recuperación, enlace estable y flujo de trabajo de Grid. ## Interrumpir o volver a ejecutar una Session de Grid Si una Session está marcada **Archivada**, puedes revisar su historial y sus artifacts, pero no puedes enviarle nuevos mensajes. Inicia una nueva Session para continuar el trabajo. En una Grid, las celdas del Playbook muestran el estado actual de la Session. Puedes 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ó con una versión anterior del Playbook, la celda muestra una advertencia para que puedas volver a ejecutarla con la versión actual. ## Usa dos Playbooks para monitoreo y acción Muchas configuraciones de Playbook usan un patrón de dos Playbooks. El primer Playbook monitorea datos y encuentra trabajo para ti. Puede ejecutarse con un Trigger, analizar AirOps Insights, identificar oportunidades y enviarlas a una Grid con el AirOps MCP, como URLs para actualizar o prompts a los que dirigirse. El segundo Playbook actúa sobre esas filas y produce la salida. Puedes ejecutarlo manualmente o como una acción de 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 realiza el trabajo y te lleva a una salida. Puedes usar cualquiera de los patrones por separado, pero comúnmente se combinan. {% hint style="info" %} Un Playbook que monitorea datos normalmente usa Memory para evitar recomendar el mismo elemento de nuevo dentro de una ventana configurada, como 60 días. {% endhint %} --- # 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=&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.