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

# Ein Playbook ausführen

Führe Playbooks manuell, aus Grids oder mit Triggern aus

Sie können ein Playbook manuell im Editor, aus einem Grid oder automatisch mit einem Trigger ausführen. Jeder Lauf erstellt eine Session mit Ausführungsdetails und Artefakten.

## Manuell ausführen

Verwenden Sie einen manuellen Lauf, wenn Sie ein Playbook testen oder es für einen einzelnen Anwendungsfall ausführen.

1. Öffnen Sie den Playbook-Editor.
2. Klicken Sie auf **Playbook ausführen**.
3. Geben Sie alle erforderlichen Eingaben an.
4. Überprüfen Sie die Ausgabe der Session und die Artefakte.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-668e8ceeb89da177a56995e3337f0812686cc19f%2Frun-playbook-01-run-inputs.png?alt=media" alt="Enter Inputs panel for a Playbook run with page URL, target prompt, refresh brief, and Brand Kit Inputs, Advanced Settings, and the Fast and Max mode toggle in the header"><figcaption><p>Geben Sie die erforderlichen Eingaben an, wenn Sie ein Playbook ausführen.</p></figcaption></figure>

{% hint style="info" %}
Läufe, die im Playbook-Editor gestartet werden, verwenden Testaufgaben vor Produktionsaufgaben. Jeder Workspace hat 50.000 kostenlose Testaufgaben pro Monat, die für Workflow- und Playbook-Tests verwendet werden können. Wenn Ihr Workspace alle Testaufgaben verbraucht, verwendet AirOps für zusätzliche Editor-Läufe Produktionsaufgaben. Sie können die Nutzung von Testaufgaben im **Verwendung** Tab.
{% endhint %}

## Aus einem Grid ausführen

Verwenden Sie ein Grid, wenn Sie ein veröffentlichtes Playbook über Zeilen strukturierter Daten hinweg ausführen möchten.

1. Öffnen Sie das Grid.
2. Klicken Sie auf **+ Spalte hinzufügen**.
3. Wählen Sie das **Playbooks** Tab.
4. Suchen Sie nach dem Playbook.
5. Ordnen Sie Grid-Spalten, statische Werte oder Brand Kits den Playbook-Eingaben zu.
6. Führen Sie das Playbook für eine Zeile oder in großem Umfang aus.

{% hint style="info" %}
Wenn ein Playbook aus einem Grid ausgeführt wird, verwendet es die Version und die Eingabezuordnungen, die in dieser Grid-Spalte konfiguriert sind. Änderungen, die Sie im Session-Chat vornehmen, gelten für die Artefakte, nicht für das Playbook. Um das Playbook selbst zu ändern, öffnen Sie es im Editor.
{% endhint %}

