> 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.md). # Playbooks Crea y ejecuta Playbooks con instrucciones en lenguaje natural Los Playbooks te permiten describir el trabajo como instrucciones en lenguaje natural, adjuntar contexto como un Brand Kit y ejecutar el proceso de extremo a extremo mientras mantienes a los revisores al tanto. {% hint style="warning" %} Los Playbooks no se pueden usar dentro de Workflows. Puedes crear un Playbook a partir de un Workflow existente, pero no puedes agregar un Playbook como paso de un Workflow. {% endhint %} Un Playbook está compuesto por: * **Un Playbook con formato de documento** que describe lo que debe hacer el agente. * **Entradas** que el Playbook acepta en tiempo de ejecución, como texto, números, archivos o un Brand Kit. * **Secciones** que contienen instrucciones, llamadas a herramientas y puntos de control de Revisión humana. * **Herramientas** que el agente puede usar, incluidas SEO Research, Web Research, Image and Video, conectores MCP y más. * **Artefactos** que produce el Playbook, como archivos Markdown, HTML, JSON, CSV, PNG, JPG o GIF. * **Disparadores** que determinan cómo se inicia un Playbook, incluidos Schedule, Webhook, Monitor y AEO Insight cuando está habilitado. ## Conceptos clave | Término | Definición | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Playbook | La definición del agente con Entradas, Secciones, Herramientas, Artefactos y un Disparador. Ejecutar un Playbook produce una Sesión. | | Sección | Una unidad de trabajo en un Playbook. Cada Sección puede incluir instrucciones, llamadas a herramientas y un bloque de Revisión humana. | | Entrada | Información que proporcionas cuando se ejecuta un Playbook, como una palabra clave, una URL de destino, la carga de un archivo o un Brand Kit. | | Herramienta | Una acción que el agente puede realizar, desde investigación web y SEO hasta herramientas nativas como Slack y herramientas proporcionadas por conectores MCP. | | Artefacto | Una salida persistente que produce el Playbook, como una entrada de blog, una imagen, un análisis o datos estructurados. | | Activador | Una condición que inicia automáticamente un Playbook. Los tipos de disparador incluyen Schedule, Webhook, Monitor y AEO Insight cuando está habilitado. | | Sesión | Una ejecución única del Playbook. Cada Sesión produce Artefactos y registra el trabajo que realizó el agente. | | Bandeja de entrada | La cola a nivel del espacio de trabajo donde los revisores ven los pasos pendientes de Revisión humana y las salidas de Sesión que requieren atención. | | Historial de ejecuciones | El registro de cada Sesión que ha producido un Playbook. | | Revisión humana | Un punto de pausa en el que una persona debe aprobar o editar el trabajo del agente antes de que continúe. | | Quill | El capitán del agente de AirOps que te ayuda a crear y editar Playbooks a partir de prompts en lenguaje natural. Ver [Quill](/docs/es/quill.md). | | Memoria | Persistencia entre Sesiones, utilizada cuando un Playbook necesita recordar lo que ya ha mostrado o completado. | ## Las dos fuentes de contexto que impulsan la calidad Antes de crear un Playbook, asegúrate de que AirOps Insights y tu Brand Kit estén actualizados. Estas dos fuentes de contexto dan forma a la calidad de cada Sesión. ### Configurar AirOps Insights AirOps Insights es la fuente de datos de visibilidad de búsqueda de IA, incluidos prompts rastreados, respuestas de búsqueda de LLM, citas, presencia de la competencia y oportunidades de contenido. Cuando un Playbook investiga oportunidades de AEO o respuestas de búsqueda de LLM, debe usar los datos rastreados en AirOps Insights en lugar de tratar la búsqueda de IA como una investigación web genérica. Cubre los temas, personas, regiones y etapas del embudo que te interesan. Amplía la cobertura con fuentes como consultas de Google Search Console, lenguaje de llamadas de ventas, tickets de soporte y brechas de citación de competidores. El patrón común es: AirOps Insights rastrea prompts y respuestas de búsqueda de LLM, un Playbook supervisa esos datos y encuentra oportunidades, y luego un segundo Playbook actúa y crea o actualiza el resultado. ### Mantén actualizado tu Brand Kit Cada Playbook puede heredar tu Brand Kit, por lo que los cambios en el tono, las reglas de escritura, las audiencias, las regiones, las líneas de producto, las pautas visuales y el contexto de la competencia se reflejan en la salida del Playbook. Un Brand Kit desactualizado degrada la salida posterior. Audita el Brand Kit de forma periódica. Actualízalo cuando lances un producto, cambies el posicionamiento, añadas una nueva audiencia o te expandas a una nueva región. Usar [Actualización del Brand Kit](/docs/es/contexto/brand-kit/refresh.md) para supervisar fuentes en vivo y proponer ediciones del Brand Kit para aprobación humana. {% hint style="warning" %} Usa el nuevo formato de Brand Kit con Playbooks. Los Brand Kits antiguos no funcionan tan bien con Playbooks y pueden reducir la calidad de la salida. {% endhint %} ## Anatomía de un Playbook Cuando abras el editor de Playbooks, verás: * Una fila de chips de encabezado encima de la primera Sección que muestra Herramientas, Entradas, Artefactos y **Agregar disparador**. * Acciones en la parte superior derecha para **Ejecutar Playbook**, **Publicar**, y **Historial de ejecuciones**. * **Quill, el capitán del agente de AirOps,** como un botón flotante verde en la esquina inferior derecha del editor. * Consulta referencias en línea mientras escribes. Las Entradas y los Brand Kits aparecen como chips verdes. Las Herramientas aparecen como chips grises con iconos. Escribe `/` en cualquier Sección para abrir el menú de barra inclinada. El menú de barra inclinada muestra Herramientas, Entradas, Artefactos y otras referencias que puedes insertar en tus instrucciones. ## Guías de Playbook * [Crear un Playbook](/docs/es/acciones/playbooks/create-a-playbook.md) * [Crear un Playbook](/docs/es/acciones/playbooks/build-a-playbook.md) * [Trabajar con Artefactos](/docs/es/acciones/playbooks/artifacts.md) * [Herramientas](/docs/es/acciones/playbooks/tools.md) * [Ejecutar un Playbook](/docs/es/acciones/playbooks/run-a-playbook.md) * [Disparadores de Playbook](/docs/es/acciones/playbooks/triggers.md) * [Conectar Playbooks con otras herramientas](/docs/es/acciones/playbooks/integrations.md) * [Aplicar las mejores prácticas de Playbook](/docs/es/acciones/playbooks/best-practices.md) * [Solucionar problemas de Playbooks](/docs/es/acciones/playbooks/troubleshooting.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/acciones/playbooks.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.