> 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/build-a-playbook.md).

# Ein Playbook erstellen

Definiere Eingaben, Abschnitte, Tools, Artefakte, Prüfungen und Trigger in einem Playbook

Playbooks bestehen aus Eingaben, Abschnitten, Tools, Artefakten, Human-Review-Blöcken und Triggern. Definieren Sie jeden Teil klar, damit der Agent den richtigen Kontext hat und Reviewer die richtigen Kontrollpunkte haben.

## Wähle ein Modell

Verwenden Sie die **Modell** Auswahlfeld im Playbook-Editor, um **Auto** oder ein verfügbares Modell auszuwählen. Die angezeigten Optionen hängen von Ihrem Workspace und den verfügbaren Anbietern ab.

**GPT-6 Sol**, **GPT-6 Luna**, **Claude Opus 5.5**, **Claude Sonnet 5.5**, und **Kimi K3** sind im Auswahlfeld verfügbar. Wählen Sie Sol oder Opus 5.5 für komplexe Aufgaben oder Luna, wenn Geschwindigkeit und Kosten wichtiger sind.

### Modellbewertungen vergleichen

Erweitern Sie ein Modell, um seine unterstützten **Reasoning-Aufwand** anzupassen und die für diese Auswahl verfügbaren Bewertungen zu vergleichen:

| Bewertung           | Was mehr Balken bedeuten                                                                          |
| ------------------- | ------------------------------------------------------------------------------------------------- |
| **Geschwindigkeit** | Schnellere durchschnittliche Fertigstellung in Benchmark-Läufen                                   |
| **Intelligenz**     | Höhere allgemeine Leistungsfähigkeit basierend auf dem öffentlichen Artificial-Analysis-Benchmark |
| **Kosteneffizienz** | Weniger verbrauchte Tasks pro Benchmark-Lauf                                                      |

Die Bewertungen ändern sich mit dem ausgewählten Reasoning-Aufwand, wenn Benchmark-Daten verfügbar sind. Einige Modelle und Aufwandseinstellungen haben keine Bewertungen. Betrachten Sie die Balken als Vergleichshilfe: Ihr Playbook, Ihre Inputs und Tools beeinflussen die tatsächliche Laufzeit, den Task-Verbrauch und die Ausgabequalität. Auto hat keinen festen Modell- und Aufwand-Benchmark.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-931066925d9c8a7297d5b2aa5f05f6558ba3142b%2Fbuild-playbook-01-model-selector.png?alt=media" alt="Playbook model selector grouped by provider, with Kimi K3 expanded to show reasoning effort and Speed, Intelligence, and Cost efficiency ratings"><figcaption><p>Erweitern Sie ein Modell, um seine Bewertungen bei jedem Reasoning-Aufwand zu vergleichen.</p></figcaption></figure>

## Wählen Sie einen Ausführungsmodus

Verwenden Sie **Schnell** oder **Max** im Playbook-Editor, um auszuwählen, wie gründlich das Playbook seine Arbeit prüft:

| Modus       | Verwenden Sie es, wenn                                                                                     |
| ----------- | ---------------------------------------------------------------------------------------------------------- |
| **Schnell** | Sie schneller Entwürfe mit einer fokussierten Faktenprüfung und weniger Verifizierungs-Schleifen wünschen. |
| **Max**     | Sie gründliche Faktenprüfung, Quellensuche und wiederholte Prüfungen benötigen. Dies ist der Standard.     |

Veröffentlichen Sie das Playbook, um den Modus mit dieser Version zu speichern. Eine Session behält den Modus der Version bei, mit der sie ausgeführt wurde, und Sie können ihn in der Session einsehen **Details**. Wenn Sie den Entwurf ändern, ändert das den Modus einer bestehenden Session oder einer angehefteten Version nicht.

## 1. Inputs definieren

Inputs sind die Art und Weise, wie ein Playbook zur Laufzeit Informationen erhält.

| Geben Sie | Verwenden für                                                                      |
| --------- | ---------------------------------------------------------------------------------- |
| Text      | Keywords, URLs, Prompts, frei formulierte Zeichenfolgen.                           |
| Zahl      | Zählwerte, Schwellenwerte, Rankings.                                               |
| Datei     | Dokumente, Briefings und Exporte, die das Playbook während eines Laufs lesen soll. |
| Brand Kit | Tonfall, Schreibregeln, Zielgruppen, Regionen und visuelle Richtlinien.            |

