> 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 Verwende diesen Leitfaden, wenn ein Playbook eine schlechte Ausgabe erzeugt, hängen bleibt, Überprüfungen falsch weiterleitet oder die falsche Version verwendet. | Symptom | Wahrscheinliche Ursache | Lösung | | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | Die Ausgabequalität ist gering | Das Brand Kit ist veraltet oder verwendet das Legacy-Format. | Migriere zum neuen Brand-Kit-Format und überprüfe Tonalität, Schreibregeln, Zielgruppen und Regionen. | | "Brand Kit erforderlich"-Fehler nach dem Hinzufügen eines Brand Kits | Der Eingabetyp ist Text statt Brand Kit. | Öffne die Eingabeeinstellungen und wechsle den Typ zu **Brand Kit**. | | Dem Playbook entgehen offensichtliche Chancen | Die Prompt-Abdeckung ist unvollständig oder veraltet. | Überprüfe die verfolgten Prompts und erweitere die Abdeckung um GSC-Abfragen, Verkaufsgespräche, Support-Tickets und Lücken gegenüber Wettbewerbern. | | Die Wissensdatenbanksuche liefert irrelevante Ergebnisse | Die falsche Wissensdatenbank ist ausgewählt, oder die automatische Auswahl sucht zu breit. | Wähle die Wissensdatenbank im Wissensdatenbank-Auswahlfeld des Schritts nach Namen aus. | | Ein nachgelagerter Abschnitt kann ein Artefakt nicht finden | Der Abschnitt verweist auf das Artefakt über den Dateinamen. | Verweise auf das Artefakt über den Namen. Verwende das Schrägstrich-Menü, um die Referenz einzufügen. | | Eine ausgelöste Ausführung verwendet alte Playbook-Inhalte | Der Trigger ist auf eine ältere veröffentlichte Version angeheftet. | Öffne den Trigger und wähle **Standard** oder die veröffentlichte Version aus, die du ausführen möchtest. | | Die ausgelöste Ausführung schlägt nach dem Ändern von Eingaben fehl | Die aktive Playbook-Version hat erforderliche Eingaben, die nicht im Trigger konfiguriert sind. | Öffne die Trigger-Einstellungen und aktualisiere die Eingabekonfiguration. | | Die Grid-Ausführung schlägt nach dem Ändern von Eingaben fehl | Die Grid-Spalte verwendet eine Playbook-Version mit erforderlichen Eingaben, die nicht zugeordnet sind. | Öffne die Einstellungen der Grid-Spalte und aktualisiere die Eingabenzuordnungen. | | Eine Session kann nicht starten, weil ein erforderliches Artefakt nicht verfügbar ist | Ein vorgelagertes Playbook hat das zugeordnete Artefakt nicht erzeugt. | Schließe die vorgelagerte Ausführung ab und bestätige, dass das erforderliche Artefakt vorhanden ist, und versuche dann die nachgelagerte Session erneut. | | Bearbeitungen im Session-Chat aktualisieren das Playbook nicht | Die Session führt eine veröffentlichte Version aus. Chat-Bearbeitungen gelten nur für Artefakte. | Öffne das Playbook im Editor und bearbeite das Playbook mit [Quill](/docs/de/quill.md)dort. | | Dem replizierten Playbook fehlen Tools | Der Workflow-Konverter hat nicht jede Tool-Referenz in das Playbook übernommen. | Füge fehlende Tools vor der Veröffentlichung mit dem Schrägstrich-Menü hinzu. | | Das Playbook bleibt in Abschnitt 1 hängen und fragt, welche Zeile ausgeführt werden soll | Die Ausführung verwendet die interne `__id` Spalte als Zeilenkennung aus einem Grid. | Übergib dem Playbook statt `__id`. | | Ein Playbook ist in einem Grid nicht verfügbar | Das Playbook ist noch ein Entwurf. | Veröffentliche das Playbook und füge es dann über die Playbooks-Registerkarte des Grids hinzu. | | AEO Insight ist nicht als Trigger verfügbar | AEO-Insight-Trigger sind für den Workspace nicht aktiviert. | Verwende Schedule, Webhook oder Monitor, oder wende dich an dein Account-Team wegen AEO-Insight-Triggern. | | Der Webflow-Export hat benutzerdefinierten Inhalt überschrieben | Der native Export überträgt das gesamte Rich-Text-Feld. | Plane die Feldstruktur so, dass die Playbook-Ausgabe das Feld besitzt, in das sie exportiert. | | Slack-Nachrichten markieren keine einzelnen Personen | Individuelle @Erwähnungen werden in Slack-Schritten des Playbooks noch nicht unterstützt. | Nenne die Person im Nachrichtentext und lass die Prüfer den relevanten Kanal beobachten. | ## Fortsetzen nach einem Laufzeitlimit Wenn eine Session das zweistündige Laufzeitlimit überschreitet, bricht AirOps sie ab und zeigt eine Fehlermeldung an, die erklärt, dass du sie fortsetzen kannst. Öffne die Session und setze sie fort, um die Arbeit fortzusetzen. 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 wenn Sie Fragen zum Modellzugriff in Playbooks haben. ### Kann ich Überprüfungen je nach Inhaltstyp oder Komplexität an unterschiedliche Personen weiterleiten? Noch nicht nativ. Der aktuelle Workaround besteht darin, separate Abschnitte mit Sprunglogik zu erstellen, z. B. „Wenn die Komplexität nicht 3 ist, überspringe diesen Abschnitt.“ Jeder Abschnitt kann seine eigene Zuweisung von Prüfern haben. ### Können Playbooks Inhalte direkt an mein CMS ausspielen? Ja, aber halte das Veröffentlichen wenn möglich getrennt von der Inhaltserstellung. Erstelle und prüfe die Inhalte zuerst und veröffentliche dann über eine Grid-Spalte, ein separates Veröffentlichungs-Playbook oder ein CMS-MCP. Wenn ein Playbook oder ein CMS-MCP eine Seite veröffentlicht oder aktualisiert, rufe das AirOps-MCP `track_aeo_page_content_update` Tool mit der Seiten-URL und dem Aktualisierungstyp auf, damit AirOps Insights die Inhaltsaktualisierung verfolgen 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 außerdem Web-Recherche-Tools wie Google Search, Parallel Web Systems, Firecrawl, Reddit und Web Page Scrape verwenden. ### Wie löse ich ein Playbook programmgesteuert aus? Verwende einen **Webhook** Trigger. Webhooks sind der empfohlene Weg, ein veröffentlichtes Playbook aus einem externen System zu starten. Sende eine `POST` Anfrage an die Webhook-URL mit einem `inputs` Objekt, das die Variablennamen der Playbook-Eingaben als Schlüssel verwendet. Siehe [Playbook-Trigger](/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 aktuell veröffentlichten Version, und ein angehefteter Trigger verwendet weiterhin die ausgewählte Version, bis du sie änderst. Wenn sich die Playbook-Eingaben ändern, aktualisiere die Eingabekonfiguration des Triggers, bevor du Produktionsanfragen sendest. ### Kann Quill ein Playbook aus einer laufenden Session heraus bearbeiten? Nein. Bearbeitungen im Session-Chat gelten für die Artefakte. Um das Playbook zu ändern, öffne es im Editor und verwende [Quill](/docs/de/quill.md) dort. ### Kann sich ein Playbook über Ausführungen hinweg Dinge merken? Ja. Memory speichert Informationen über Sessions hinweg. Ein häufiges Muster ist ein Playbook, das Daten überwacht und vermeidet, denselben Inhalt innerhalb eines gleitenden Fensters, etwa 60 Tage, zur Aktualisierung zu empfehlen. --- # 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=&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.