> 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.md).

# Playbooks

Playbooks mit Anweisungen in natürlicher Sprache erstellen und ausführen

Playbooks ermöglichen es dir, Arbeit als Anweisungen in natürlicher Sprache zu beschreiben, Kontext wie ein Brand Kit anzuhängen und den Prozess von Anfang bis Ende auszuführen, während Prüfer im Loop bleiben.

{% hint style="warning" %}
Playbooks können nicht innerhalb von Workflows verwendet werden. Du kannst ein Playbook aus einem bestehenden Workflow erstellen, aber du kannst ein Playbook nicht als Workflow-Schritt hinzufügen.
{% endhint %}

Ein Playbook besteht aus:

* **Ein Playbook im Dokumentstil** das beschreibt, was der Agent tun soll.
* **Eingaben** die das Playbook zur Laufzeit akzeptiert, wie Text, Zahlen, Dateien oder ein Brand Kit.
* **Abschnitte** die Anweisungen, Tool-Aufrufe und Kontrollpunkte für die menschliche Prüfung enthalten.
* **Tools** die der Agent verwenden kann, darunter SEO-Research, Web-Research, Bild und Video, MCP-Connectoren und mehr.
* **Artefakte** die das Playbook erzeugt, wie Markdown-, HTML-, JSON-, CSV-, PNG-, JPG- oder GIF-Dateien.
* **Trigger** die bestimmen, wie ein Playbook startet, einschließlich Zeitplan, Webhook, Monitor und AEO Insight, wenn aktiviert.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1f84287eb1edf5ffbbdd31bcc303a5bae367ce29%2Fplaybooks-01-list.png?alt=media" alt="Playbooks tab under Actions listing five SpaceOps Playbooks with their Health, Model, Version, Triggers, and Last Edited details"><figcaption><p>Die Playbooks-Liste zeigt den Status, die Version und die Trigger jedes Playbooks an.</p></figcaption></figure>

## Wichtige Konzepte

