> 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/grids/run-playbooks-in-grid.md).

# Playbooks im Grid ausführen

Führen Sie ein veröffentlichtes Playbook über Grid-Zeilen hinweg aus und überprüfen Sie jede Sitzung und jedes Artefakt.

Verwenden Sie eine Playbook-Spalte, um dasselbe veröffentlichte Playbook über Zeilen strukturierter Daten hinweg auszuführen. Jeder Lauf erstellt eine Session, und deklarierte Artifacts bleiben zur Überprüfung und Bearbeitung mit dieser Session verbunden.

## So konfigurieren Sie eine Playbook-Spalte

1. Öffnen Sie das Grid.
2. Klicken Sie auf **+ Spalte hinzufügen**.
3. Wählen Sie das **Playbooks** Tab.
4. Suchen Sie nach einem veröffentlichten Playbook und wählen Sie es aus.
5. Ordnen Sie jeden Playbook Input einer Grid-Spalte, einem statischen Wert oder einem Brand Kit zu.
6. Speichern Sie die Spalte.

Wenn der Workspace keine veröffentlichten Playbooks hat, hat die **Playbooks** Registerkarte kein Playbook zum Hinzufügen.

## Konfigurationsoptionen

| Option          | Beschreibung                                                                                                                                         |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Playbook        | Das veröffentlichte Playbook, das für jede ausgewählte Zeile ausgeführt wird.                                                                        |
| Version         | **Standard** folgt der aktuellen veröffentlichten Version. Eine angeheftete Version verwendet weiterhin die ausgewählte Version, bis Sie sie ändern. |
| Input-Zuordnung | Verbinden Sie jeden Playbook Input mit einer Grid-Spalte, einem statischen Wert oder einem Brand Kit.                                                |

{% hint style="warning" %}
Wenn eine neue Playbook-Version ihre Inputs ändert, aktualisieren Sie die Zuordnungen der Grid-Spalten, bevor Sie sie in großem Umfang ausführen. Fehlende erforderliche Inputs können dazu führen, dass Läufe die Validierung nicht bestehen oder übersprungen werden.
{% endhint %}

## Führen Sie das Playbook aus

Führen Sie das Playbook für eine Zeile aus, während Sie die Input-Zuordnungen und die Ausgabe testen. Sobald das Ergebnis korrekt ist, führen Sie die Playbook-Spalte gesammelt über die Zeilen aus, die Sie verarbeiten möchten.

Das Grid verwendet die auf der Playbook-Spalte konfigurierte Version und Input-Zuordnungen. Bearbeitungen, die in einer Session vorgenommen werden, gelten für die Artifacts dieser Session, nicht für das Playbook selbst. Öffnen Sie den Playbook-Editor, um seine Anweisungen zu ändern.

## Sessions und Artifacts überprüfen

Jede Playbook-Zelle zeigt ihren aktuellen Session-Status an. Öffnen Sie die Zelle, um die Session zu überprüfen, einschließlich:

* Die für den Lauf verwendeten Inputs
* Das Ausführungsprotokoll
* Jedes vom Playbook erzeugte Artifact
* Status der menschlichen Überprüfung, wenn das Playbook Review-Blöcke enthält

<figure><img src="https://1960680173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-0b7b2dc3a6d0a62163dd1b062c43bc1bdb7ec6df%2Fgrid-playbook-01-session-from-cell.png?alt=media" alt="Playbook cell opened from a Grid row, showing the Refreshed Article Artifact with Agent Notes, Inputs, and Details"><figcaption><p>Öffnen Sie eine Playbook-Zelle, um das Artifact, die Inputs und die Details dieser Zeile zu überprüfen.</p></figcaption></figure>

Sie können eine in der Warteschlange befindliche oder laufende Session unterbrechen und eine abgeschlossene Session erneut ausführen. Wenn eine Session eine ältere Playbook-Version verwendet hat, zeigt die Zelle eine Warnung an, damit Sie sie mit der aktuellen Version erneut ausführen können.

Artifact-Spalten speichern Playbook-Artifacts direkt im Grid. Die Grid-Zelle und die Session verweisen auf dasselbe Artifact, sodass Bearbeitungen an beiden Stellen synchron bleiben.

## Beispiel

### Führen Sie ein Content-Refresh-Playbook aus

1. Fügen Sie die Seiten-URL, die Zielaufforderung und alle unterstützenden Kontexte in separate Grid-Spalten ein.
2. Fügen Sie eine Playbook-Spalte hinzu und wählen Sie Ihr veröffentlichtes Content-Refresh-Playbook aus.
3. Ordnen Sie die Playbook-Inputs den passenden Grid-Spalten und dem Brand Kit zu.
4. Führen Sie eine Zeile aus und überprüfen Sie ihre Session und Artifacts.
5. Korrigieren Sie alle Input-Zuordnungen oder aktualisieren Sie die Anweisungen des Playbooks.
6. Führen Sie die Playbook-Spalte über die übrigen Zeilen hinweg aus.


---

# 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/grids/run-playbooks-in-grid.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.
