> 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.md).

# Playbooks

Crea y ejecuta Playbooks con instrucciones en lenguaje natural

Los Playbooks te permiten describir el trabajo como instrucciones en lenguaje natural, adjuntar contexto como un Kit de marca y ejecutar el proceso de principio a fin manteniendo a los revisores al tanto.

{% hint style="warning" %}
Los Playbooks no se pueden usar dentro de Workflows. Puedes crear un Playbook a partir de un Workflow existente, pero no puedes agregar un Playbook como paso de un Workflow.
{% endhint %}

Un Playbook se compone de:

* **Un Playbook con estilo de documento** que describe lo que el agente debe hacer.
* **Entradas** que el Playbook acepta en tiempo de ejecución, como texto, números, archivos o un Kit de marca.
* **Secciones** que contienen instrucciones, llamadas a herramientas y puntos de control de Revisión humana.
* **Herramientas** que el agente puede usar, incluyendo investigación SEO, investigación web, imagen y video, conectores MCP y más.
* **Artefactos** que el Playbook produce, como archivos Markdown, HTML, JSON, CSV, PNG, JPG o GIF.
* **Disparadores** que determinan cómo comienza un Playbook, incluyendo Programación, Webhook, Monitor y AEO Insight cuando está habilitado.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1f84287eb1edf5ffbbdd31bcc303a5bae367ce29%2Fplaybooks-01-list.png?alt=media" alt="Playbooks tab under Actions listing five SpaceOps Playbooks with their Health, Model, Version, Triggers, and Last Edited details"><figcaption><p>La lista de Playbooks muestra la salud, la versión y los disparadores de cada Playbook.</p></figcaption></figure>

## Conceptos clave