Siehe [Playbooks im Grid ausführen](https://docs.airops.com/docs/de/aktionen/grids/run-playbooks-in-grid.md) für die Versionsauswahl, Massenläufe, den Session-Status und die Artefaktprüfung.

### Zurück zum Quell-Grid

Wählen Sie nach dem Öffnen eines Playbooks aus einem Grid **Zu Grid zurückkehren** in den Schnellaktionen des Editors, um zum ursprünglichen Sheet zurückzukehren. Wenn Sie das Playbook direkt geöffnet haben, kehrt AirOps zu seinem verknüpften Grid zurück oder bietet einen Auswahldialog an, wenn mehrere Grids verknüpft sind. Die Option wird ausgeblendet, wenn keine aktiven verknüpften Grids vorhanden sind.

## Automatisch ausführen

Verwenden Sie einen Trigger, wenn das Playbook nach einem Zeitplan, durch ein externes Ereignis oder durch ein AirOps-Signal gestartet werden soll.

Trigger-Typen umfassen:

* **Zeitplan:** Regelmäßig ausführen.
* **Webhook:** Auf Basis einer HTTP-Anfrage ausführen.
* **Monitor:** Ausführen, wenn Parallel Web Systems eine Bedingung aus Ihrer Monitoring-Abfrage erkennt.
* **AEO Insight:** Ausführen, wenn ein aktivierter Insights-Schwellenwert erreicht wird.

Ausgelöste Läufe erscheinen in der Laufhistorie. Läufe, die eine menschliche Überprüfung erfordern, erscheinen ebenfalls im Posteingang.

{% hint style="info" %}
Für die Trigger-Einrichtung, Versionseinstellungen und Beispiele für Webhook-Payloads siehe [Playbook-Trigger](https://docs.airops.com/docs/de/aktionen/playbooks/triggers.md).
{% endhint %}

## Versionen und Eingabeänderungen

Grid-Spalten und Trigger können **Standard** oder eine angeheftete Playbook-Version.

* **Standard** folgt der aktuell veröffentlichten Version.
* **Angeheftet** verwendet weiterhin die ausgewählte Version, bis Sie sie ändern.

{% hint style="warning" %}
Wenn eine neue Playbook-Version Eingaben ändert, aktualisieren Sie vor dem Ausführen in großem Maßstab alle Zuordnungen von Grid-Spalten und die Trigger-Eingabekonfiguration. Neue erforderliche Eingaben ohne zugeordnete oder konfigurierte Werte können dazu führen, dass Läufe bei der Validierung fehlschlagen oder übersprungen werden.
{% endhint %}

## Sessions überprüfen

Jeder Lauf erzeugt eine Session. Eine Session enthält:

* Das vollständige Ausführungsprotokoll.
* Für den Lauf verwendete Eingaben.
* Das verwendete Modell und seine Begründungsdetails, sofern verfügbar.
* Die **Schnell** oder **Max** Ausführungsmodus, angezeigt in Session **Details**. Siehe [Wählen Sie einen Ausführungsmodus](https://docs.airops.com/docs/de/aktionen/playbooks/build-a-playbook.md#choose-an-execution-mode).
* Jedes Artefakt, das das Playbook erzeugt hat.
* Status der menschlichen Überprüfung, wenn das Playbook Prüfschritte enthält.

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-024ac77ad6972adc41ca7777511390c7e7f7f923%2Frun-playbook-02-session-details.png?alt=media" alt="Playbook Session Details with status, version, Max mode, time, runtime, tasks, UUID, source, and model"><figcaption><p>Session-Details zeichnen auf, wie ein Playbook-Lauf konfiguriert wurde.</p></figcaption></figure>

Sessions sind sichtbar in **Ausführungsverlauf** oben rechts im Playbook-Editor und im Posteingang, wenn eine Überprüfung erforderlich ist.

Die Session-Aktivität zeigt ebenfalls den Prüfungsfortschritt an. Die Aktivität der Prüfer wird unter dem Prüfversuch gruppiert, der sie erzeugt hat, während von dem Hauptagenten vorgenommene Korrekturen in der primären Zeitleiste verbleiben. Sie können diese Aktivität während eines Laufs oder nach dem Aktualisieren der Session überprüfen.

## Gemeinsam an Artefakten arbeiten

Artefakte unterstützen Kommentare, Vorschläge, Erwähnungen, Versionsverlauf und KI-unterstützte Bearbeitungen. Verwenden Sie diese Steuerelemente, wenn eine Session-Ausgabe vor der Veröffentlichung oder der weiteren Verwendung überprüft werden muss. Bearbeitungen betreffen das Artefakt für diese Session, nicht die Playbook-Anweisungen.

Siehe [Artefakte](https://docs.airops.com/docs/de/aktionen/playbooks/artifacts.md) für die vollständige Zusammenarbeit, Wiederherstellung, stabile Verknüpfung und den Grid-Workflow.

## Eine Grid-Session unterbrechen oder erneut ausführen

Wenn eine Session als **Archiviert**markiert ist, können Sie ihren Verlauf und ihre Artefakte überprüfen, aber keine neuen Nachrichten an sie senden. Starten Sie eine neue Session, um die Arbeit fortzusetzen.

In einem Grid zeigen Playbook-Zellen den aktuellen Session-Status an. Sie können die Session aus der Zelle öffnen, eine wartende oder laufende Session unterbrechen und terminale Sessions erneut ausführen. Wenn eine Session auf einer älteren Playbook-Version lief, zeigt die Zelle eine Warnung an, damit Sie sie auf der aktuellen Version erneut ausführen können.

## Verwenden Sie zwei Playbooks für Überwachung und Aktion

Viele Playbook-Setups verwenden ein Zwei-Playbook-Muster.

Das erste Playbook überwacht Daten und findet Arbeit für Sie. Es kann auf einen Trigger reagieren, AirOps Insights durchsuchen, Chancen identifizieren und sie mit dem AirOps MCP in ein Grid übertragen, etwa URLs zum Aktualisieren oder Prompts, auf die Sie abzielen möchten.

Das zweite Playbook führt die Aktionen für diese Zeilen aus und erzeugt die Ausgabe. Sie können es manuell oder als Grid-Aktion auf der vom ersten Playbook erzeugten Zeile ausführen, etwa um einen Blogbeitrag für einen Ziel-Prompt zu entwerfen oder eine vorhandene Seite zu aktualisieren.

Ein Playbook findet die Arbeit. Das andere Playbook erledigt die Arbeit und bringt Sie zu einer Ausgabe. Sie können beide Muster auch einzeln verwenden, aber häufig werden sie kombiniert.

Um doppelte Arbeit über mehrere Läufe hinweg zu vermeiden, zeichnen Sie abgeschlossene Elemente in einem Grid auf und lassen Sie das überwachende Playbook diesen Eintrag prüfen, bevor es neue Arbeit empfiehlt.


---

# 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/run-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.
