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

# Best Practices

Praktische Hinweise zum Erstellen zuverlässiger Playbooks

Verwende diese Best Practices, um Playbooks einfacher auszuführen, zu überprüfen und zu verbessern.

## Beginne mit dem Brand Kit und der Prompt-Abdeckung

Ein aktuelles Brand Kit und eine vollständige Prompt-Abdeckung sind die beiden größten Qualitätshebel. Bestätige beides, bevor du die Playbook-Struktur optimierst.

## Beginne mit weniger Anweisungen

Gib dem Agenten genug Orientierung, um das Ziel zu verstehen, und füge dann dort Einschränkungen hinzu, wo du ein vorhersehbares Verhalten brauchst. Zu stark vorgegebene Anweisungen können die Fähigkeit des Agenten einschränken, Randfälle selbst zu durchdenken.

## Strukturiere Abschnitte nach Phase

Verwende Phasen wie **Recherche**, **Entwurf**, und **Überprüfen**. Vermeide es, Abschnitte nach Personen zu organisieren, etwa als „Strategist Section“ oder „Editor Section“. Eine phasenbasierte Struktur lässt sich leichter wiederverwenden und leichter überprüfen.

## Formatiere jeden Abschnitt konsistent

Gib jedem Abschnitt eine vorhersehbare interne Struktur, damit der Agent das Ziel versteht, der Prüfer die Arbeit schnell überblicken kann und nachgelagerte Abschnitte wissen, welches Artifact verwendet werden soll.

Ein starker Abschnitt enthält in der Regel:

* **Ziel:** Ein oder zwei Sätze, die festlegen, was dieser Abschnitt erreichen soll.
* **Inputs und Referenzen:** Die Inputs, Artifacts, Brand Kit-Felder, Tools oder Knowledge Bases, die der Abschnitt verwenden soll. Füge diese nach Möglichkeit über das Slash-Menü ein.
* **Anweisungen:** Nummerierte Schritte für die Arbeit, die der Agent ausführen soll. Konzentriere dich dabei auf Entscheidungen, Einschränkungen und Quellpräferenzen.
* **Ausgabe:** Das Artifact, das der Abschnitt schreiben soll, plus das erforderliche Format, z. B. ein Markdown-Report, eine JSON-Karte oder ein fertiger Artikel.

Verwende dasselbe Muster über alle Abschnitte hinweg. Ein Recherche-Abschnitt könnte zum Beispiel das Ziel nennen, auf den Ziel-Prompt und das Brand Kit verweisen, die Rechercheschritte auflisten und die Erkenntnisse dann in **AI & Google Results.md**. Ein Entwurfsabschnitt könnte auf **Content Outline.md** und **Topic Research.md**verweisen, die Schreibanforderungen auflisten und den Entwurf dann in **Article Draft.md**.

## Verwende Abschnitte als Meilensteine

Füge einen Abschnitt hinzu, wenn du Folgendes brauchst:

* Ein eigenständiges Artifact.
* Eine Pause für die menschliche Überprüfung.
* Einen klaren Bezugspunkt für spätere Abschnitte.

## Schreibe Artifacts nur, wenn du Persistenz benötigst

Kontext wird automatisch zwischen Abschnitten weitergegeben. Verwende Artifacts, wenn ein Ergebnis gespeichert, geteilt oder später referenziert werden muss.

## Verweise auf Knowledge Bases mit Namen

Wähle die spezifische Knowledge Base im Knowledge-Base-Auswahlfeld des Schritts aus. Die automatische Auswahl oder die Suche über alle Knowledge Bases hinweg kann aus der falschen Quelle abrufen.

## Verweise auf Artifacts mit Namen

Artifact-Namen sind stabil. Dateinamen können sich ändern. Verwende das Slash-Menü, um Artifact-Verweise nach Namen in nachgelagerten Abschnitten einzufügen.

## Trenne die Veröffentlichung von der Inhaltserstellung

Verwende Playbooks, um Inhalte zu erstellen, zu aktualisieren, zu überprüfen und vorzubereiten. Veröffentliche aus einer Grid-Spalte, einem separaten Publishing-Playbook oder über ein CMS MCP nach der Überprüfung. So bleiben redaktionelle Prüfung, CMS-Feldzuordnung und Veröffentlichungsverfolgung leichter kontrollierbar.

Wenn ein Playbook oder ein CMS MCP eine Seite veröffentlicht oder aktualisiert, verwende das AirOps MCP `track_aeo_page_content_update` Tool mit der Seiten-URL und dem Aktualisierungstyp, damit AirOps Insights künftige Änderungen bei AI-Sichtbarkeit, Zitaten, Erwähnungen und Traffic mit dieser Inhaltsaktualisierung verknüpfen kann.

## Kombiniere Playbooks zum Auffinden von Chancen und zum Erzeugen von Ergebnissen

Lass ein Playbook Daten überwachen und Chancen finden und ein separates Aktions-Playbook dann die Ausgabe erzeugen. So wird jedes Playbook leichter verständlich, überprüfbar und iterierbar.

## Bitte Quill, Workflow-Prompts zu übersetzen

Wenn du einen Workflow migrierst, füge den ursprünglichen Prompt mit vollem Kontext ein und bitte [Quill](https://docs.airops.com/docs/de/quill.md) ihn in eine prägnante Agentenanweisung zu übersetzen. Kürze das Ergebnis anschließend weiter.

## Vorgeschlagene Änderungen menschlich prüfen lassen

Gut gestaltete Playbooks schlagen Änderungen zur menschlichen Freigabe vor, statt sie automatisch anzuwenden, wenn Urteilsvermögen gefragt ist. Dieses Muster schafft Vertrauen, deckt Randfälle auf und hält die Stakeholder auf dem Laufenden.


---

# 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/de/aktionen/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.