Klicken Sie auf **Erweiterte Einstellungen anzeigen** bei einem Input, um Variablenname, Beschreibung, Platzhalter und Standardwert festzulegen.

## 2. Abschnitte definieren

Abschnitte sind das strukturelle Rückgrat eines Playbooks. Jeder Abschnitt enthält Anweisungen und kann optional mit einem Human-Review-Block enden.

Organisieren Sie Abschnitte nach logischer Phase, nicht nach Reviewer. Eine Content-Pipeline könnte Folgendes verwenden:

1. **Erfassung und Validierung:** Den Input parsen, validieren und Kontext sammeln.
2. **Recherche und Strategie:** Knowledge Bases durchsuchen, SERPs analysieren und Wettbewerber prüfen.
3. **Briefing-Zusammenstellung:** Recherche in ein umsetzbares Briefing verdichten.
4. **Artikelentwurf und Verlinkung:** Den Inhalt erzeugen und interne Links hinzufügen.
5. **Abschließende Prüfung:** Vor der Veröffentlichung für Human Review anhalten.

Templates verwenden innerhalb jedes Abschnitts eine konsistente Struktur. Verwenden Sie dieses Muster als Ausgangspunkt und passen Sie es dann an die Aufgabe an:

* **Ziel:** Definieren Sie, was der Abschnitt erreichen soll.
* **Inputs und Referenzen:** Benennen Sie die Inputs, Artefakte, Brand-Kit-Felder, Tools und Knowledge Bases, die der Abschnitt verwenden soll. Fügen Sie sie nach Möglichkeit über das Slash-Menü ein.
* **Anweisungen:** Listen Sie die Arbeit in klaren, nummerierten Schritten auf.
* **Ausgabe:** Benennen Sie das Artefakt, in das der Abschnitt schreiben soll, und das Format, das es verwenden soll.

## 3. Tools hinzufügen

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

Inputs, Artefakte und Tools lassen sich leichter wiederverwenden, wenn Sie sie über das Slash-Menü einfü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-e1b0b98c35cd159dda4994c870bebaa731e1edcf%2Fbuild-playbook-02-slash-menu.png?alt=media" alt="Slash menu in a Playbook Section showing Inputs, Artifacts, Tools, Brand Kit, and formatting options, with the Tools submenu open"><figcaption><p>Geben Sie / ein, um Tools, Inputs und Artefakte als Referenzen einzufügen.</p></figcaption></figure>

