> 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/getting-started/building-your-first-playbook.md).

# Creación de su primer Playbook

Crea y ejecuta tu primer Playbook de AirOps

En este tutorial, crearás un Playbook de creación de contenido. El Playbook toma una palabra clave principal o un prompt objetivo, investiga las respuestas de búsqueda de LLM a partir de AirOps Insights y los resultados de Google, crea un esquema, redacta el artículo, añade enlaces y produce un artículo final en Markdown.

Este ejemplo de contenido propio muestra cómo convertir una oportunidad de descubrimiento de IA en trabajo de agente repetible con el contexto de tu marca y Revisión Humana. Puedes aplicar el mismo enfoque a otras tareas de investigación, actualización y optimización en tu estrategia.

## Antes de empezar

Para obtener la salida de mayor calidad, configura las dos fuentes de contexto de las que depende este Playbook:

* **AirOps Insights:** Haz seguimiento de los prompts, temas, competidores y páginas que te interesan. El Playbook usa AirOps Insights para investigar las respuestas de búsqueda de LLM, las citas en esas respuestas y las oportunidades de AEO para el prompt objetivo.
* **Kit de marca:** Mantén actualizado tu Kit de marca para que el Playbook pueda usar tu posicionamiento, audiencia, voz, reglas de redacción, líneas de producto y contexto de la competencia.

## Lo que vas a construir

El Playbook hará lo siguiente:

1. Aceptar una palabra clave principal, un prompt objetivo y un Kit de marca como entradas.
2. Investigar las respuestas de búsqueda de LLM a partir de AirOps Insights y compararlas con los resultados de Google.
3. Analizar el contenido de la competencia y las lagunas de contenido.
4. Crear un esquema, un borrador, un mapa de enlaces y un artículo final.
5. Pausarse para Revisión Humana antes de aprobar el artículo final.

## Paso 1: Crear un Playbook en blanco

1. Haz clic en **Crea**.
2. Selecciona **Playbook**.
3. Selecciona **Playbook en blanco**.
4. Nombra el Playbook **Creación de blog**.

AirOps abre el editor del Playbook. El editor tiene una fila de chips en el encabezado para Herramientas, Entradas, Artefactos y **Agregar disparador**, además de acciones en la esquina superior derecha para **Ejecutar Playbook**, **Publicar**, y **Historial de ejecuciones**.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-02e3ddae1a4e5c1808f6d515db03adc38ae25f49%2Ffirst-playbook-01-blank-editor.png?alt=media" alt="Blank Blog Creation Playbook in the AirOps Playbook editor, with 1 Tool and Add Trigger chips above an empty Section"><figcaption><p>Un nuevo Playbook en blanco. Los chips de Entradas y Artefactos aparecen una vez que el Playbook tiene al menos uno de cada uno.</p></figcaption></figure>

## Paso 2: Añadir entradas

Crea las entradas que el Playbook necesita en tiempo de ejecución.

| nombre\_de\_entrada | Escribe      | Descripción                                                                           |
| ------------------- | ------------ | ------------------------------------------------------------------------------------- |
| `primary_keyword`   | Texto        | La palabra clave SEO que el artículo debe orientar.                                   |
| `target_prompt`     | Texto        | El prompt o pregunta de búsqueda de LLM que el artículo debe ayudar a responder.      |
| `brand_kit`         | Kit de marca | El Kit de marca que debe guiar el posicionamiento, la audiencia, la voz y las reglas. |

El Playbook debería funcionar cuando se proporcione cualquiera de los dos `primary_keyword` o `target_prompt` Si se proporcionan ambos, usa los dos para dar forma a la investigación y a la estrategia del artículo.

## Paso 3: Añadir herramientas

Escribe `/` en cualquier Sección para abrir el menú de barra inclinada. Úsalo para insertar Herramientas, Entradas, Artefactos y otras referencias directamente en las instrucciones del Playbook.

Para este tutorial, añade las Herramientas que tu espacio de trabajo tenga conectadas:

* **Búsqueda de Google:** Encuentra los resultados actuales de Google para la palabra clave objetivo.
* **Parallel Web Systems:** Usa la API Parallel Search, la API Parallel Extract y la API Parallel Task para investigar la web, extraer contenido fuente y estructurar los hallazgos.
* **Investigación SEO de AirOps:** Obtén contexto de palabra clave, dominio y SEO.
* **DataForSEO**, **Moz**, o **Google Search Console:** Añade datos de SEO si tu espacio de trabajo usa estas fuentes.
* **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:** Lee páginas específicas que el Playbook necesita revisar.
* **Brandfetch:** Enriquecer detalles de la empresa o de la marca cuando sea necesario.

{% hint style="info" %}
No necesitas todas las Herramientas para la primera versión. Empieza con Búsqueda de Google, Parallel Web Systems, AirOps SEO Research y los informes de páginas de AirOps que sean relevantes para el artículo.
{% endhint %}

## Paso 4: Declarar artefactos

Los artefactos son las salidas duraderas que produce el Playbook. Añade estos Artefactos antes de escribir las Secciones para poder referenciarlos por nombre.

| Artefacto                   | Escribe  | Propósito                                                                                                                         |
| --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **AI & Google Results.md**  | Markdown | Captura el contenido existente, los principales resultados de Google y las citas de respuestas de LLM de AirOps Insights.         |
| **Competitive Analysis.md** | Markdown | Resume la intención de búsqueda, la estructura de la competencia, las palabras clave, las FAQ, las lagunas y la adecuación a AEO. |
| **Topic Research.md**       | Markdown | Guarda hechos verificados, ideas de expertos, ejemplos y correcciones de afirmaciones.                                            |
| **Content Outline.md**      | Markdown | Define la estructura del artículo y el resumen de redacción.                                                                      |
| **Article Draft.md**        | Markdown | Guarda el primer borrador completo del artículo.                                                                                  |
| **Link Map.json**           | JSON     | Mapea enlaces internos y externos a las secciones del artículo.                                                                   |
| **Final Article.md**        | Markdown | Guarda el artículo terminado con enlaces.                                                                                         |

Usa el menú de barra inclinada para insertar referencias de Artefactos en Secciones posteriores. Haz referencia a los Artefactos por nombre, no por el nombre de archivo generado en una Sesión.

## Paso 5: Escribir las Secciones

Usa Secciones para describir el trabajo por fases. Mantén la primera versión enfocada en la ruta principal.

Da formato a cada Sección con un breve **Objetivo**, las Entradas o Artefactos a los que debe hacer referencia, **Instrucciones**claro **Salida** Artefacto esperado. Usa el menú de barra inclinada para insertar referencias de Entradas, Artefactos, Herramientas y del Kit de marca 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-1c956159aa6f1a1843800819574df7cfab671275%2Ffirst-playbook-02-sections-and-references.png?alt=media" alt="Blog Creation Playbook with 6 Tools, 3 Inputs, and 7 Artifacts, and a Section referencing Inputs, Tools, and the AI &#x26; Google Results Artifact as pills"><figcaption><p>Inserta Entradas, Herramientas y Artefactos desde el menú de barra inclinada para que aparezcan como chips.</p></figcaption></figure>

### Sección A: Investigar respuestas de LLM y resultados de Google

Indica al Playbook que:

* Revise el sitio de la marca para encontrar contenido existente relacionado con la palabra clave o el prompt.
* Usa AirOps Insights para investigar las respuestas de búsqueda de LLM y las citas para el prompt objetivo.
* Usa Búsqueda de Google y herramientas de SEO para recopilar los principales resultados de Google para la palabra clave principal.
* Excluye redes sociales, foros y dominios de competidores cuando sea posible.
* Escribe los hallazgos en **AI & Google Results.md**.

### Sección B: Analizar competidores y lagunas

Indica al Playbook que:

* Extrae encabezados, contenido del cuerpo, recuento de palabras y secciones de FAQ de las páginas citadas y mejor posicionadas más sólidas.
* Analiza la intención de búsqueda, la cobertura del tema, la estructura, las palabras clave, las FAQ y las lagunas.
* Usa el Kit de marca para identificar los ángulos que la marca puede apropiarse con credibilidad.
* Escribe el análisis en **Competitive Analysis.md**.

### Sección C: Reunir investigación del tema

Indica al Playbook que:

