> 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/build-a-playbook.md). # Ein Playbook erstellen Definiere Eingaben, Abschnitte, Tools, Artefakte, Prüfungen und Trigger in einem Playbook Playbooks bestehen aus Inputs, Abschnitten, Tools, Artefakten, Blöcken für menschliche Überprüfung und Triggern. Definieren Sie jeden Teil klar, damit der Agent den richtigen Kontext hat und Prüfer die richtigen Kontrollpunkte haben. ## Wählen Sie ein Modell Verwende die **Modell** Selektor im Playbook-Editor, um **Auto** oder ein verfügbares Modell. Die angezeigten Optionen hängen von Ihrem Arbeitsbereich und den verfügbaren Anbietern ab. **GPT-6 Sol**, **GPT-6 Luna**und **Claude Opus 5.5** sind im Selektor verfügbar. Wählen Sie Sol oder Opus 5.5 für komplexe Aufgaben oder Luna, wenn Geschwindigkeit und Kosten wichtiger sind. ### Modellbewertungen vergleichen Klappen Sie ein Modell auf, um seinen unterstützten **Reasoning-Aufwand** anzupassen und die für diese Auswahl verfügbaren Bewertungen zu vergleichen: | Bewertung | Was mehr Balken bedeuten | | ------------------- | ------------------------------------------------------------------------------------------------- | | **Geschwindigkeit** | Schnellere durchschnittliche Fertigstellung in Benchmark-Durchläufen | | **Intelligenz** | Höhere allgemeine Leistungsfähigkeit basierend auf dem öffentlichen Artificial-Analysis-Benchmark | | **Kosteneffizienz** | Weniger Tasks pro Benchmark-Durchlauf verbraucht | Bewertungen ändern sich mit dem ausgewählten Reasoning-Aufwand, wenn Benchmark-Daten verfügbar sind. Einige Modelle und Aufwands-Einstellungen haben keine Bewertungen. Betrachten Sie die Balken als vergleichende Orientierung: Ihr Playbook, Ihre Inputs und Tools beeinflussen die tatsächliche Laufzeit, den Task-Verbrauch und die Ausgabequalität. Auto hat keinen festen Modell- und Aufwands-Benchmark. ## 1. Inputs definieren Inputs sind der Weg, über den ein Playbook zur Laufzeit Informationen empfängt. | Gib | Verwenden für | | --------- | ---------------------------------------------------------------------------------- | | Text | Keywords, URLs, Prompts, freie Zeichenketten. | | Zahl | Zählungen, Schwellenwerte, Rankings. | | Datei | Dokumente, Briefings und Exporte, die das Playbook während eines Laufs lesen soll. | | Brand Kit | Ton, Schreibregeln, Zielgruppen, Regionen und visuelle Richtlinien. | Klicken Sie auf **Erweiterte Einstellungen anzeigen** bei einer Eingabe, um Variablennamen, Beschreibung, Platzhalter und Standardwert festzulegen. ## 2. Abschnitte definieren Abschnitte sind das strukturelle Rückgrat eines Playbooks. Jeder Abschnitt enthält Anweisungen und kann optional mit einem Block für menschliche Überprüfung enden. Organisieren Sie Abschnitte nach logischer Phase, nicht nach Prüfer. Eine Content-Pipeline könnte Folgendes verwenden: 1. **Aufnahme und Validierung:** Analysieren Sie die Eingabe, validieren Sie sie und sammeln Sie Kontext. 2. **Recherche und Strategie:** Durchsuchen Sie Wissensdatenbanken, analysieren Sie SERPs und prüfen Sie Wettbewerber. 3. **Briefing-Zusammenstellung:** Fassen Sie die Recherche in einem umsetzbaren Briefing zusammen. 4. **Artikeldraft und Verlinkung:** Erstellen Sie den Inhalt und fügen Sie interne Links hinzu. 5. **Abschließende Überprüfung:** Vor der Veröffentlichung für eine menschliche Überprüfung anhalten. Vorlagen verwenden innerhalb jedes Abschnitts eine einheitliche Struktur. Verwenden Sie dieses Muster als Ausgangspunkt und passen Sie es dann an die Aufgabe an: * **Ziel:** Definieren Sie, was der Abschnitt erreichen soll. * **Eingaben und Referenzen:** Benennen Sie die Eingaben, Artefakte, Brand-Kit-Felder, Tools und Wissensdatenbanken, die der Abschnitt verwenden soll. Fügen Sie sie nach Möglichkeit über das Schrägstrich-Menü ein. * **Anweisungen:** Listen Sie die Arbeit in klaren nummerierten Schritten auf. * **Ausgabe:** Benennen Sie das Artefakt, das der Abschnitt schreiben soll, und das Format, das er verwenden soll. ## 3. Tools hinzufügen Gib `/` in einem beliebigen Abschnitt, um das Schrägstrich-Menü zu öffnen. Verwenden Sie es, um Tools, Inputs, Artefakte und andere Referenzen in die Playbook-Anweisungen einzufügen. Inputs, Artefakte und Tools lassen sich leichter wiederverwenden, wenn Sie sie über das Schrägstrich-Menü einfügen, statt ihre Namen manuell einzugeben. Den vollständigen Tool-Katalog, MCP-Connectors und Best Practices finden Sie unter [Tools](/docs/de/aktionen/playbooks/tools.md). ### AirOps * **AirOps MCP:** Greifen Sie auf Ihre AirOps-Daten zu, einschließlich Insights-Daten, Brand Kits, Wissensdatenbanken und Grids. * **AirOps SEO Research:** Keyword-Recherche, Domain-Analyse und Backlink-Daten. * **Page 360 Report:** Diagnostizieren Sie eine einzelne eigene URL hinsichtlich Suchleistung, KI-Sichtbarkeit, Aktualität, Autoritätssignalen und Seiteninhalt. * **Page Versus Report:** Vergleichen Sie eine eigene URL mit den Seiten, die in Suche und KI-Antworten gewinnen, und zeigen Sie dann Lücken auf, die geschlossen werden müssen. * **Web Page Scrape:** Inhalte von Webseiten scrapen. ### SEO Research * **DataForSEO:** SEO-Daten und Keyword-Recherche. * **Moz:** SEO- und Domain-Analyse. * **Google Search Console:** GSC-Daten. ### Web Research * **Google Search:** Google-Ergebnisse suchen und abrufen. * **Parallel Web Systems:** Verwenden Sie die Parallel Search API, Parallel Extract API und Parallel Task API, um Webrecherche durchzuführen, strukturierte Daten aus URLs abzurufen und Recherche-Inputs in strukturierte Ausgaben zu verarbeiten. * **Firecrawl:** Webseiten crawlen und scrapen. * **Reddit:** Für weitere Details, [Sprechen Sie mit dem Vertrieb](https://www.airops.com/book-a-call). ### Bild und Video * **Bildgenerierung:** Generieren oder bearbeiten Sie gehostete Bilder mit GPT Image 2.5 Sunburst, GPT Image 2.5 Flare, GPT Image 2 oder Nano Banana 2. Siehe [Bild- und Video-Tools](/docs/de/aktionen/playbooks/tools/image-and-video.md) für Hinweise zu den Modellen. * **Stockbilder:** Suchen Sie bei Getty Images oder Unsplash und rufen Sie dann ein ausgewähltes Bild per ID für die Verwendung in einem Artefakt oder einem Veröffentlichungsschritt ab. ### Wissensmanagement * **Slack:** Den Kanalverlauf lesen und Nachrichten senden. * **Google Docs:** Google-Docs-Dokumente lesen und bearbeiten. ### B2B-Anreicherung * **Brandfetch:** Marken-Assets und Informationen abrufen. * **Hunter.io:** E-Mail-Adressen finden und verifizieren. Für weitere Details, [Sprechen Sie mit dem Vertrieb](https://www.airops.com/book-a-call). ### Anzeigen * **OpenAI Ads:** Kontoleistung abrufen. Kampagnen, Anzeigengruppen und Anzeigen erstellen und verwalten, wenn Schreib-Tools aktiviert sind. Siehe [Ads-Tools](/docs/de/aktionen/playbooks/tools/ads.md) für Verfügbarkeit und Prüfschritte. Sie können jeden benötigten MCP-Connector in den MCP-Connector-Einstellungen Ihres Arbeitsbereichs hinzufügen. Verbundene MCP-Tools erscheinen in der Tools-Liste des Playbook-Editors. {% hint style="info" %} Wenn Sie einen Suchschritt für eine Wissensdatenbank hinzufügen, verweisen Sie im Wissensdatenbank-Auswahlfeld des Schritts auf die Wissensdatenbank nach Namen. Verlassen Sie sich nicht auf die automatische Auswahl, wenn das Playbook eine bestimmte Quelle benötigt. {% endhint %} ## 4. Menschliche Überprüfung hinzufügen Platzieren Sie Human Review als Block am Ende eines vorhandenen Abschnitts. Erstellen Sie keinen separaten Abschnitt nur für die Überprüfung. Verwenden Sie Human Review, wenn jemand Text genehmigen, unter Optionen auswählen oder generierte Ausgabe vor dem nächsten Abschnitt bearbeiten muss. Prüferoptionen sind: * **Benannte Person:** Ein bestimmtes Teammitglied. * **Aktueller Benutzer:** Die Person, die das Playbook ausgelöst hat. * **Jedes Mitglied kann prüfen:** Jedes Mitglied des Arbeitsbereichs kann prüfen. Überprüfungen erscheinen im Posteingang. {% hint style="info" %} Eine native bedingte Weiterleitung an mehrere Prüfer ist noch nicht verfügbar. Der aktuelle Workaround ist ein Abschnitt pro Prüfer, mit Skip-Logik in den Anweisungen des Abschnitts. Zum Beispiel: "Wenn die Komplexität nicht 3 ist, überspringen Sie diesen Abschnitt." {% endhint %} ## 5. Artefakte deklarieren Artefakte sind die dauerhaften Ausgaben, die ein Playbook erzeugt. Deklarieren Sie eines, wenn ein Ergebnis gespeichert, geprüft, geteilt, downstream wiederverwendet oder nach Ende der Session veröffentlicht werden muss. Unterstützte Artefakttypen sind: * Markdown * HTML * JSON * CSV * PNG * JPG * GIF Geben Sie jedem Artefakt einen klaren Namen und verweisen Sie dann aus dem Abschnitt darauf, der darin schreiben soll. Wenn ein Abschnitt kein Artefakt erzeugt, verbleibt sein Inhalt im Sitzungskontext. Für stabile Links, Kommentare, Vorschläge, Erwähnungen, Bearbeiten mit KI, Versionsverlauf und Grid-Wiederverwendung siehe [Artefakte](/docs/de/aktionen/playbooks/artifacts.md). ## 6. Einen Trigger konfigurieren Trigger bestimmen, wie ein Playbook startet. | Trigger | So funktioniert es | Am besten für | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | Zeitplan | Läuft in einem wiederkehrenden Rhythmus, zum Beispiel jeden Montag um 9 Uhr. | Wöchentliche Content-Audits, Aktualitätsprüfungen von Brand Kits, wiederkehrende Berichte. | | Webhook | Startet, wenn ein externes System eine HTTP-Anfrage an die Webhook-URL des Playbooks sendet. | CMS-Veröffentlichungsereignisse, Formulareinsendungen, Integrationen von Drittanbietern. | | Monitor | Verwendet Parallel Web Systems, um alle 12 Stunden eine Überwachungsanfrage zu prüfen und das Playbook zu starten, wenn die Bedingung erkannt wird. | Wettbewerbswarnungen, Marktüberwachung, Überwachung der Inhaltsgesundheit. | | AEO Insight | Startet, wenn aktivierte AEO-Insight-Schwellenwerte erreicht werden, z. B. wenn sich Erwähnungsrate, Share of Voice oder Zitierquote ändern. | Programmgesteuerte Aktualisierung, Reaktion auf Wettbewerber, AEO-Abdeckungslücken. | {% hint style="info" %} Trigger können verwenden **Standard** oder eine angeheftete Playbook-Version. **Standard** folgt der aktuell veröffentlichten Version. Ein angehefteter Trigger verwendet weiter die ausgewählte Version, bis Sie sie ändern. Wenn eine neue Version Inputs ändert, aktualisieren Sie die Trigger-Eingabekonfiguration, bevor Sie sich auf zukünftige Läufe verlassen. Siehe [Playbook-Trigger](/docs/de/aktionen/playbooks/triggers.md) für Einrichtungsschritte und Webhook-Payload-Beispiele. {% endhint %} ## 7. Verwenden Sie Quill zum Iterieren Quill ist der AirOps-Agent-Captain für die Playbook-Erstellung. Klicken Sie auf die grüne schwebende Schaltfläche unten rechts im Editor. [Quill](/docs/de/quill.md) kann: * Ihr Playbook mithilfe von Prompts in natürlicher Sprache bearbeiten. * Einen Workflow-Prompt als kurze Agentenanweisung mit Kontext umschreiben. * Datei- und Bildanhänge verwenden, um das Playbook oder das Brand Kit zu aktualisieren. * Über die Playbook-Struktur nachdenken und Umstrukturierungen vorschlagen. Geben Sie Quill von Anfang an den vollständigen Kontext. Im Chat, **Enter** sendet ab, also halten Sie jede Anweisung in einem Absatz. Duplizieren Sie ein Playbook vor einer größeren strukturellen Überarbeitung, damit Sie einen sauberen Rollback-Punkt haben. ## Playbook-Gesundheit prüfen Prüfen **Gesundheit** in der Playbooks-Liste oder öffnen Sie die Gesundheitssteuerung im Editor, um Prüfungen zu sehen, die vor dem Veröffentlichen oder Ausführen des Playbooks Aufmerksamkeit erfordern. ## 8. Veröffentlichen Das Veröffentlichen erstellt einen versionierten Snapshot, von dem nachgelagerte Verbraucher aus Grids und Triggern ausführen können. Verwenden Sie einen Webhook-Trigger, wenn ein externes System ein Playbook programmgesteuert starten soll. Entwürfe bleiben bearbeitbar. Veröffentlichte Versionen sind ausführbare Referenzen. Wenn Sie Inputs geändert haben, aktualisieren Sie vor einem Einsatz in großem Maßstab alle Grid-Zuordnungen und Trigger-Eingabekonfigurationen, die dieses Playbook verwenden. ### Eine frühere Version wiederherstellen Öffnen Sie den Versionsverlauf im Playbook-Editor, wählen Sie die gewünschte Version aus und klicken Sie auf **Wiederherstellen**. AirOps kopiert diese Version in den aktuellen Entwurf, damit Sie sie vor dem Veröffentlichen überprüfen können. Durch das Wiederherstellen einer Version wird der aktuelle Entwurf ersetzt. Laden Sie alle Entwurfsänderungen herunter oder veröffentlichen Sie sie, die Sie behalten möchten, bevor Sie eine ältere Version wiederherstellen. Wiederherstellen ist in den Tarifen Free, Starter, Pro, Pro Plus und Platform verfügbar. ## Ein Playbook importieren oder exportieren Der Editor kann ein Playbook als Markdown oder JSON herunterladen. Er kann außerdem Markdown oder JSON in ein vorhandenes Playbook importieren. {% hint style="warning" %} Beim Importieren von Markdown oder JSON wird der aktuelle Playbook-Inhalt überschrieben. Laden Sie zuerst das vorhandene Playbook herunter, wenn Sie einen Rollback-Punkt benötigen. {% endhint %} --- # 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/build-a-playbook.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.