> 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/getting-started/building-your-first-playbook.md).

# Dein erstes Playbook erstellen

Erstelle und führe dein erstes AirOps Playbook aus

In diesem Tutorial erstellst du ein Playbook zur Content-Erstellung. Das Playbook nimmt ein primäres Keyword oder einen Ziel-Prompt, recherchiert LLM-Suchergebnisse aus AirOps Insights und Google-Ergebnisse, erstellt eine Gliederung, entwirft den Artikel, fügt Links hinzu und erzeugt einen finalen Markdown-Artikel.

Dieses Beispiel für Owned Content zeigt, wie du eine KI-Entdeckungsmöglichkeit in wiederholbare Agentenarbeit mit deinem Markenkontext und Human Review überführst. Du kannst denselben Ansatz auf andere Recherche-, Aktualisierungs- und Optimierungsaufgaben in deiner Strategie anwenden.

## Bevor Sie beginnen

Für die qualitativ hochwertigste Ausgabe konfiguriere die beiden Kontextquellen, auf die dieses Playbook angewiesen ist:

* **AirOps Insights:** Verfolge die Prompts, Themen, Wettbewerber und Seiten, die dir wichtig sind. Das Playbook nutzt AirOps Insights, um LLM-Suchergebnisse, Zitate in diesen Antworten und AEO-Chancen für den Ziel-Prompt zu recherchieren.
* **Brand Kit:** Halte dein Brand Kit aktuell, damit das Playbook deine Positionierung, Zielgruppe, Stimme, Schreibregeln, Produktlinien und den Wettbewerberkontext verwenden kann.

## Was du erstellen wirst

Das Playbook wird:

1. Ein primäres Keyword, einen Ziel-Prompt und das Brand Kit als Inputs akzeptieren.
2. LLM-Suchergebnisse aus AirOps Insights recherchieren und sie mit Google-Ergebnissen vergleichen.
3. Wettbewerberinhalte und Inhaltslücken analysieren.
4. Eine Gliederung, einen Entwurf, eine Link-Map und einen finalen Artikel erstellen.
5. Vor der Freigabe des finalen Artikels für Human Review anhalten.

## Schritt 1: Ein leeres Playbook erstellen

1. Klicken Sie auf **Erstelle**.
2. Wählen Sie **Playbook**.
3. Wählen Sie **Leeres Playbook**.
4. Das Playbook benennen **Blog-Erstellung**.

AirOps öffnet den Playbook-Editor. Der Editor hat eine Kopfzeile mit Chips für Tools, Inputs, Artefakte und **Trigger hinzufügen**, plus Aktionen oben rechts für **Playbook ausführen**, **Veröffentlichen**, und **Ausführungsverlauf**.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-02e3ddae1a4e5c1808f6d515db03adc38ae25f49%2Ffirst-playbook-01-blank-editor.png?alt=media" alt="Blank Blog Creation Playbook in the AirOps Playbook editor, with 1 Tool and Add Trigger chips above an empty Section"><figcaption><p>Ein neues leeres Playbook. Die Chips für Inputs und Artefakte erscheinen, sobald das Playbook mindestens eines von beidem hat.</p></figcaption></figure>

## Schritt 2: Inputs hinzufügen

Erstelle die Inputs, die das Playbook zur Laufzeit benötigt.

| Input-Name        | Geben Sie | Beschreibung                                                                  |
| ----------------- | --------- | ----------------------------------------------------------------------------- |
| `primary_keyword` | Text      | Das SEO-Keyword, auf das der Artikel abzielen soll.                           |
| `target_prompt`   | Text      | Der LLM-Such-Prompt oder die Frage, die der Artikel beantworten helfen soll.  |
| `brand_kit`       | Brand Kit | Das Brand Kit, das Positionierung, Zielgruppe, Stimme und Regeln leiten soll. |

Das Playbook sollte funktionieren, wenn entweder `primary_keyword` oder `target_prompt` bereitgestellt wird. Wenn beide bereitgestellt werden, verwende beide, um die Recherche und die Artikelstrategie zu formen.

## Schritt 3: Tools hinzufügen

Geben Sie `/` in einem beliebigen Abschnitt, um das Slash-Menü zu öffnen. Verwende es, um Tools, Inputs, Artefakte und andere Verweise direkt in die Playbook-Anweisungen einzufügen.

Füge für dieses Tutorial die Tools hinzu, die mit deinem Workspace verbunden sind:

