> 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/best-practices.md).

# Mejores prácticas

Orientación práctica para crear Playbooks confiables

Usa estas prácticas para que los Playbooks sean más fáciles de ejecutar, revisar y mejorar.

## Empieza con el Brand Kit y la cobertura de Prompts

Un Brand Kit actualizado y una cobertura completa de Prompts son los dos factores de calidad más importantes. Confirma ambos antes de optimizar la estructura del Playbook.

## Empieza con menos instrucciones

Dale al agente suficiente orientación para entender el objetivo, y luego añade restricciones donde necesites un comportamiento predecible. Las instrucciones demasiado prescriptivas pueden reducir la capacidad del agente para razonar sobre casos límite.

## Organiza las secciones por fase

Usa fases como **Investigación**, **Borrador**, y **Revisar**. Evita organizar las secciones en torno a personas, como "Sección de estratega" o "Sección de editor". La estructura basada en fases es más fácil de reutilizar y de revisar.

## Da formato a cada sección de forma consistente

Proporciona a cada sección una estructura interna predecible para que el agente entienda el objetivo, el revisor pueda revisar el trabajo rápidamente y las secciones posteriores sepan qué artefacto usar.

Una sección sólida suele incluir:

* **Objetivo:** Una o dos frases que definan qué debe lograr esta sección.
* **Entradas y referencias:** Las entradas, los artefactos, los campos del Brand Kit, las herramientas o las bases de conocimiento que la sección debe usar. Insértalos con el menú de barra diagonal cuando sea posible.
* **Instrucciones:** Pasos numerados para el trabajo que debe realizar el agente. Mantén el foco en las decisiones, las restricciones y las preferencias de las fuentes.
* **Salida:** El artefacto que la sección debe redactar, además del formato requerido, como un informe en Markdown, un mapa JSON o un artículo final.

Usa el mismo patrón en todas las secciones. Por ejemplo, una sección de investigación podría indicar el objetivo, hacer referencia al prompt objetivo y al Brand Kit, enumerar los pasos de investigación y luego escribir los hallazgos en **AI & Google Results.md**. Una sección de redacción podría hacer referencia a **Content Outline.md** como en el **Topic Research.md**, enumerar los requisitos de redacción y luego escribir el borrador en **Article Draft.md**.

## Usa las secciones como puntos de control

Añade una sección cuando necesites:

* Un artefacto discreto.
* Una pausa para la revisión humana.
* Un punto de referencia claro para secciones posteriores.

## Escribe artefactos solo cuando necesites persistencia

El contexto se transfiere automáticamente entre secciones. Usa artefactos cuando una salida deba guardarse, compartirse o consultarse más adelante.

## Haz referencia a las bases de conocimiento por nombre

Elige la base de conocimiento específica en el selector de bases de conocimiento del paso. La selección automática o la búsqueda en todas las bases de conocimiento pueden recuperar información de la fuente equivocada.

## Haz referencia a los artefactos por nombre

Los nombres de los artefactos son estables. Los nombres de archivo pueden cambiar. Usa el menú de barra diagonal para insertar referencias a artefactos por nombre en secciones posteriores.

## Mantén la publicación separada de la creación de contenido

Usa Playbooks para crear, actualizar, revisar y preparar contenido. Publica desde una columna de Grid, un Playbook de publicación independiente o un CMS MCP después de la revisión. Así es más fácil controlar la revisión editorial, el mapeo de campos del CMS y el seguimiento de la publicación.

Cuando un Playbook o un CMS MCP publique o actualice una página, usa el 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 en visibilidad de IA, citas, menciones y tráfico a esa actualización de contenido.

## Combina Playbooks de detección de oportunidades y de generación de resultados

Deja que un Playbook supervise los datos y encuentre oportunidades, y luego que un Playbook de acción separado produzca el resultado. Así cada Playbook es más fácil de entender, revisar e iterar.

## Pídele a Quill que traduzca los prompts de Workflow

Cuando migres un Workflow, pega el prompt original con todo el contexto y pide [Quill](https://docs.airops.com/docs/es/quill.md) que lo traduzca en una instrucción concisa para el agente. A partir de ahí, recorta el resultado.

## Haz que los cambios propuestos pasen por revisión humana

Los Playbooks bien diseñados sugieren cambios para aprobación humana en lugar de aplicarlos automáticamente cuando el criterio importa. Este patrón genera confianza, detecta casos límite y mantiene a las partes interesadas al tanto.


---

# 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/best-practices.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.
