> 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 respuestas de búsqueda de LLM de AirOps Insights y 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 un 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 la más alta 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 respuestas de búsqueda de LLM, citas en esas respuestas y oportunidades de AEO para el prompt objetivo. * **Brand Kit:** Mantén tu Brand Kit actualizado para que el Playbook pueda usar tu posicionamiento, audiencia, voz, reglas de redacción, líneas de producto y contexto de la competencia. ## Qué construirás El Playbook hará lo siguiente: 1. Aceptar una palabra clave principal, un prompt objetivo y un Brand Kit como entradas. 2. Investigar respuestas de búsqueda de LLM desde AirOps Insights y compararlas con los resultados de Google. 3. Analizar el contenido de la competencia y las brechas de contenido. 4. Crear un esquema, un borrador, un mapa de enlaces y un artículo final. 5. Pausar para Revisión Humana antes de aprobar el artículo final. ## Paso 1: Crea un Playbook en blanco 1. Haz clic en **Cree**. 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 parte superior derecha para **Ejecutar Playbook**, **Publicar**, y **Historial de ejecuciones**. ## Paso 2: Añade entradas Crea las entradas que el Playbook necesita en tiempo de ejecución. | Nombre de la entrada | Escribe | Descripción | | -------------------- | --------- | ---------------------------------------------------------------------------------- | | `primary_keyword` | Texto | La palabra clave SEO a la que debe apuntar el artículo. | | `target_prompt` | Texto | El prompt o pregunta de búsqueda de LLM que el artículo debe ayudar a responder. | | `brand_kit` | Brand Kit | El Brand Kit que debe guiar el posicionamiento, la audiencia, la voz y las reglas. | El Playbook debe funcionar cuando se proporcione cualquiera de los dos `primary_keyword` o `target_prompt` Si se proporcionan ambos, usa ambos para dar forma a la investigación y a la estrategia del artículo. ## Paso 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 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 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 de origen y estructurar los hallazgos. * **AirOps SEO Research:** 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 utiliza estas fuentes. * **Informe Page 360:** Diagnostica una URL propia en cuanto a rendimiento en búsqueda, 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. * **Scrapeo de página web:** Lee páginas específicas que el Playbook necesita inspeccionar. * **Brandfetch:** Enriquece los detalles de la empresa o la marca cuando sea necesario. {% hint style="info" %} No necesitas todas las herramientas para la primera versión. Empieza con Google Search, Parallel Web Systems, AirOps SEO Research y los informes de página de AirOps que sean relevantes para el artículo. {% endhint %} ## Paso 4: Declara los artefactos Los artefactos son los resultados duraderos que produce el Playbook. Añade estos artefactos antes de escribir las secciones para poder hacer referencia a ellos por nombre. | Artefacto | Escribe | Propósito | | --------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- | | **AI & Google Results.md** | Markdown | Captura el contenido existente, los mejores resultados de Google y las citas de respuestas de LLM de AirOps Insights. | | **Análisis competitivo.md** | Markdown | Resume la intención de búsqueda, la estructura de la competencia, las palabras clave, las FAQ, las brechas y la idoneidad para AEO. | | **Topic Research.md** | Markdown | Almacena hechos verificados, perspectivas de expertos, ejemplos y correcciones de afirmaciones. | | **Content Outline.md** | Markdown | Define la estructura del artículo y el brief de redacción. | | **Article Draft.md** | Markdown | Almacena el primer borrador completo del artículo. | | **Mapa de enlaces.json** | JSON | Mapea los enlaces internos y externos a las secciones del artículo. | | **Artículo final.md** | Markdown | Almacena 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 de una sesión. ## Paso 5: Escribe las secciones Usa las 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 claras **Instrucciones**, y el **Salida** Artefacto. Usa el menú de barra inclinada para insertar referencias a Entradas, Artefactos, Herramientas y Brand Kit en lugar de escribir sus nombres manualmente. ### Sección A: Investiga las respuestas de LLM y los resultados de Google Indica al Playbook que: * Compruebe el sitio de la marca para ver si hay contenido existente relacionado con la palabra clave o el prompt. * Use AirOps Insights para investigar las respuestas de búsqueda de LLM y las citas para el prompt objetivo. * Use Google Search y las herramientas de SEO para recopilar los principales resultados de Google para la palabra clave principal. * Excluye, cuando sea posible, las redes sociales, los foros y los dominios de la competencia. * Escribe los hallazgos en **AI & Google Results.md**. ### Sección B: Analiza a los competidores y las brechas Indica al Playbook que: * Extrae encabezados, contenido del cuerpo, recuento de palabras y secciones de FAQ de las páginas más sólidas citadas y mejor posicionadas. * Analiza la intención de búsqueda, la cobertura del tema, la estructura, las palabras clave, las FAQ y las brechas. * Usa el Brand Kit para identificar los ángulos que la marca puede poseer de forma creíble. * Escribe el análisis en **Análisis competitivo.md**. ### Sección C: Recopila investigación sobre el tema Indica al Playbook que: * Construye una agenda de investigación a partir de **Análisis competitivo.md**. * Encuentra estadísticas actuales, perspectivas de expertos, ejemplos del mundo real y afirmaciones desactualizadas de la competencia. * Prioriza fuentes primarias y autorizadas. * Escribe los hallazgos en **Topic Research.md**. ### Sección D: Crea el esquema Indica al Playbook que: * Usar **Análisis competitivo.md**, **Topic Research.md**, y el Brand Kit 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: Redacta y revisa el artículo Indica al Playbook que: * Redacta el artículo a partir de **Content Outline.md**. * Usar **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 Brand Kit. * Escribe el borrador en **Article Draft.md**. * Pausa para Revisión Humana antes de finalizar. ### Sección F: Añade enlaces y finaliza 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 **Mapa de enlaces.json**. * Escribe el artículo terminado en **Artículo final.md**. ## Paso 6: Ejecuta y publica 1. Haz clic en **Ejecutar Playbook**. 2. Introduce una palabra clave principal, un prompt objetivo o ambos. 3. Selecciona el Brand Kit. 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 **Artículo final.md** está completo. 7. Haz clic en **Publicar** cuando la estructura del Playbook funcione de forma fiable. Los Playbooks publicados pueden ejecutarse desde Grids y Triggers. Usa un [Webhook Trigger](/docs/es/acciones/playbooks/triggers.md) cuando un sistema externo deba iniciar un Playbook mediante programación. 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 Schedule, Webhook o Monitor Trigger. * Usar [Quill](/docs/es/quill.md) para revisar el Playbook a partir de instrucciones en lenguaje natural. * Crear un flujo de publicación independiente para actualizaciones del 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 independiente o un CMS MCP. Si un Playbook o un CMS MCP publica o actualiza una página, usa la herramienta AirOps MCP `track_aeo_page_content_update` con la URL de la página y el tipo de actualización para que AirOps Insights pueda vincular futuros cambios de rendimiento a 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 plantilla **Creación de blog** Ejecuta la plantilla con la misma palabra clave, prompt objetivo y Brand Kit 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](/docs/es/acciones/playbooks/create-a-playbook.md), [Crear un Playbook](/docs/es/acciones/playbooks/build-a-playbook.md), y [Ejecutar un Playbook](/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=&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.