* Construye una agenda de investigación a partir de **Competitive Analysis.md**.
* Encuentra estadísticas actuales, perspectivas de expertos, ejemplos del mundo real y afirmaciones obsoletas de la competencia.
* Da preferencia a fuentes primarias y autorizadas.
* Escribe los hallazgos en **Topic Research.md**.

### Sección D: Crear el esquema

Indica al Playbook que:

* Usa **Competitive Analysis.md**, **Topic Research.md**, y el Kit de marca para definir la estrategia del artículo.
* Incluye el H1, los H2, los H3, el recuento objetivo de palabras, los puntos clave, las palabras clave, las notas de investigación, las preguntas del lector y el ángulo de la marca.
* Escribe el esquema en **Content Outline.md**.

### Sección E: Redactar y revisar el artículo

Indica al Playbook que:

* Redacta el artículo a partir de **Content Outline.md**.
* Usa **Topic Research.md** para hechos, ejemplos y fuentes.
* Sigue la voz, la audiencia, las reglas de redacción y las convenciones de tipo de contenido del Kit de marca.
* Escribe el borrador en **Article Draft.md**.
* Pausa para Revisión Humana antes de finalizar.

### Sección F: Añadir enlaces y finalizar

Indica al Playbook que:

* Añade enlaces internos relevantes del sitio de la marca.
* Añade enlaces externos que respalden afirmaciones específicas.
* Escribe el plan de enlaces en **Link Map.json**.
* Escribe el artículo terminado en **Final Article.md**.

## Paso 6: Ejecutar y publicar

1. Haz clic en **Ejecutar Playbook**.
2. Introduce una palabra clave principal, un prompt objetivo o ambos.
3. Selecciona el Kit de marca.
4. Revisa cada Artefacto a medida que se crea.
5. Completa el paso de Revisión Humana desde la bandeja de entrada o la vista de Sesión.
6. Confirma que **Final Article.md** esté completo.
7. Haz clic en **Publicar** cuando la estructura del Playbook funcione de forma fiable.

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2a18e6088e125da3f7b4baa05b1f0a9e775fbfa1%2Ffirst-playbook-03-session-human-review.png?alt=media" alt="Blog Creation Session paused for Human Review, with Article Draft.md open, 4 of 6 steps complete, and Request Changes and Approve buttons"><figcaption><p>Revisa cada Artefacto y, luego, aprueba el borrador o solicita cambios antes de que se escriba el artículo final.</p></figcaption></figure>

Los Playbooks publicados pueden ejecutarse desde Grid y Disparadores. Usa un [Disparador de webhook](https://docs.airops.com/docs/es/acciones/playbooks/triggers.md) cuando un sistema externo deba iniciar un Playbook programáticamente. Las ediciones del borrador siguen siendo editables, pero las ejecuciones posteriores usan una versión publicada.

## Amplía tu Playbook

Después de publicar, puedes:

* Añadir el Playbook a una Grid para crear artículos a partir de muchas palabras clave o prompts.
* Añadir un Disparador de programación, webhook o monitor.
* Usa [Quill](https://docs.airops.com/docs/es/quill.md) para revisar el Playbook a partir de instrucciones en lenguaje natural.
* Construir un flujo de publicación separado para actualizaciones de CMS.

{% hint style="info" %}
La mejor práctica es mantener separadas la creación de contenido y la publicación en el CMS. Ejecuta primero el Playbook de contenido, revisa la salida y luego publica a través de una columna de Grid, un Playbook de publicación separado o un CMS MCP. Si un Playbook o un CMS MCP publica o actualiza una página, usa la herramienta MCP de AirOps `track_aeo_page_content_update` con la URL de la página y el tipo de actualización para que AirOps Insights pueda conectar futuros cambios de rendimiento con esa actualización de contenido.
{% endhint %}

Enhorabuena, has creado y ejecutado tu primer Playbook de creación de contenido.

Este recorrido sigue la misma estructura general que la **Creación de blog** plantilla. Ejecuta la plantilla con la misma palabra clave, el mismo prompt objetivo y el mismo Kit de marca si quieres comparar resultados y ver cómo una versión más completa maneja el mismo brief.

Para una referencia más profunda, consulta [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), y [Ejecutar un Playbook](https://docs.airops.com/docs/es/acciones/playbooks/run-a-playbook.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/getting-started/building-your-first-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.
