> 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 adecuado y los revisores tengan los puntos de control correctos. ## Elige un modelo Usa la **Modelo** selector en el 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**, y **Claude Opus 5.5** están disponibles en el selector. Elige Sol u Opus 5.5 para trabajos complejos, o Luna cuando la velocidad y el costo importen más. ### Comparar calificaciones de modelos Expande un modelo para ajustar su **esfuerzo de razonamiento** compatible y comparar las calificaciones disponibles para esa selección: | Calificación | Qué significan más barras | | ------------------------ | ----------------------------------------------------------------------------- | | **Velocidad** | Finalización promedio más rápida en ejecuciones de referencia | | **Inteligencia** | Mayor capacidad general basada en el benchmark público de Artificial Analysis | | **Eficiencia de costos** | Menos tareas consumidas por ejecución de referencia | Las calificaciones cambian con el esfuerzo de razonamiento seleccionado cuando hay datos de referencia disponibles. Algunos modelos y ajustes de esfuerzo no tienen calificaciones. Toma las barras como una guía comparativa: tu Playbook, Entradas y Herramientas afectan el tiempo de ejecución real, el uso de tareas y la calidad de la salida. Automático no tiene un benchmark fijo de modelo y esfuerzo. ## 1. Definir Entradas Las Entradas son la forma en que un Playbook recibe información en tiempo de ejecución. | Escribe | Útil para | | --------- | -------------------------------------------------------------------------------------- | | Texto | Palabras clave, URL, indicaciones, cadenas de texto libres. | | Número | Conteos, umbrales, clasificaciones. | | Archivo | Documentos, resúmenes y exportaciones que el Playbook debe leer durante una ejecución. | | Brand Kit | Tono, reglas de redacción, audiencias, regiones y pautas visuales. | Haz clic en **Mostrar ajustes avanzados** en una Entrada para definir su nombre de variable, descripción, marcador de posición y valor predeterminado. ## 2. Definir 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 SERP y revisa competidores. 3. **Compilación del resumen:** Sintetiza la investigación en un resumen accionable. 4. **Borrador del artículo y enlace interno:** Genera el contenido y añade enlaces internos. 5. **Revisión final:** Pausa para la 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 Kit de marca, Herramientas y Bases de conocimiento que la Sección debe usar. Insértalos desde el menú de barra inclinada cuando sea posible. * **Instrucciones:** Enumera el trabajo en pasos numerados claros. * **Salida:** Nombra el Artefacto que la Sección debe escribir y el formato que debe usar. ## 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 en las instrucciones del Playbook. Las Entradas, Artefactos y Herramientas son más fáciles de reutilizar cuando los insertas desde el menú de barra inclinada en lugar de escribir sus nombres manualmente. Para el catálogo completo de Herramientas, los conectores MCP y las mejores prácticas, consulta [Herramientas](/docs/es/acciones/playbooks/tools.md). ### AirOps * **AirOps MCP:** Accede a tus datos de AirOps, incluidos datos de Insights, Kits de marca, Bases de conocimiento y Grids. * **AirOps SEO Research:** Investigación de palabras clave, análisis de dominios y datos de backlinks. * **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:** Extrae contenido de páginas web. ### Investigación SEO * **DataForSEO:** Datos SEO e investigación de palabras clave. * **Moz:** SEO y análisis 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 de Parallel Search, la API de Parallel Extract y la API de Parallel Task para realizar investigación web, extraer datos estructurados de URL y procesar entradas de investigación en salidas estructuradas. * **Firecrawl:** Rastrea y extrae páginas web. * **Reddit:** Para más detalles, [Habla con ventas](https://www.airops.com/book-a-call). ### Imagen y vídeo * **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 vídeo](/docs/es/acciones/playbooks/tools/image-and-video.md) para orientación sobre el modelo. * **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). ### Ads * **OpenAI Ads:** Recupera el rendimiento de la cuenta. Crea y administra campañas, grupos de anuncios y anuncios donde estén habilitadas las herramientas de escritura. Consulta [Herramientas de anuncios](/docs/es/acciones/playbooks/tools/ads.md) para conocer 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 Base de conocimiento, referencia la Base de conocimiento por nombre en el selector de Base de conocimiento del paso. No dependas de la selección automática cuando el Playbook necesite una fuente específica. {% endhint %} ## 4. Añadir 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. {% hint style="info" %} Todavía no está disponible el enrutamiento condicional nativo a varios revisores. 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. Declarar Artefactos Los Artefactos son las salidas persistentes que produce un Playbook. Declara uno cuando un resultado necesite 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 Dale 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](/docs/es/acciones/playbooks/artifacts.md). ## 6. Configurar un Disparador Los Disparadores determinan cómo empieza un Playbook. | Activador | Cómo funciona | Mejor para | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | Programación | Se ejecuta con una cadencia recurrente, como cada lunes a las 9:00. | Auditorías de contenido semanales, comprobaciones de frescura del Kit de marca, informes recurrentes. | | Webhook | Se inicia 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 monitoreo cada 12 horas e inicia el Playbook cuando se detecta la condición. | Alertas competitivas, monitoreo del mercado, monitoreo de la salud del contenido. | | Información de AEO | Se inicia cuando se cumplen los umbrales habilitados de Información de AEO, como cuando cambia la tasa de menciones, la cuota de voz o la tasa de citas. | Actualización programática, respuesta competitiva, brechas de cobertura de AEO. | {% hint style="info" %} Los Disparadores pueden usar **Predeterminado** o una versión fijada del Playbook. **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 depender de ejecuciones futuras. Consulta [Disparadores de Playbook](/docs/es/acciones/playbooks/triggers.md) para ver los pasos de configuración y ejemplos de carga útil de webhook. {% endhint %} ## 7. Usa Quill para iterar Quill es el capitán agente de AirOps para la autoría de Playbooks. Haz clic en el botón flotante verde en la esquina inferior derecha del editor. [Quill](/docs/es/quill.md) puede: * Editar tu Playbook a partir de indicaciones en lenguaje natural. * Reescribir una indicación 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 Kit de marca. * Razonar sobre la estructura del Playbook y sugerir 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 gran reescritura estructural para tener un punto limpio de reversión. ## Comprobar 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. Publicar Publicar crea una instantánea versionada desde la que los consumidores posteriores pueden ejecutar desde Grids y Disparadores. Usa un Disparador de Webhook cuando un sistema externo deba iniciar un Playbook de forma programática. Los borradores siguen siendo editables. Las versiones publicadas son referencias ejecutables. Si cambiaste las Entradas, actualiza cualquier asignación de Grid y la 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 en el borrador actual para que puedas revisarla antes de publicarla. Restaurar una versión reemplaza el borrador actual. Descarga o publica 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 en 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 reversión. {% 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=&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.