Für den vollständigen Tool-Katalog, MCP-Connectors und Best Practices siehe [Tools](https://docs.airops.com/docs/de/aktionen/playbooks/tools.md).

### AirOps

* **AirOps MCP:** Greifen Sie auf Ihre AirOps-Daten zu, einschließlich Insights-Daten, Brand Kits, Knowledge Bases und Grids.
* **AirOps SEO Research:** Keyword-Recherche, Domain-Analyse und Backlink-Daten.
* **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:** Inhalte von Webseiten scrapen.

### SEO Research

* **DataForSEO:** SEO-Daten und Keyword-Recherche.
* **Moz:** SEO- und Domain-Analyse.
* **Google Search Console:** GSC-Daten.

### Web Research

* **Google Search:** Google-Ergebnisse suchen und abrufen.
* **Parallel Web Systems:** Verwenden Sie die Parallel Search API, die Parallel Extract API und die Parallel Task API, um Web-Recherche durchzuführen, strukturierte Daten aus URLs zu ziehen und Recherche-Inputs in strukturierte Ausgaben zu verarbeiten.
* **Firecrawl:** Webseiten crawlen und scrapen.
* **Reddit:** Weitere Details finden Sie unter [Sprich mit dem Vertrieb](https://www.airops.com/book-a-call).

### Bild und Video

* **Bildgenerierung:** Gehostete Bilder mit GPT Image 2.5 Sunburst, GPT Image 2.5 Flare, GPT Image 2 oder Nano Banana 2 generieren oder bearbeiten. Siehe [Bild- und Video-Tools](https://docs.airops.com/docs/de/aktionen/playbooks/tools/image-and-video.md) für Modellhinweise.
* **Stockbilder:** Getty Images oder Unsplash durchsuchen und dann ein ausgewähltes Bild per ID für die Verwendung in einem Artefakt oder einem Veröffentlichungsschritt abrufen.

### Wissensmanagement

* **Slack:** Kanalverlauf lesen und Nachrichten senden.
* **Google Docs:** Google-Docs-Dokumente lesen und bearbeiten.

### B2B-Anreicherung

* **Brandfetch:** Markenressourcen und Informationen abrufen.
* **Hunter.io:** E-Mail-Adressen finden und verifizieren. Weitere Details finden Sie unter [Sprich mit dem Vertrieb](https://www.airops.com/book-a-call).

### Anzeigen

* **OpenAI Ads:** Kontoleistung abrufen. Kampagnen, Anzeigengruppen und Anzeigen erstellen und verwalten, sofern Schreib-Tools aktiviert sind. Siehe [Ads-Tools](https://docs.airops.com/docs/de/aktionen/playbooks/tools/ads.md) für Verfügbarkeit und Prüfschritte.

Sie können jeden benötigten MCP-Connector in den Einstellungen Ihrer Workspace-MCP-Connectors hinzufügen. Verbundene MCP-Tools erscheinen in der Tools-Liste des Playbook-Editors.

{% hint style="info" %}
Wenn Sie einen Knowledge-Base-Suchschritt hinzufügen, verweisen Sie im Knowledge-Base-Auswahlfeld des Schritts auf die Knowledge Base mit ihrem Namen. Verlassen Sie sich nicht auf die automatische Auswahl, wenn das Playbook eine bestimmte Quelle benötigt.
{% endhint %}

## 4. Human Review hinzufügen

Platzieren Sie Human Review als Block am Ende eines bestehenden Abschnitts. Erstellen Sie keinen separaten Abschnitt nur für die Prüfung.

Verwenden Sie Human Review, wenn jemand Text genehmigen, zwischen Optionen wählen oder generierte Ausgaben bearbeiten muss, bevor der nächste Abschnitt ausgeführt wird.

Zu den Reviewer-Optionen gehören:

* **Benannte Person:** Ein bestimmtes Teammitglied.
* **Aktueller Benutzer:** Die Person, die das Playbook ausgelöst hat.
* **Jedes Mitglied kann prüfen:** Jedes Mitglied des Workspaces kann prüfen.

Reviews erscheinen im Posteingang.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-aa59d35d0bf59d0595c551ddcf26add728f5cd0c%2Fbuild-playbook-03-human-review.png?alt=media" alt="Reviewer menu on a Section&#x27;s Human Review block, with Any member can review, Current user, and teammates listed, and Maya Chen selected"><figcaption><p>Fügen Sie Human Review am Ende eines Abschnitts hinzu. Reviews erscheinen im Posteingang.</p></figcaption></figure>

{% hint style="info" %}
Eine native bedingte Weiterleitung an mehrere Reviewer ist noch nicht verfügbar. Der aktuelle Workaround ist ein Abschnitt pro Reviewer, mit Skip-Logik in den Abschnittsanweisungen. Zum Beispiel: "Wenn die Komplexität nicht 3 ist, überspringen Sie diesen Abschnitt."
{% endhint %}

## 5. Artefakte deklarieren

Artefakte sind die persistenten Ausgaben, die ein Playbook erzeugt. Deklarieren Sie eines, wenn ein Ergebnis gespeichert, geprüft, geteilt, downstream wiederverwendet oder nach dem Ende der Session veröffentlicht werden soll.

Unterstützte Artefakt-Typen umfassen:

* Markdown
* HTML
* JSON
* CSV
* PNG
* JPG
* GIF

Geben Sie jedem Artefakt einen klaren Namen und verweisen Sie dann im Abschnitt darauf, der darin schreiben soll. Wenn ein Abschnitt kein Artefakt erzeugt, bleibt sein Inhalt im Session-Kontext.

Für stabile Links, Kommentare, Vorschläge, Erwähnungen, Bearbeiten mit KI, Versionsverlauf und Grid-Wiederverwendung siehe [Artefakte](https://docs.airops.com/docs/de/aktionen/playbooks/artifacts.md).

## 6. Einen Trigger konfigurieren

Trigger bestimmen, wie ein Playbook startet.

| Auslöser    | So funktioniert es                                                                                                                               | Am besten geeignet für                                                                     |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
| Zeitplan    | Wird in einem wiederkehrenden Rhythmus ausgeführt, z. B. jeden Montag um 9 Uhr.                                                                  | Wöchentliche Content-Audits, Aktualitätsprüfungen von Brand Kits, wiederkehrende Berichte. |
| Webhook     | Startet, wenn ein externes System eine HTTP-Anfrage an die Playbook-Webhook-URL sendet.                                                          | CMS-Veröffentlichungsereignisse, Formulareinsendungen, Integrationen von Drittanbietern.   |
| Monitor     | Verwendet Parallel Web Systems, um alle 12 Stunden eine Monitoring-Abfrage zu prüfen, und startet das Playbook, wenn die Bedingung erkannt wird. | Wettbewerbswarnungen, Marktüberwachung, Überwachung der Inhaltsgesundheit.                 |
| AEO Insight | Startet, wenn aktivierte AEO-Insight-Schwellenwerte erreicht werden, z. B. wenn sich Erwähnungsrate, Share of Voice oder Zitierungsrate ändern.  | Programmatic Refresh, Wettbewerbsreaktion, AEO-Abdeckungslücken.                           |

{% hint style="info" %}
Trigger können verwenden **Standard** oder eine angeheftete Playbook-Version. **Standard** folgt der aktuellen veröffentlichten Version. Ein angehefteter Trigger verwendet weiterhin die ausgewählte Version, bis Sie sie ändern. Wenn eine neue Version Inputs ändert, aktualisieren Sie die Trigger-Input-Konfiguration, bevor Sie sich auf zukünftige Läufe verlassen. Siehe [Playbook-Trigger](https://docs.airops.com/docs/de/aktionen/playbooks/triggers.md) für Einrichtungsschritte und Beispiele für Webhook-Payloads.
{% endhint %}

## 7. Mit Quill iterieren

Quill ist der AirOps-Agentenkapitän für die Playbook-Erstellung. Klicken Sie auf die grüne schwebende Schaltfläche unten rechts im Editor.

[Quill](https://docs.airops.com/docs/de/quill.md) kann:

* Ihr Playbook aus Prompts in natürlicher Sprache bearbeiten.
* Einen Workflow-Prompt als kurze Agentenanweisung mit Kontext umschreiben.
* Datei- und Bildanhänge verwenden, um das Playbook oder das Brand Kit zu aktualisieren.
* Über die Playbook-Struktur nachdenken und Umstrukturierungen vorschlagen.

Geben Sie Quill im Voraus den vollständigen Kontext. Im Chat, **Enter** sendet ab, also halten Sie jede Anweisung in einem Absatz.

Duplizieren Sie ein Playbook vor einer größeren strukturellen Überarbeitung, damit Sie einen sauberen Rollback-Punkt haben.

## Playbook-Zustand prüfen

Überprüfen **Zustand** in der Playbooks-Liste oder öffnen Sie die Zustandssteuerung im Editor, um Prüfungen zu sehen, die vor dem Veröffentlichen oder Ausführen des Playbooks Aufmerksamkeit benötigen.

## 8. Veröffentlichen

Das Veröffentlichen erstellt einen versionierten Snapshot, von dem nachgelagerte Verbraucher aus Grids und Triggern ausführen können. Verwenden Sie einen Webhook-Trigger, wenn ein externes System ein Playbook programmatisch starten soll. Entwürfe bleiben bearbeitbar. Veröffentlichte Versionen sind ausführbare Referenzen.

Wenn Sie Inputs geändert haben, aktualisieren Sie alle Grid-Zuordnungen und Trigger-Input-Konfigurationen, die dieses Playbook verwenden, bevor Sie es in großem Umfang ausführen.

### Eine frühere Version wiederherstellen

Öffnen Sie den Versionsverlauf im Playbook-Editor, wählen Sie die gewünschte Version aus und klicken Sie auf **Wiederherstellen**. AirOps kopiert diese Version in den aktuellen Entwurf, damit Sie sie vor dem Veröffentlichen überprüfen können.

Das Wiederherstellen einer Version ersetzt den aktuellen Entwurf. Laden Sie alle Entwurfsänderungen, die Sie behalten möchten, herunter oder veröffentlichen Sie sie, bevor Sie eine ältere Version wiederherstellen.

Wiederherstellen ist in den Tarifen Free, Starter, Pro, Pro Plus und Platform verfügbar.

## Ein Playbook importieren oder exportieren

Der Editor kann ein Playbook als Markdown oder JSON herunterladen. Er kann Markdown oder JSON auch in ein bestehendes Playbook importieren.

{% hint style="warning" %}
Beim Importieren von Markdown oder JSON wird der aktuelle Playbook-Inhalt überschrieben. Laden Sie zuerst das vorhandene Playbook herunter, wenn Sie einen Rollback-Punkt benötigen.
{% endhint %}


---

# 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/build-a-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.