| Begriff             | Definition                                                                                                                                                                                     |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Playbook            | Die Agentendefinition mit Eingaben, Abschnitten, Tools, Artefakten und einem Trigger. Das Ausführen eines Playbooks erzeugt eine Sitzung.                                                      |
| Abschnitt           | Eine Arbeitseinheit in einem Playbook. Jeder Abschnitt kann Anweisungen, Tool-Aufrufe und einen Block für die menschliche Prüfung enthalten.                                                   |
| Eingabe             | Informationen, die du bereitstellst, wenn ein Playbook ausgeführt wird, wie ein Keyword, eine Ziel-URL, ein Datei-Upload oder ein Brand Kit.                                                   |
| Tool                | Eine Aktion, die der Agent ausführen kann, von Web- und SEO-Recherche bis hin zu nativen Tools wie Slack und Tools, die von MCP-Connectoren bereitgestellt werden.                             |
| Artefakt            | Eine persistente Ausgabe, die das Playbook erzeugt, wie ein Blogbeitrag, ein Bild, eine Analyse oder strukturierte Daten.                                                                      |
| Trigger             | Eine Bedingung, die ein Playbook automatisch startet. Zu den Trigger-Typen gehören Zeitplan, Webhook, Monitor und AEO Insight, wenn aktiviert.                                                 |
| Sitzung             | Ein einzelner Playbook-Durchlauf. Jede Sitzung erzeugt Artefakte und protokolliert die Arbeit, die der Agent ausgeführt hat.                                                                   |
| Posteingang         | Die warteschlange auf Workspace-Ebene, in der Prüfer ausstehende Schritte der menschlichen Prüfung und Sitzungs-Ausgaben sehen, die Aufmerksamkeit erfordern.                                  |
| Ausführungsverlauf  | Die Aufzeichnung jeder Sitzung, die ein Playbook erzeugt hat.                                                                                                                                  |
| Menschliche Prüfung | Ein Pausenpunkt, an dem eine Person die Arbeit des Agenten genehmigen oder bearbeiten muss, bevor es weitergeht.                                                                               |
| Quill               | Der AirOps-Agenten-Kapitän, der dir hilft, Playbooks aus Eingabeaufforderungen in natürlicher Sprache zu erstellen und zu bearbeiten. Siehe [Quill](https://docs.airops.com/docs/de/quill.md). |

## Die beiden Kontextquellen, die die Qualität bestimmen

Bevor du ein Playbook erstellst, stelle sicher, dass AirOps Insights und dein Brand Kit aktuell sind. Diese beiden Kontextquellen prägen die Qualität jeder Sitzung.

### AirOps Insights konfigurieren

AirOps Insights ist die Quelle für Daten zur Sichtbarkeit in der KI-Suche, einschließlich verfolgter Prompts, LLM-Suchergebnisse, Zitate, Wettbewerberpräsenz und Content-Chancen. Wenn ein Playbook nach AEO-Chancen oder LLM-Suchergebnissen recherchiert, sollte es die in AirOps Insights erfassten Daten verwenden, statt KI-Suche als generische Webrecherche zu behandeln.

Decke die Themen, Personas, Regionen und Funnel-Stufen ab, die dir wichtig sind. Erweitere die Abdeckung aus Quellen wie Google-Search-Console-Abfragen, Sprache aus Verkaufsgesprächen, Support-Tickets und Zitierungslücken bei Wettbewerbern.

Das gängige Muster ist: AirOps Insights verfolgt Prompts und LLM-Suchergebnisse, ein Playbook überwacht diese Daten und findet Chancen, dann ergreift ein zweites Playbook Maßnahmen und erstellt oder aktualisiert die Ausgabe.

### Halte dein Brand Kit aktuell

Jedes Playbook kann dein Brand Kit übernehmen, sodass Änderungen an Tonalität, Schreibregeln, Zielgruppen, Regionen, Produktlinien, visuellen Richtlinien und Wettbewerberkontext in die Ausgabe des Playbooks einfließen. Ein veraltetes Brand Kit verschlechtert nachgelagerte Ausgaben.

Prüfe das Brand Kit regelmäßig. Aktualisiere es, wenn du ein Produkt einführst, die Positionierung änderst, eine neue Zielgruppe hinzufügst oder in eine neue Region expandierst.

Verwenden Sie [Brand-Kit-Aktualisierung](https://docs.airops.com/docs/de/kontext/brand-kit/refresh.md) um Live-Quellen zu überwachen und Änderungen am Brand Kit zur menschlichen Freigabe vorzuschlagen.

{% hint style="warning" %}
Verwende das neue Brand-Kit-Format mit Playbooks. Legacy-Brand-Kits funktionieren mit Playbooks nicht so gut und können die Ausgabequalität verringern.
{% endhint %}

## Aufbau eines Playbooks

Wenn du den Playbook-Editor öffnest, siehst du:

* Eine Header-Chip-Zeile über dem ersten Abschnitt, die Werkzeuge, Eingaben, Artefakte und **Trigger hinzufügen**.
* Aktionen oben rechts für **Playbook ausführen**, **Veröffentlichen**, und **Ausführungsverlauf**.
* **Quill, der AirOps-Agenten-Kapitän,** als grüne schwebende Schaltfläche unten rechts im Editor.
* Verweise beim Schreiben direkt inline als Chips. Eingaben und Brand Kits erscheinen als grüne Chips. Werkzeuge erscheinen als graue Chips mit Symbolen.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1d6bffb9013f3eaa2d2b627f82288c30362413b4%2Fplaybooks-02-editor-anatomy.png?alt=media" alt="Playbook editor with the header chip row, Run Playbook, Publish, and Run History actions, Input and Tool pills, and the Quill button"><figcaption><p>Der Playbook-Editor: Header-Chips, Aktionen oben rechts, Inline-Verweise und Quill.</p></figcaption></figure>

Geben Sie `/` in einem beliebigen Abschnitt, um das Slash-Menü zu öffnen. Das Slash-Menü zeigt Werkzeuge, Eingaben, Artefakte und andere Verweise an, die du in deine Anweisungen einfügen kannst.

## Playbook-Leitfäden

* [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)
* [Mit Artefakten arbeiten](https://docs.airops.com/docs/de/aktionen/playbooks/artifacts.md)
* [Tools](https://docs.airops.com/docs/de/aktionen/playbooks/tools.md)
* [Ein Playbook ausführen](https://docs.airops.com/docs/de/aktionen/playbooks/run-a-playbook.md)
* [Playbook-Trigger](https://docs.airops.com/docs/de/aktionen/playbooks/triggers.md)
* [Playbooks mit anderen Tools verbinden](https://docs.airops.com/docs/de/aktionen/playbooks/integrations.md)
* [Playbook-Best-Practices anwenden](https://docs.airops.com/docs/de/aktionen/playbooks/best-practices.md)
* [Fehlerbehebung für Playbooks](https://docs.airops.com/docs/de/aktionen/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/de/aktionen/playbooks.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.
