> 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/build-a-playbook.md).

# Crear un Playbook

Define entradas, secciones, herramientas, artefactos, revisiones y desencadenadores en un Playbook

Los Playbooks se construyen a partir de entradas, secciones, herramientas, artefactos, bloques de revisión humana y disparadores. Define cada parte con claridad para que el agente tenga el contexto correcto y los revisores tengan los puntos de control adecuados.

## Elige un modelo

Usa la función de **Modelo** selector del editor de Playbook para elegir **Automático** o un modelo disponible. Las opciones mostradas dependen de tu espacio de trabajo y de los proveedores disponibles.

**GPT-6 Sol**, **GPT-6 Luna**, **Claude Opus 5.5**, **Claude Sonnet 5.5**, y **Kimi K3** están disponibles en el selector. Elige Sol u Opus 5.5 para trabajos complejos, o Luna cuando la velocidad y el costo importan más.

### Comparar valoraciones de modelos

Expande un modelo para ajustar su **Esfuerzo de razonamiento** y compara las valoraciones disponibles para esa selección:

| Valoración               | Lo que significan más barras                                                  |
| ------------------------ | ----------------------------------------------------------------------------- |
| **Velocidad**            | Finalización media más rápida en ejecuciones de benchmark                     |
| **Inteligencia**         | Mayor capacidad general basada en el benchmark público de Artificial Analysis |
| **Eficiencia de costos** | Menos tareas consumidas por ejecución de benchmark                            |

Las valoraciones cambian con el esfuerzo de razonamiento seleccionado cuando hay datos de benchmark disponibles. Algunos modelos y ajustes de esfuerzo no tienen valoraciones. Toma las barras como una guía comparativa: tu Playbook, las Entradas y las Herramientas afectan el tiempo de ejecución real, el uso de tareas y la calidad de la salida. Auto no tiene un benchmark fijo de modelo y esfuerzo.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-931066925d9c8a7297d5b2aa5f05f6558ba3142b%2Fbuild-playbook-01-model-selector.png?alt=media" alt="Playbook model selector grouped by provider, with Kimi K3 expanded to show reasoning effort and Speed, Intelligence, and Cost efficiency ratings"><figcaption><p>Expande un modelo para comparar sus valoraciones en cada esfuerzo de razonamiento.</p></figcaption></figure>

## Elige un modo de ejecución

Usa **Rápido** o **Máximo** en el editor de Playbook para elegir qué tan exhaustivamente el Playbook revisa su trabajo:

| Modo       | Úsalo cuando                                                                                                                         |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Rápido** | Quieres un borrador más rápido con una verificación de hechos enfocada y menos ciclos de verificación.                               |
| **Máximo** | Necesitas una verificación de hechos exhaustiva, recopilación de fuentes y comprobaciones repetidas. Este es el modo predeterminado. |

Publica el Playbook para guardar el modo con esa versión. Una sesión conserva el modo de la versión que ejecutó, y puedes inspeccionarlo en la sesión **Detalles**. Cambiar el borrador no cambia el modo de una sesión existente ni de una versión fijada.

## 1. Define las entradas

Las entradas son la forma en que un Playbook recibe información en tiempo de ejecución.

| Escribe      | Usar para                                                                           |
| ------------ | ----------------------------------------------------------------------------------- |
| Texto        | Palabras clave, URL, prompts, cadenas de texto libre.                               |
| Número       | Conteos, umbrales, clasificaciones.                                                 |
| Archivo      | Documentos, briefs y exportaciones que el Playbook debe leer durante una ejecución. |
| Kit de marca | Tono, reglas de escritura, audiencias, regiones y pautas visuales.                  |

Haz clic en **Mostrar ajustes avanzados** en una entrada para establecer su nombre de variable, descripción, marcador de posición y valor predeterminado.

## 2. Define las secciones

Las secciones son la columna vertebral estructural de un Playbook. Cada sección contiene instrucciones y puede terminar opcionalmente con un bloque de revisión humana.

Organiza las secciones por fase lógica, no por revisor. Un flujo de contenido podría usar:

1. **Ingesta y validación:** Analiza la entrada, valídala y recopila contexto.
2. **Investigación y estrategia:** Busca en bases de conocimiento, analiza SERPs y revisa competidores.
3. **Compilación del brief:** Sintetiza la investigación en un brief accionable.
4. **Borrador del artículo y enlaces:** Genera el contenido y añade enlaces internos.
5. **Revisión final:** Pausa para una revisión humana antes de publicar.

Las plantillas usan una estructura coherente dentro de cada sección. Usa este patrón como punto de partida y luego adáptalo al trabajo:

* **Objetivo:** Define qué debe lograr la sección.
* **Entradas y referencias:** Nombra las entradas, artefactos, campos del Brand Kit, herramientas y bases de conocimiento que debe usar la sección. Insértalos desde el menú de barra inclinada cuando sea posible.
* **Instrucciones:** Enumera el trabajo en pasos claros y numerados.
* **Salida:** Nombra el artefacto que la sección debe escribir y el formato que debe usar.

## 3. Añade herramientas

