> 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 genere resultados deficientes, se bloquee, enrute la revisión incorrectamente o use la versión equivocada.

| Síntoma                                                                        | Causa probable                                                                                                 | Solución                                                                                                                                              |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| La calidad del resultado 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 de "Brand Kit requerido" 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 **Kit de marca**.                                                                                 |
| Playbook pasa por alto oportunidades obvias                                    | La cobertura de prompts está incompleta o desactualizada.                                                      | Audita los Prompts rastreados y amplía la cobertura a partir de consultas de GSC, llamadas de ventas, tickets de soporte y brechas de la competencia. |
| La búsqueda en Knowledge Base devuelve resultados irrelevantes                 | Se seleccionó la Knowledge Base incorrecta, o la selección automática está buscando de forma demasiado amplia. | Selecciona la Knowledge Base por nombre en el selector de Knowledge Base del paso.                                                                    |
| Un Section posterior no puede encontrar un Artifact                            | El Section está haciendo referencia al Artifact por nombre de archivo.                                         | Haz referencia al Artifact por nombre. Usa el menú de barra diagonal para insertar la referencia.                                                     |
| La ejecución activada usa contenido antiguo de Playbook                        | El Trigger está anclado a una versión publicada anterior.                                                      | Abre el Trigger 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 de Playbook tiene entradas requeridas que no están configuradas en el Trigger.               | Abre la configuración del Trigger 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 de 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 Session no puede iniciarse porque no está disponible un Artifact requerido | Un Playbook ascendente no ha producido el Artifact asignado.                                                   | Completa la ejecución ascendente y confirma que el Artifact requerido existe; luego vuelve a intentar la Session descendente.                         |
| Las ediciones en el chat de Session no actualizan el Playbook                  | La Session está ejecutando una versión publicada. Las ediciones en el chat solo se aplican a los Artifacts.    | Abre el Playbook en el editor y edita el Playbook con [Quill](https://docs.airops.com/docs/es/quill.md), o haz ediciones directas.                    |
| Al Playbook replicado le faltan Tools                                          | El convertidor de Workflow no llevó todas las referencias de Tools al Playbook.                                | Añade las Tools que faltan con el menú de barra diagonal antes de publicar.                                                                           |
| Playbook se bloquea en la Section 1 preguntando qué fila ejecutar              | La ejecución está usando la interna `__id` columna como identificador de fila de un Grid.                      | Pasa a Playbook un identificador 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 del Grid.                                                                              |
| AEO Insight no está disponible como Trigger                                    | Los triggers de AEO Insight no están habilitados para el workspace.                                            | Usa Schedule, Webhook o Monitor, o contacta a tu equipo de cuenta sobre los triggers de AEO Insight.                                                  |
| La exportación de Webflow sobrescribió el contenido personalizado              | La exportación nativa empuja el campo completo de texto enriquecido.                                           | Planifica la estructura del campo para que el resultado del Playbook sea dueño 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.                          | Nombra a la persona en el cuerpo del mensaje y pide a los revisores que vigilen el canal correspondiente.                                             |

## Reanudar después de un límite de tiempo de ejecución

Si una Session supera el límite de tiempo de ejecución de dos horas, AirOps la cancela y muestra un error que explica que puedes reanudarla. Abre la Session y reanúdala para continuar el trabajo. El mismo límite se aplica a una Session continuada.

## Preguntas frecuentes

### ¿Puedo mantener los Workflows existentes en ejecución mientras construyo Playbooks?

Sí. Playbooks y Workflows pueden ejecutarse en paralelo durante la migración.

### ¿Los Playbooks admiten BYOK?

Actualmente, los Playbooks no admiten BYOK. Ponte en contacto con <support@airops.com> si tienes preguntas sobre el acceso a modelos en Playbooks.

### ¿Puedo enrutar revisiones a diferentes personas según el tipo de contenido o la complejidad?

No de forma nativa todavía. La solución actual es crear Sections separadas con lógica de omisión, como "Si la complejidad no es 3, omite esta Section." Cada Section 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 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 rastrear la actualización de 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 mediante programación?

Usa un **Webhook** Trigger. 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 `entradas` objeto que usa los nombres de las variables de entrada de Playbook como claves. Consulta [Disparadores de Playbooks](https://docs.airops.com/docs/es/acciones/playbooks/triggers.md#webhook-payload-format) para ver el formato del payload. El Trigger ejecuta su versión seleccionada: **Predeterminado** sigue la versión publicada actual, y un Trigger anclado sigue usando la versión seleccionada hasta que la cambies. Si cambian las entradas de Playbook, actualiza la configuración de entrada del Trigger antes de enviar solicitudes de producción.

### ¿Puede Quill editar un Playbook desde una Session en ejecución?

No. Las ediciones en un chat de Session se aplican a los Artifacts. Para modificar el Playbook, ábrelo en el editor y usa [Quill](https://docs.airops.com/docs/es/quill.md) allí.


---

# 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=<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.
