> 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/troubleshooting.md). # Solución de problemas Soluciona problemas comunes de configuración y ejecución de Playbook Usa esta guía cuando un Playbook produzca una salida deficiente, se quede atascado, enrute la revisión incorrectamente o use la versión equivocada. | Síntoma | Causa probable | Solución | | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | | La calidad de la salida es baja | El Brand Kit está desactualizado o usa el formato heredado. | Migra al nuevo formato de Brand Kit y audita la voz, las reglas de redacción, las audiencias y las regiones. | | Error "Se requiere Brand Kit" después de adjuntar un Brand Kit | El tipo de Entrada es Texto en lugar de Brand Kit. | Abre la configuración de Entrada y cambia el tipo a **Brand Kit**. | | El Playbook pasa por alto oportunidades obvias | La cobertura de prompts está incompleta o desactualizada. | Audita los prompts rastreados y amplía la cobertura con consultas de GSC, llamadas de ventas, tickets de soporte y lagunas frente a la competencia. | | La búsqueda en la Base de Conocimientos devuelve resultados irrelevantes | Se ha seleccionado la Base de Conocimientos incorrecta, o la selección automática busca de forma demasiado amplia. | Selecciona la Base de Conocimientos por nombre en el selector de Base de Conocimientos del paso. | | Una Sección posterior no puede encontrar un Artefacto | La Sección está haciendo referencia al Artefacto por nombre de archivo. | Haz referencia al Artefacto por nombre. Usa el menú de barra inclinada para insertar la referencia. | | La ejecución activada usa contenido antiguo del Playbook | El Activador está fijado a una versión publicada anterior. | Abre el Activador y selecciona **Predeterminado** o la versión publicada que quieres ejecutar. | | La ejecución activada falla después de cambiar las Entradas | La versión activa del Playbook tiene Entradas requeridas que no están configuradas en el Activador. | Abre la configuración del Activador y actualiza la configuración de Entrada. | | La ejecución de Grid falla después de cambiar las Entradas | La columna de Grid está usando una versión del Playbook con Entradas requeridas que no están asignadas. | Abre la configuración de la columna de Grid y actualiza las asignaciones de Entrada. | | Una Sesión no puede iniciarse porque un Artefacto requerido no está disponible | Un Playbook anterior no ha producido el Artefacto asignado. | Completa la ejecución anterior y confirma que el Artefacto requerido existe; luego vuelve a intentar la Sesión posterior. | | Las ediciones en el chat de la Sesión no actualizan el Playbook | La Sesión está ejecutando una versión publicada. Las ediciones del chat se aplican solo a los Artefactos. | Abre el Playbook en el editor y edita el Playbook con [Quill](/docs/es/quill.md), o realiza ediciones directas. | | Al Playbook replicado le faltan herramientas | El convertidor de Workflow no trasladó todas las referencias a herramientas al Playbook. | Añade las herramientas que faltan con el menú de barra inclinada antes de publicar. | | El Playbook se atasca en la Sección 1 preguntando qué fila ejecutar | La ejecución está usando la `__id` columna interna como identificador de fila de un Grid. | Pasa al Playbook una columna identificadora real, como URL o slug, en lugar de `__id`. | | Un Playbook no está disponible en un Grid | El Playbook sigue siendo un borrador. | Publica el Playbook y luego añádelo desde la pestaña Playbooks de Grid. | | AEO Insight no está disponible como Activador | Los activadores de AEO Insight no están habilitados para el espacio de trabajo. | Usa Schedule, Webhook o Monitor, o contacta a tu equipo de cuenta sobre los activadores de AEO Insight. | | La exportación de Webflow sobrescribió contenido personalizado | La exportación nativa envía el campo completo de texto enriquecido. | Planifica la estructura del campo para que la salida del Playbook sea la propietaria del campo al que exporta. | | Los mensajes de Slack no etiquetan a personas individuales | Las @menciones individuales aún no son compatibles en los pasos de Slack de Playbook. | Menciona a la persona en el cuerpo del mensaje y haz que los revisores vigilen el canal correspondiente. | ## Reanudar después de un límite de ejecución Si una Sesión supera el límite de ejecución de dos horas, AirOps la cancela y muestra un error explicando que puedes reanudarla. Abre la Sesión y reanúdala para continuar el trabajo. El mismo límite se aplica a una Sesión continuada. ## Preguntas frecuentes ### ¿Puedo mantener en ejecución los Workflows existentes mientras creo Playbooks? Sí. Los Playbooks y los Workflows pueden ejecutarse en paralelo durante la migración. ### ¿Los Playbooks admiten BYOK? Actualmente, los Playbooks no admiten BYOK. Contacta con si tienes preguntas sobre el acceso a modelos en Playbooks. ### ¿Puedo enrutar las revisiones a distintas personas según el tipo de contenido o la complejidad? Aún no de forma nativa. La solución actual es crear Secciones separadas con lógica de omisión, como "Si la complejidad no es 3, omite esta Sección." Cada Sección puede tener su propia asignación de revisor. ### ¿Pueden los Playbooks enviar contenido directamente a mi CMS? Sí, pero mantén la publicación separada de la creación de contenido cuando sea posible. Crea y revisa primero el contenido y luego publícalo desde 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, llama al AirOps MCP `track_aeo_page_content_update` herramienta con la URL de la página y el tipo de actualización para que AirOps Insights pueda seguir la actualización del contenido. ### ¿Qué herramientas de SEO están disponibles en Playbooks? Los Playbooks pueden usar AirOps SEO Research, DataForSEO, Moz, Google Search Console, Page 360 Report y Page Versus Report. También pueden usar herramientas de investigación web como Google Search, Parallel Web Systems, Firecrawl, Reddit y Web Page Scrape. ### ¿Cómo activo un Playbook de forma programática? Usa un **Webhook** Activador. Los webhooks son la forma recomendada de iniciar un Playbook publicado desde un sistema externo. Envía una `POST` solicitud a la URL del webhook con un `inputs` objeto que usa los nombres de variables de Entrada del Playbook como claves. Consulta [Disparadores de Playbook](/docs/es/acciones/playbooks/triggers.md#webhook-payload-format) para el formato del payload. El Activador ejecuta su versión seleccionada: **Predeterminado** sigue la versión publicada actual, y un Activador fijado sigue usando la versión seleccionada hasta que la cambies. Si cambian las Entradas del Playbook, actualiza la configuración de Entrada del Activador antes de enviar solicitudes de producción. ### ¿Puede Quill editar un Playbook desde una Sesión en ejecución? No. Las ediciones en el chat de una Sesión se aplican a los Artefactos. Para modificar el Playbook, ábrelo en el editor y usa [Quill](/docs/es/quill.md) allí. ### ¿Puede un Playbook recordar cosas entre ejecuciones? Sí. La memoria conserva la información entre Sesiones. Un patrón común es un Playbook que supervisa datos y evita recomendar el mismo contenido para actualizarlo dentro de una ventana deslizante, como 60 días. --- # 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/troubleshooting.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.