| Término                  | Definición                                                                                                                                                                    |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Playbook                 | La definición del agente con Entradas, Secciones, Herramientas, Artefactos y un Disparador. Ejecutar un Playbook produce una Sesión.                                          |
| Sección                  | Una unidad de trabajo en un Playbook. Cada Sección puede incluir instrucciones, llamadas a herramientas y un bloque de Revisión humana.                                       |
| Entrada                  | Información que proporcionas cuando se ejecuta un Playbook, como una palabra clave, una URL de destino, la carga de un archivo o un Kit de marca.                             |
| Herramienta              | Una acción que el agente puede realizar, desde investigación web y SEO hasta herramientas nativas como Slack y herramientas proporcionadas por conectores MCP.                |
| Artefacto                | Un resultado persistente que produce el Playbook, como una entrada de blog, una imagen, un análisis o datos estructurados.                                                    |
| Disparador               | Una condición que inicia un Playbook automáticamente. Los tipos de disparador incluyen Programación, Webhook, Monitor y AEO Insight cuando está habilitado.                   |
| Sesión                   | Una ejecución única de un Playbook. Cada Sesión produce Artefactos y registra el trabajo que realizó el agente.                                                               |
| Bandeja de entrada       | La cola a nivel del espacio de trabajo donde los revisores ven los pasos pendientes de Revisión humana y los resultados de Sesión que requieren atención.                     |
| Historial de ejecuciones | El registro de cada Sesión que ha producido un Playbook.                                                                                                                      |
| Revisión humana          | Un punto de pausa en el que una persona debe aprobar o editar el trabajo del agente antes de que continúe.                                                                    |
| Quill                    | El capitán agente de AirOps que te ayuda a crear y editar Playbooks a partir de indicaciones en lenguaje natural. Consulta [Quill](https://docs.airops.com/docs/es/quill.md). |

## Las dos fuentes de contexto que impulsan la calidad

Antes de crear un Playbook, asegúrate de que AirOps Insights y tu Kit de marca estén actualizados. Estas dos fuentes de contexto moldean la calidad de cada Sesión.

### Configurar AirOps Insights

AirOps Insights es la fuente de datos de visibilidad en búsquedas de IA, incluyendo indicaciones rastreadas, respuestas de búsqueda de LLM, citas, presencia de competidores y oportunidades de contenido. Cuando un Playbook investiga oportunidades de AEO o respuestas de búsqueda de LLM, debe usar los datos rastreados en AirOps Insights en lugar de tratar la búsqueda de IA como una investigación web genérica.

Cubre los temas, perfiles, regiones y etapas del embudo que te interesan. Amplía la cobertura a partir de fuentes como consultas de Google Search Console, lenguaje de llamadas de ventas, tickets de soporte y brechas de citación de competidores.

El patrón común es: AirOps Insights rastrea indicaciones y respuestas de búsqueda de LLM, un Playbook supervisa esos datos y encuentra oportunidades, y luego un segundo Playbook actúa y crea o actualiza el resultado.

### Mantén actualizado tu Kit de marca

Cada Playbook puede heredar tu Kit de marca, por lo que los cambios en el tono, las reglas de redacción, las audiencias, las regiones, las líneas de producto, las pautas visuales y el contexto de la competencia se reflejan en el resultado del Playbook. Un Kit de marca desactualizado degrada el resultado posterior.

Audita el Kit de marca de forma periódica. Actualízalo cuando lances un producto, cambies el posicionamiento, añadas una nueva audiencia o te expandas a una nueva región.

Usa [Actualización del Kit de marca](https://docs.airops.com/docs/es/contexto/brand-kit/refresh.md) para supervisar fuentes en vivo y proponer ediciones del Kit de marca para aprobación humana.

{% hint style="warning" %}
Usa el nuevo formato de Kit de marca con Playbooks. Los Kits de marca heredados no funcionan tan bien con Playbooks y pueden reducir la calidad del resultado.
{% endhint %}

## Anatomía de un Playbook

Cuando abras el editor de Playbooks, verás:

* Una fila de chips de encabezado encima de la primera Sección que muestra Herramientas, Entradas, Artefactos y **Agregar disparador**.
* Acciones en la parte superior derecha para **Ejecutar Playbook**, **Publicar**, y **Historial de ejecuciones**.
* **Quill, el capitán agente de AirOps,** como un botón flotante verde en la esquina inferior derecha del editor.
* Haz referencia a chips en línea mientras escribes. Las Entradas y los Kits de marca aparecen como chips verdes. Las Herramientas aparecen como chips grises con iconos.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1d6bffb9013f3eaa2d2b627f82288c30362413b4%2Fplaybooks-02-editor-anatomy.png?alt=media" alt="Playbook editor with the header chip row, Run Playbook, Publish, and Run History actions, Input and Tool pills, and the Quill button"><figcaption><p>El editor de Playbooks: chips de encabezado, acciones en la parte superior derecha, referencias en línea y Quill.</p></figcaption></figure>

Escribe `/` en cualquier Sección para abrir el menú de barras oblicuas. El menú de barras oblicuas muestra Herramientas, Entradas, Artefactos y otras referencias que puedes insertar en tus instrucciones.

## Guías de Playbooks

* [Crear un Playbook](https://docs.airops.com/docs/es/acciones/playbooks/create-a-playbook.md)
* [Crear un Playbook](https://docs.airops.com/docs/es/acciones/playbooks/build-a-playbook.md)
* [Trabajar con Artefactos](https://docs.airops.com/docs/es/acciones/playbooks/artifacts.md)
* [Herramientas](https://docs.airops.com/docs/es/acciones/playbooks/tools.md)
* [Ejecutar un Playbook](https://docs.airops.com/docs/es/acciones/playbooks/run-a-playbook.md)
* [Disparadores de Playbooks](https://docs.airops.com/docs/es/acciones/playbooks/triggers.md)
* [Conectar Playbooks con otras herramientas](https://docs.airops.com/docs/es/acciones/playbooks/integrations.md)
* [Aplicar las mejores prácticas de Playbooks](https://docs.airops.com/docs/es/acciones/playbooks/best-practices.md)
* [Solucionar problemas de Playbooks](https://docs.airops.com/docs/es/acciones/playbooks/troubleshooting.md)


---

# 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.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.