Escribe `/` en cualquier sección para abrir el menú de barra inclinada. Úsalo para insertar herramientas, entradas, artefactos y otras referencias en las instrucciones del Playbook.

Las entradas, los artefactos y las herramientas son más fáciles de reutilizar cuando los insertas desde el menú de barra inclinada en lugar de escribir sus nombres manualmente.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e1b0b98c35cd159dda4994c870bebaa731e1edcf%2Fbuild-playbook-02-slash-menu.png?alt=media" alt="Slash menu in a Playbook Section showing Inputs, Artifacts, Tools, Brand Kit, and formatting options, with the Tools submenu open"><figcaption><p>Escribe / para insertar herramientas, entradas y artefactos como referencias.</p></figcaption></figure>

Para ver el catálogo completo de herramientas, los conectores MCP y las mejores prácticas, consulta [Herramientas](https://docs.airops.com/docs/es/acciones/playbooks/tools.md).

### AirOps

* **AirOps MCP:** Accede a tus datos de AirOps, incluidos los datos de Insights, los Brand Kits, las Bases de conocimiento y las Grillas.
* **Investigación SEO de AirOps:** Investigación de palabras clave, análisis de dominios y datos de backlinks.
* **Informe de Page 360:** Diagnostica una URL propia en búsquedas, visibilidad en IA, frescura, señales de autoridad y contenido de la página.
* **Informe Page Versus:** Compara una URL propia con las páginas que ganan en búsqueda y en respuestas de IA, y luego muestra las brechas que hay que cerrar.
* **Scrape de página web:** Extrae contenido de páginas web.

### Investigación SEO

* **DataForSEO:** Datos SEO e investigación de palabras clave.
* **Moz:** Análisis SEO y de dominios.
* **Google Search Console:** Datos de GSC.

### Investigación web

* **Búsqueda de Google:** Busca y recupera resultados de Google.
* **Parallel Web Systems:** Usa la API Parallel Search, la API Parallel Extract y la API Parallel Task para realizar investigación web, extraer datos estructurados de URLs y procesar entradas de investigación en salidas estructuradas.
* **Firecrawl:** Rastrea y extrae contenido de páginas web.
* **Reddit:** Para más detalles, [Habla con ventas](https://www.airops.com/book-a-call).

### Imagen y video

* **Generación de imágenes:** Genera o edita imágenes alojadas con GPT Image 2.5 Sunburst, GPT Image 2.5 Flare, GPT Image 2 o Nano Banana 2. Consulta [Herramientas de Imagen y video](https://docs.airops.com/docs/es/acciones/playbooks/tools/image-and-video.md) para orientación sobre modelos.
* **Imágenes de stock:** Busca imágenes en Getty Images o Unsplash y luego recupera una imagen seleccionada por ID para usarla en un artefacto o en un paso de publicación.

### Gestión del conocimiento

* **Slack:** Lee el historial del canal y envía mensajes.
* **Google Docs:** Lee y edita documentos de Google Docs.

### Enriquecimiento B2B

* **Brandfetch:** Recupera recursos e información de marca.
* **Hunter.io:** Encuentra y verifica direcciones de correo electrónico. Para más detalles, [Habla con ventas](https://www.airops.com/book-a-call).

### Anuncios

* **OpenAI Ads:** Recupera el rendimiento de la cuenta. Crea y gestiona campañas, grupos de anuncios y anuncios donde estén habilitadas las herramientas de escritura. Consulta [Herramientas de anuncios](https://docs.airops.com/docs/es/acciones/playbooks/tools/ads.md) para ver la disponibilidad y los pasos de revisión.

Puedes añadir cualquier conector MCP que necesites desde la configuración de conectores MCP de tu espacio de trabajo. Las herramientas MCP conectadas aparecen en la lista de Herramientas del editor de Playbook.

{% hint style="info" %}
Cuando añadas un paso de búsqueda en una Base de conocimiento, referencia la Base de conocimiento por nombre en el selector de Base de conocimiento del paso. No dependas de la auto-selección cuando el Playbook necesite una fuente específica.
{% endhint %}

## 4. Añade revisión humana

Coloca la revisión humana como un bloque al final de una sección existente. No crees una sección separada solo para la revisión.

Usa la revisión humana cuando alguien necesite aprobar texto, elegir entre opciones o editar la salida generada antes de que se ejecute la siguiente sección.

Las opciones de revisor incluyen:

* **Persona nombrada:** Un miembro específico del equipo.
* **Usuario actual:** La persona que inició el Playbook.
* **Cualquier miembro puede revisar:** Cualquier miembro del espacio de trabajo puede revisar.

Las revisiones aparecen en la bandeja de entrada.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-aa59d35d0bf59d0595c551ddcf26add728f5cd0c%2Fbuild-playbook-03-human-review.png?alt=media" alt="Reviewer menu on a Section&#x27;s Human Review block, with Any member can review, Current user, and teammates listed, and Maya Chen selected"><figcaption><p>Añade revisión humana al final de una sección. Las revisiones aparecen en la bandeja de entrada.</p></figcaption></figure>

{% hint style="info" %}
La enrutación condicional nativa a múltiples revisores aún no está disponible. La solución actual es una sección por revisor, con lógica de omisión en las instrucciones de la sección. Por ejemplo: "Si la complejidad no es 3, omite esta sección."
{% endhint %}

## 5. Declara artefactos

Los artefactos son las salidas persistentes que produce un Playbook. Declara uno cuando un resultado deba almacenarse, revisarse, compartirse, reutilizarse aguas abajo o publicarse después de que termine la sesión.

Los tipos de artefacto compatibles incluyen:

* Markdown
* HTML
* JSON
* CSV
* PNG
* JPG
* GIF

Asigna a cada artefacto un nombre claro y luego refiérelo desde la sección que deba escribir en él. Si una sección no produce un artefacto, su contenido permanece en el contexto de la sesión.

Para enlaces estables, comentarios, sugerencias, menciones, Editar con IA, historial de versiones y reutilización en Grid, consulta [Artefactos](https://docs.airops.com/docs/es/acciones/playbooks/artifacts.md).

## 6. Configura un disparador

Los disparadores determinan cómo comienza un Playbook.

| Disparador   | Cómo funciona                                                                                                                                        | Ideal para                                                                                         |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Programación | Se ejecuta con una cadencia recurrente, como cada lunes a las 9 a. m.                                                                                | Auditorías semanales de contenido, comprobaciones de frescura del Brand Kit, informes recurrentes. |
| Webhook      | Comienza cuando un sistema externo envía una solicitud HTTP a la URL del webhook del Playbook.                                                       | Eventos de publicación en CMS, envíos de formularios, integraciones de terceros.                   |
| Monitor      | Usa Parallel Web Systems para comprobar una consulta de monitorización cada 12 horas e iniciar el Playbook cuando se detecta la condición.           | Alertas competitivas, monitorización del mercado, monitorización de la salud del contenido.        |
| AEO Insight  | Comienza cuando se cumplen los umbrales habilitados de AEO Insight, como cuando cambian la tasa de menciones, la cuota de voz o la tasa de citación. | Actualización programática, respuesta competitiva, brechas de cobertura de AEO.                    |

{% hint style="info" %}
Los disparadores pueden usar **Predeterminado** o una versión del Playbook fijada. **Predeterminado** sigue la versión publicada actual. Un disparador fijado sigue usando la versión seleccionada hasta que la cambies. Si una nueva versión cambia las entradas, actualiza la configuración de entradas del disparador antes de confiar en ejecuciones futuras. Consulta [Disparadores de Playbooks](https://docs.airops.com/docs/es/acciones/playbooks/triggers.md) para ver los pasos de configuración y ejemplos de carga útil del webhook.
{% endhint %}

## 7. Usa Quill para iterar

Quill es el capitán agente de AirOps para la creación de Playbooks. Haz clic en el botón flotante verde en la esquina inferior derecha del editor.

[Quill](https://docs.airops.com/docs/es/quill.md) puede:

* Editar tu Playbook a partir de indicaciones en lenguaje natural.
* Reescribir un prompt de Workflow como una breve instrucción de agente con contexto.
* Usar archivos adjuntos de archivos e imágenes para actualizar el Playbook o el Brand Kit.
* Razona sobre la estructura del Playbook y sugiere reorganizaciones.

Dale a Quill todo el contexto desde el principio. En el chat, **Enter** envía, así que mantén cada instrucción en un solo párrafo.

Duplica un Playbook antes de una reescritura estructural grande para tener un punto limpio de retroceso.

## Revisar la salud del Playbook

Revisar **Salud** en la lista de Playbooks o abre el control de salud en el editor para ver las comprobaciones que requieren atención antes de publicar o ejecutar el Playbook.

## 8. Publica

Publicar crea una instantánea versionada que los consumidores posteriores pueden ejecutar desde Grillas y Disparadores. Usa un Disparador de Webhook cuando un sistema externo deba iniciar un Playbook programáticamente. Los borradores siguen siendo editables. Las versiones publicadas son referencias ejecutables.

Si cambiaste las entradas, actualiza cualquier mapeo de Grilla y configuración de entradas del disparador que use este Playbook antes de ejecutarlo a escala.

### Restaurar una versión anterior

Abre el historial de versiones desde el editor de Playbook, selecciona la versión que quieras y haz clic en **Restaurar**. AirOps copia esa versión al borrador actual para que puedas revisarla antes de publicarla.

Restaurar una versión reemplaza el borrador actual. Descarga o publica primero cualquier cambio del borrador que necesites conservar antes de restaurar una versión anterior.

Restaurar está disponible en los niveles Free, Starter, Pro, Pro Plus y Platform.

## Importar o exportar un Playbook

El editor puede descargar un Playbook como Markdown o JSON. También puede importar Markdown o JSON a un Playbook existente.

{% hint style="warning" %}
Importar Markdown o JSON sobrescribe el contenido actual del Playbook. Descarga primero el Playbook existente si necesitas un punto de retroceso.
{% 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/build-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.
