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

# Fehlerbehebung

Behebe häufige Probleme bei der Einrichtung und Ausführung von Playbooks

Verwenden Sie diesen Leitfaden, wenn ein Playbook schlechte Ergebnisse erzeugt, hängen bleibt, Prüfungen falsch weiterleitet oder die falsche Version verwendet.

| Symptom                                                                                | Wahrscheinliche Ursache                                                                               | Lösung                                                                                                                                                              |
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Die Ausgabequalität ist niedrig                                                        | Das Brand Kit ist veraltet oder verwendet das Legacy-Format.                                          | Migrieren Sie zum neuen Brand-Kit-Format und prüfen Sie Tone of Voice, Schreibregeln, Zielgruppen und Regionen.                                                     |
| Fehler „Brand Kit erforderlich“ nach dem Anhängen eines Brand Kits                     | Der Eingabetyp ist Text statt Brand Kit.                                                              | Öffnen Sie die Eingabeeinstellungen und wechseln Sie den Typ zu **Brand Kit**.                                                                                      |
| Dem Playbook entgehen offensichtliche Chancen                                          | Die Prompt-Abdeckung ist unvollständig oder veraltet.                                                 | Überprüfen Sie die erfassten Prompts und erweitern Sie die Abdeckung anhand von GSC-Abfragen, Vertriebsgesprächen, Support-Tickets und Wettbewerberlücken.          |
| Die Knowledge-Base-Suche liefert irrelevante Ergebnisse                                | Die falsche Knowledge Base ist ausgewählt, oder die automatische Auswahl sucht zu breit.              | Wählen Sie die Knowledge Base im Knowledge-Base-Auswahldialog des Schritts nach Namen aus.                                                                          |
| Eine nachgelagerte Section kann kein Artifact finden                                   | Die Section verweist auf das Artifact über den Dateinamen.                                            | Verweisen Sie auf das Artifact nach Namen. Verwenden Sie das Slash-Menü, um die Referenz einzufügen.                                                                |
| Ein ausgelöster Lauf verwendet alten Playbook-Inhalt                                   | Der Trigger ist auf eine ältere veröffentlichte Version festgelegt.                                   | Öffnen Sie den Trigger und wählen Sie **Standard** oder die veröffentlichte Version, die Sie ausführen möchten.                                                     |
| Der ausgelöste Lauf schlägt nach Änderungen an Inputs fehl                             | Die aktive Playbook-Version hat erforderliche Inputs, die im Trigger nicht konfiguriert sind.         | Öffnen Sie die Trigger-Einstellungen und aktualisieren Sie die Input-Konfiguration.                                                                                 |
| Der Grid-Lauf schlägt nach Änderungen an Inputs fehl                                   | Die Grid-Spalte verwendet eine Playbook-Version mit erforderlichen Inputs, die nicht zugeordnet sind. | Öffnen Sie die Einstellungen der Grid-Spalte und aktualisieren Sie die Input-Zuordnungen.                                                                           |
| Eine Session kann nicht starten, weil ein erforderliches Artifact nicht verfügbar ist  | Ein vorgelagertes Playbook hat das zugeordnete Artifact nicht erzeugt.                                | Schließen Sie den vorgelagerten Lauf ab und bestätigen Sie, dass das erforderliche Artifact vorhanden ist, und versuchen Sie dann die nachgelagerte Session erneut. |
| Änderungen im Session-Chat aktualisieren das Playbook nicht                            | Die Session führt eine veröffentlichte Version aus. Chat-Änderungen gelten nur für Artifacts.         | Öffnen Sie das Playbook im Editor und bearbeiten Sie das Playbook mit [Quill](https://docs.airops.com/docs/de/quill.md)oder nehmen Sie direkte Änderungen vor.      |
| Dem replizierten Playbook fehlen Tools                                                 | Der Workflow-Konverter hat nicht jede Tool-Referenz in das Playbook übernommen.                       | Fügen Sie fehlende Tools vor dem Veröffentlichen über das Slash-Menü hinzu.                                                                                         |
| Das Playbook bleibt in Section 1 hängen und fragt, welche Zeile ausgeführt werden soll | Der Lauf verwendet die interne `__id` Spalte als Zeilenkennzeichner aus einem Grid.                   | Geben Sie dem Playbook stattdessen eine echte Identifikatorspalte wie URL oder Slug weiter anstelle von `__id`.                                                     |
| Ein Playbook ist in einem Grid nicht verfügbar                                         | Das Playbook ist noch ein Entwurf.                                                                    | Veröffentlichen Sie das Playbook und fügen Sie es dann über den Playbooks-Tab des Grids hinzu.                                                                      |
| AEO Insight ist nicht als Trigger verfügbar                                            | AEO-Insight-Trigger sind für den Workspace nicht aktiviert.                                           | Verwenden Sie Schedule, Webhook oder Monitor, oder wenden Sie sich wegen AEO-Insight-Triggern an Ihr Account-Team.                                                  |
| Der Webflow-Export hat benutzerdefinierte Inhalte überschrieben                        | Der native Export überträgt das vollständige Rich-Text-Feld.                                          | Planen Sie die Feldstruktur so, dass die Playbook-Ausgabe das Feld kontrolliert, in das exportiert wird.                                                            |
| Slack-Nachrichten taggen keine einzelnen Personen                                      | Einzelne @Mentions werden in Playbook-Slack-Schritten noch nicht unterstützt.                         | Nennen Sie die Person im Nachrichtentext und lassen Sie die Prüfer den relevanten Kanal beobachten.                                                                 |

## Nach einem Laufzeitlimit fortsetzen

Wenn eine Session das zweistündige Laufzeitlimit überschreitet, bricht AirOps sie ab und zeigt eine Fehlermeldung an, die erklärt, dass Sie fortsetzen können. Öffnen Sie die Session und setzen Sie sie fort, um die Arbeit weiterzuführen. Dasselbe Limit gilt auch für eine fortgesetzte Session.

## Häufig gestellte Fragen

### Kann ich bestehende Workflows weiterlaufen lassen, während ich Playbooks erstelle?

Ja. Playbooks und Workflows können während der Migration parallel laufen.

### Unterstützen Playbooks BYOK?

Playbooks unterstützen derzeit kein BYOK. Kontaktieren Sie <support@airops.com> wenn Sie Fragen zum Modellzugriff in Playbooks haben.

### Kann ich Reviews je nach Inhaltstyp oder Komplexität an unterschiedliche Personen weiterleiten?

Noch nicht nativ. Der aktuelle Workaround besteht darin, separate Sections mit Überspring-Logik zu erstellen, zum Beispiel „Wenn die Komplexität nicht 3 ist, überspringe diese Section.“ Jede Section kann ihre eigene Reviewer-Zuweisung haben.

### Können Playbooks Inhalte direkt an mein CMS übertragen?

Ja, aber trennen Sie das Veröffentlichen möglichst von der Inhaltserstellung. Erstellen und prüfen Sie den Inhalt zuerst und veröffentlichen Sie ihn 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, rufen Sie das AirOps-MCP `track_aeo_page_content_update` Tool mit der Seiten-URL und dem Aktualisierungstyp auf, damit AirOps Insights die Inhaltsaktualisierung nachverfolgen kann.

### Welche SEO-Tools sind in Playbooks verfügbar?

Playbooks können AirOps SEO Research, DataForSEO, Moz, Google Search Console, Page 360 Report und Page Versus Report verwenden. Sie können auch Web-Recherche-Tools wie Google Search, Parallel Web Systems, Firecrawl, Reddit und Web Page Scrape verwenden.

### Wie löse ich ein Playbook programmgesteuert aus?

Verwenden Sie einen **Webhook** Trigger. Webhooks sind der empfohlene Weg, ein veröffentlichtes Playbook von einem externen System aus zu starten. Senden Sie eine `POST` Anfrage an die Webhook-URL mit einem `Eingaben` Objekt, das Playbook-Input-Variablennamen als Schlüssel verwendet. Siehe [Playbook-Trigger](https://docs.airops.com/docs/de/aktionen/playbooks/triggers.md#webhook-payload-format) für das Payload-Format. Der Trigger führt seine ausgewählte Version aus: **Standard** folgt der aktuellen veröffentlichten Version, und ein angehefteter Trigger verwendet die ausgewählte Version weiterhin, bis Sie sie ändern. Wenn sich die Playbook-Inputs ändern, aktualisieren Sie die Input-Konfiguration des Triggers, bevor Sie Produktionsanfragen senden.

### Kann Quill ein Playbook aus einer laufenden Session heraus bearbeiten?

Nein. Änderungen im Session-Chat gelten nur für die Artifacts. Um das Playbook zu ändern, öffnen Sie es im Editor und verwenden Sie [Quill](https://docs.airops.com/docs/de/quill.md) dort.


---

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