* **Google Search:** Aktuelle Google-Ergebnisse für das Ziel-Keyword finden.
* **Parallel Web Systems:** Verwende die Parallel Search API, die Parallel Extract API und die Parallel Task API, um das Web zu recherchieren, Quellinhalte zu extrahieren und Ergebnisse zu strukturieren.
* **AirOps SEO Research:** Keyword-, Domain- und SEO-Kontext abrufen.
* **DataForSEO**, **Moz**, oder **Google Search Console:** Füge SEO-Daten hinzu, wenn dein Workspace diese Quellen verwendet.
* **Page 360 Report:** Analysieren Sie eine eigene URL in Bezug auf Suchleistung, KI-Sichtbarkeit, Aktualität, Autoritätssignale und Seiteninhalt.
* **Page Versus Report:** Vergleichen Sie eine eigene URL mit den Seiten, die in Suche und KI-Antworten gewinnen, und zeigen Sie dann Lücken auf, die geschlossen werden müssen.
* **Web Page Scrape:** Bestimmte Seiten lesen, die das Playbook prüfen muss.
* **Brandfetch:** Unternehmens- oder Markendetails bei Bedarf anreichern.

{% hint style="info" %}
Du brauchst nicht jedes Tool für die erste Version. Beginne mit Google Search, Parallel Web Systems, AirOps SEO Research und den AirOps-Seitenberichten, die für den Artikel relevant sind.
{% endhint %}

## Schritt 4: Artefakte deklarieren

Artefakte sind die dauerhaften Ausgaben, die das Playbook erzeugt. Füge diese Artefakte hinzu, bevor du die Abschnitte schreibst, damit du sie namentlich referenzieren kannst.

| Artefakt                    | Geben Sie | Zweck                                                                                                           |
| --------------------------- | --------- | --------------------------------------------------------------------------------------------------------------- |
| **AI & Google Results.md**  | Markdown  | Erfasst vorhandene Inhalte, die wichtigsten Google-Ergebnisse und Zitate aus LLM-Antworten aus AirOps Insights. |
| **Competitive Analysis.md** | Markdown  | Fasst Suchintention, Wettbewerberstruktur, Keywords, FAQs, Lücken und den AEO-Fit zusammen.                     |
| **Topic Research.md**       | Markdown  | Speichert verifizierte Fakten, Experteneinblicke, Beispiele und Korrekturen von Behauptungen.                   |
| **Content Outline.md**      | Markdown  | Definiert die Artikelstruktur und das Schreibbriefing.                                                          |
| **Article Draft.md**        | Markdown  | Speichert den ersten vollständigen Artikelentwurf.                                                              |
| **Link Map.json**           | JSON      | Ordnet interne und externe Links den Artikelabschnitten zu.                                                     |
| **Final Article.md**        | Markdown  | Speichert den fertigen Artikel mit Links.                                                                       |

Verwende das Slash-Menü, um später in Abschnitten Verweise auf Artefakte einzufügen. Verweise auf Artefakte nach Namen, nicht nach dem in einer Session erzeugten Dateinamen.

## Schritt 5: Die Abschnitte schreiben

Verwende Abschnitte, um die Arbeit in Phasen zu beschreiben. Halte die erste Version auf den Hauptpfad fokussiert.

Formatiere jeden Abschnitt mit einem kurzen **Ziel**, den Inputs oder Artefakten, auf die er sich beziehen soll, klar **Anweisungen**, und dem erwarteten **Ausgabe** Artefakt. Verwende das Slash-Menü, um Verweise auf Inputs, Artefakte, Tools und das Brand Kit einzufügen, statt ihre Namen manuell einzugeben.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1c956159aa6f1a1843800819574df7cfab671275%2Ffirst-playbook-02-sections-and-references.png?alt=media" alt="Blog Creation Playbook with 6 Tools, 3 Inputs, and 7 Artifacts, and a Section referencing Inputs, Tools, and the AI &#x26; Google Results Artifact as pills"><figcaption><p>Füge Inputs, Tools und Artefakte über das Slash-Menü ein, damit sie als Pills erscheinen.</p></figcaption></figure>

### Abschnitt A: LLM-Antworten und Google-Ergebnisse recherchieren

Weise das Playbook an:

* Die Brand-Website auf vorhandene Inhalte prüfen, die mit dem Keyword oder Prompt zusammenhängen.
* AirOps Insights verwenden, um LLM-Suchergebnisse und Zitate für den Ziel-Prompt zu recherchieren.
* Google Search und SEO-Tools verwenden, um die wichtigsten Google-Ergebnisse für das primäre Keyword zu sammeln.
* Social Media, Foren und Wettbewerber-Domains nach Möglichkeit ausschließen.
* Schreibe die Ergebnisse in **AI & Google Results.md**.

### Abschnitt B: Wettbewerber und Lücken analysieren

Weise das Playbook an:

* Extrahiere Überschriften, Textinhalt, Wortanzahl und FAQ-Abschnitte aus den stärksten zitierten und rankenden Seiten.
* Analysiere Suchintention, Themenabdeckung, Struktur, Keywords, FAQs und Lücken.
* Nutze das Brand Kit, um Blickwinkel zu identifizieren, die die Marke glaubwürdig besetzen kann.
* Schreibe die Analyse in **Competitive Analysis.md**.

### Abschnitt C: Themenrecherche zusammentragen

Weise das Playbook an:

* Erstelle eine Recherche-Agenda aus **Competitive Analysis.md**.
* Finde aktuelle Statistiken, Expertenperspektiven, Praxisbeispiele und veraltete Wettbewerber-Behauptungen.
* Bevorzuge primäre und autoritative Quellen.
* Schreibe die Ergebnisse in **Topic Research.md**.

### Abschnitt D: Die Gliederung erstellen

Weise das Playbook an:

* Verwenden Sie **Competitive Analysis.md**, **Topic Research.md**, und dem Brand Kit, um die Artikelstrategie zu definieren.
* Füge H1, H2s, H3s, Ziel-Wortzahl, Kernaussagen, Keywords, Recherchenotizen, Leserfragen und den Markenblickwinkel hinzu.
* Schreibe die Gliederung in **Content Outline.md**.

### Abschnitt E: Den Artikel entwerfen und prüfen

Weise das Playbook an:

* Entwirf den Artikel aus **Content Outline.md**.
* Verwenden Sie **Topic Research.md** für Fakten, Beispiele und Quellen.
* Folge der Stimme des Brand Kits, der Zielgruppe, den Schreibregeln und den Konventionen für Inhaltstypen.
* Schreibe den Entwurf in **Article Draft.md**.
* Vor dem Finalisieren für Human Review anhalten.

### Abschnitt F: Links hinzufügen und finalisieren

Weise das Playbook an:

* Füge relevante interne Links von der Brand-Website hinzu.
* Füge externe Links hinzu, die bestimmte Aussagen stützen.
* Schreibe den Link-Plan in **Link Map.json**.
* Schreibe den fertigen Artikel in **Final Article.md**.

## Schritt 6: Ausführen und veröffentlichen

1. Klicken Sie auf **Playbook ausführen**.
2. Gib ein primäres Keyword, einen Ziel-Prompt oder beides ein.
3. Wähle das Brand Kit aus.
4. Prüfe jedes Artefakt, sobald es erstellt wird.
5. Schließe den Human-Review-Schritt aus dem Posteingang oder der Sitzungsansicht ab.
6. Bestätige, dass **Final Article.md** abgeschlossen ist.
7. Klicken Sie auf **Veröffentlichen** wenn die Playbook-Struktur zuverlässig funktioniert.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2a18e6088e125da3f7b4baa05b1f0a9e775fbfa1%2Ffirst-playbook-03-session-human-review.png?alt=media" alt="Blog Creation Session paused for Human Review, with Article Draft.md open, 4 of 6 steps complete, and Request Changes and Approve buttons"><figcaption><p>Prüfe jedes Artefakt und genehmige dann den Entwurf oder fordere Änderungen an, bevor der finale Artikel geschrieben wird.</p></figcaption></figure>

Veröffentlichte Playbooks können aus Grids und Triggern ausgeführt werden. Verwende einen [Webhook-Trigger](https://docs.airops.com/docs/de/aktionen/playbooks/triggers.md) wenn ein externes System ein Playbook programmatisch starten soll. Entwurfsänderungen bleiben bearbeitbar, aber nachgelagerte Ausführungen verwenden eine veröffentlichte Version.

## Erweitere dein Playbook

Nach der Veröffentlichung kannst du:

* Das Playbook zu einem Grid hinzufügen, um Artikel für viele Keywords oder Prompts zu erstellen.
* Einen Schedule-, Webhook- oder Monitor-Trigger hinzufügen.
* Verwenden Sie [Quill](https://docs.airops.com/docs/de/quill.md) um das Playbook anhand natürlicher Sprache zu überarbeiten.
* Einen separaten Publishing-Flow für CMS-Updates erstellen.

{% hint style="info" %}
Best Practice ist es, Content-Erstellung und CMS-Publishing getrennt zu halten. Führe zuerst das Content-Playbook aus, prüfe die Ausgabe und veröffentliche dann über eine Grid-Spalte, ein separates Publishing-Playbook oder ein CMS-MCP. 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 Update-Typ, damit AirOps Insights zukünftige Leistungsänderungen mit diesem Content-Update verknüpfen kann.
{% endhint %}

Glückwunsch, du hast dein erstes Playbook zur Content-Erstellung gebaut und ausgeführt.

Diese Schritt-für-Schritt-Anleitung folgt derselben allgemeinen Struktur wie die **Blog-Erstellung** Vorlage. Führe die Vorlage mit demselben Keyword, Ziel-Prompt und Brand Kit aus, wenn du die Ergebnisse vergleichen und sehen möchtest, wie eine vollständigere Version dasselbe Briefing handhabt.

Für weiterführende Informationen siehe [Ein Playbook erstellen](https://docs.airops.com/docs/de/aktionen/playbooks/create-a-playbook.md), [Ein Playbook aufbauen](https://docs.airops.com/docs/de/aktionen/playbooks/build-a-playbook.md), und [Ein Playbook ausführen](https://docs.airops.com/docs/de/aktionen/playbooks/run-a-playbook.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/de/getting-started/building-your-first-playbook.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.
