Instanziieren Sie einen Workflow aus einer Vorlage

In Braidrun ist „Instanziierung aus Vorlage“ die am weitesten verbreitete Methode zur Workflow-Generierung: Mehr als 90 % der Benutzer schreiben ihren ersten Workflow nicht vom Whiteboard aus, sondern klonen einen aus der Vorlage und passen ihn dann entsprechend ihrem eigenen Unternehmen an. In diesem Artikel wird der Vorgang auf jede einzelne Schaltfläche heruntergebrochen.

Vollständige Prozessübersicht

1. Durchsuchen Sie die Vorlagenbibliothek und wählen Sie eine nach Kategorie/Tag/Suche aus
2. Lesen Sie die Karte mit den Vorlagendetails, um die Voraussetzungen und die geschätzten Kosten zu bestätigen
3. Klicken Sie auf „Diese Vorlage verwenden“, um sie in Ihren Arbeitsbereich zu klonen
4. Ändern Sie die Geschäftsparameter entsprechend der Variablenbeschreibung im Editor
5. Füllen Sie den Schlüssel im Credential Center aus
6. Führen Sie zunächst einen Trockenlauf durch, um die Struktur zu überprüfen, und führen Sie ihn dann erneut durch
7. Binden Sie Planungs-/Webhook-Trigger nach Bedarf

Schritt 1 · Durchsuchen Sie die Vorlagengalerie

1.1 Öffnen Sie den Eingang

Die Hauptnavigation auf der linken Seite ist „Vorlagenbibliothek“. Seitenstruktur:

• Obere Filterleiste – 10 Branchenkategorien + Tags + Stichwortsuche
• Vorlagenkartenraster – mit Name, Beschreibung, Tags, geschätzter Dauer und Komplexität
• „Meine Sammlung“ oben rechts – Langzeitvorlagen können gesammelt und beim nächsten Mal direkt eingegeben werden

1.2 Gängige Auswahlstrategien

• Die Bedürfnisse sind sehr spezifisch — Suchen Sie direkt nach Schlüsselwörtern. Wenn Sie beispielsweise eine „Erinnerung an den Ablauf des TestFlight-Zertifikats“ durchführen möchten, suchen Sie nach dem Ablauf des Zertifikats und es wird sofort gesperrt.
• Die Nachfrage ist breit — Konvergenz basierend auf der Branche zuerst. Wählen Sie eine Branchenkategorie aus, mit der Sie am besten vertraut sind, und blättern Sie zwei oder drei Seiten um, um eine ungefähre Vorstellung davon zu bekommen, welche Arten von Prozessen wir haben.
• Möchten Sie „sehen, was andere in der Branche tun“ — Sortieren Sie nach „Komplexität“ und wählen Sie die komplexesten aus – es handelt sich in der Regel um ausgereifte End-to-End-Praktiken.

Schritt 2 · Lesen Sie die Vorlagendetails

Klicken Sie auf eine Vorlagenkarte, um die Detailseite aufzurufen, die sich auf vier Teile konzentriert:

2.1 Abschnitt „Beschreibung“.

Sagen Sie in zwei bis drei Absätzen: welche Probleme es löst, für welche Szenarien es am besten geeignet ist, für welche Szenarien es nicht geeignet ist und welche Vorbereitungen vor der Verwendung erforderlich sind.

2.2 Liste der „erforderlichen Anmeldeinformationen“

Listen Sie die zum Ausführen dieses Workflows erforderlichen Anmeldeinformationen klar auf, zum Beispiel:

• openai_api_key — OpenAI-API-Schlüssel (erforderlich)
• slack_webhook_url — Telegram-Bot-Token (zur Lieferung, optional)
• apple_appstoreconnect — App Store Connect JWT (nur für Apple-bezogene Vorlagen erforderlich)

Fehlt eine der „erforderlichen“ Anmeldeinformationen, schlägt der Workflow beim Erreichen des entsprechenden Schritts fehl. Wenn „optional“ fehlt, wird der entsprechende Schritt je nach Bedingung übersprungen.

2.3 „Geschätzter Zeit- und Kostenaufwand“

Eine komplette Ausführung:

• Benötigte Zeit: 2 Minuten / 15 Minuten / 1 Stunde, abhängig von der Komplexität des Workflows und der Reaktionsgeschwindigkeit externer Abhängigkeiten
• Token-Nutzung – durchschnittliche xxx-Eingabe / xxx-Ausgabe
• $ Geschätzter Wert – der ungefähre Wert, der auf der Grundlage der Standardvoreinstellungen der Plattform und des OpenAI-Stückpreises berechnet wird

2.4 „Beispieleingabe und Beispielausgabe“

Ein bestimmtes Eingabebeispiel (Sie können es einfach kopieren und einmal ausführen) + das entsprechende Ausgabebeispiel (damit Sie eine Vorstellung davon haben, „was Sie wahrscheinlich bekommen können“).

Schritt 3 · In den Arbeitsbereich klonen

1. oberen rechten Eckpunkt „Diese Vorlage verwenden“.
2. Geben Sie Ihrer Kopie im Popup-Fenster einen Namen (die Standardeinstellung ist Vorlagenname + Zeitstempel, Sie können ihn in einen Namen mit geschäftlicherer Bedeutung ändern).
3. Wählen Sie Ihr Zielteam aus (wenn Sie in mehreren Teams sind). Dadurch wird festgelegt, wer diesen Workflow sehen/bearbeiten kann.
4. Klicken Sie auf OK. Die Plattform erstellt eine Kopie für Sie unabhängige Kopie. Ihre Änderungen werden nicht an die Vorlage zurückgespielt, und spätere Aktualisierungen der Vorlage ändern Ihre Kopie nicht automatisch.

Schritt 4 · Passen Sie die Geschäftsparameter an

Der Abschnitt 4.1-Variablen ist der einzige Ort, an dem Sie sorgfältig hinsehen müssen

Wenn der Editor geöffnet wird, scrollen Sie zunächst durch die YAML zum Abschnitt „Variablen“ oben. Alle „Dinge, die in diesem Workflow an Ihre Geschäftssituation angepasst werden müssen“ sind hier, bereits kommentiert:

variables:
  target_date:
    type: string
    default: yesterday    # ← 改成你要跑哪一天的数据
    description: |
      支持 yesterday / last_7_days / last_30_days /
      或具体日期 2026-04-17

  top_n:
    type: number
    default: 10           # ← 要拉多少条新闻
    description: 抓取的新闻数量上限

  target_channel:
    type: string
    default: "#my_daily_digest"  # ← 改成你的 Slack 频道名或保留默认 webhook 目标
    description: Slack 目标频道或 Incoming Webhook 默认目标

4.2 Ändern Sie den Standardwert entsprechend dem Kommentar

Der Standardwert ist nur ein „Beispiel“, bitte ersetzen Sie ihn durch den tatsächlichen Wert in Ihrem Unternehmen. Durch das Ändern von Variablen wird die Struktur nicht zerstört. Sie können sie also jederzeit ändern.

4.3 Es ist eine gute Angewohnheit, sich nicht in Schritten zu bewegen

Es wird nicht empfohlen, die Struktur des Schrittabschnitts zu ändern, wenn Sie die Vorlage zum ersten Mal ausführen. Führen Sie sie zunächst einmal mit dem Standardprozess aus, sehen Sie sich den Datenfluss an und entscheiden Sie dann, ob Sie ihn ändern möchten.

Schritt 5 · Schließen Sie das Credential Center ab

1. Öffnen Sie das Credential Center.
2. Erstellen Sie für jede „erforderliche“ Anmeldeinformation, die auf der Seite mit den Vorlagendetails aufgeführt ist, eine entsprechende Anmeldeinformation. Der Name muss genau mit dem im YAML angegebenen Namen übereinstimmen.
3. „Optionale“ Anmeldeinformationen können vorerst nicht erstellt werden – die entsprechenden Schritte werden übersprungen.

Schritt 6 · Zuerst Trockenlauf durchführen, dann laufen lassen

6.1 Die Bedeutung von Trockenlauf

Der Probelauf läuft kostenlos durch die DAG und überspringt alle LLM- und Nebenwirkungen. Es hilft Ihnen zu bestätigen, bevor Sie Geld ausgeben:

• Sind alle Variablen korrekt ausgefüllt?
• Variablen fließen zwischen Schritten
• Der Zweig Bedingung/Klassifikator ist korrekt ausgewählt.
• Der abhängige Anmeldeinformationsname kann aufgelöst werden

6.2 Echter Lauf

Deaktivieren Sie nach dem Probelauf die Option „Trockenlauf“ und klicken Sie erneut auf „Ausführen“. Dieses Mal werde ich LLM wirklich anpassen und echte Nebenwirkungen haben. Über den Echtzeit-Ereignisstream auf der rechten Seite der Seite können Sie den Fortschritt jedes Schritts verfolgen.

6.3 Was Sie nach dem Laufen beachten sollten

• „Ausführungsdetails anzeigen“ – Gantt-Diagramm + Eingabe/Ausgabe jedes Schritts
• „Produktspalte“ – das generierte Markdown/Excel/Bild kann direkt heruntergeladen werden
• „Tokens / Kosten“ – Wie viel haben Sie dieses Mal ausgegeben?

Schritt 7 · Binden Sie Trigger nach Bedarf

Nach der manuellen Ausführung ist der Workflow bereit, online zu gehen. Drei gängige Auslösemethoden:

• Geplante Ausführungen — Täglich/wöchentlich/monatlich oder in Abständen wiederholen
• Webhook-trigger — Auslösung durch einen POST eines externen Systems, authentifiziert per API Key (auch HMAC-Signaturen werden unterstützt)
• API-Auslösung — Ihr internes System startet die Ausführung über die REST API mit einem API Key

Vorlagen-upgrade: einer neuen Version der Vorlage folgen

Eine geklonte Kopie wird durch Aktualisierungen der Vorlage nicht automatisch verändert. Wenn die Ursprungsvorlage eine neue Version veröffentlicht und Sie ihr folgen möchten, nutzen Sie den Ablauf „Von Vorlage aktualisieren“: zunächst eine Vorschau ansehen, nach Bestätigung mit einem Klick aktualisieren.

Wo Befindet sich der Einstieg

Sie erreichen ihn an zwei Stellen: über „Von Vorlage aktualisieren“ im Menü der Editor-Symbolleiste oder über den Hinweis „Auf Updates prüfen“ oberhalb des Variablenbereichs im Workflow-Einstellungspanel. Der geöffnete Dialog zeigt die aktuelle und die Zielversion an.

Vor dem Upgrade zunächst die Vorschau ansehen

Die Vorschau teilt die Variablenunterschiede in drei Kategorien auf und listet sie einzeln auf:

• Reservieren — Variablen, die Sie geändert haben und die in der neuen Vorlage weiterhin vorhanden sind, behalten nach dem Upgrade Ihren Wert
• Neu — Neu in der Vorlage hinzugefügte Variablen werden mit dem Standardwert der Vorlage befüllt und nach dem Upgrade bei Bedarf angepasst
• Löschen — Variablen, die in der neuen Vorlage nicht mehr vorhanden sind, werden nach dem Upgrade verworfen — prüfen Sie diese Liste vor der Bestätigung Punkt für Punkt

Was beim Upgrade passiert

• Zunächst wird der aktuelle Workflow automatisch als Versions-Snapshot gespeichert; falls Sie es sich anders überlegen, können Sie im Menü „Versionen“ zurückgehen
• Strukturelle Konfigurationen wie der Schritt-DAG, der Agent-Prompt, Code und Timeouts werden durch die neue Vorlage überschrieben
• Ihre selbst gewählten Modelle bleiben erhalten: Die Modellauswahl namensgleicher Agenten und die zugehörigen Verweise auf Modell-Anmeldedaten werden von der neuen Vorlage nicht überschrieben
• Ihre eigenen Einstellungen wie Workflow-Name, Tags und Parallelität bleiben unverändert

Der alte Workflow hat keine Ursprungsvorlage erfasst?

Früh geklonte Workflows haben möglicherweise keine Herkunft erfasst; in diesem Fall wird derselbe Eintrag im Editor-Menü als „Vorlage verknüpfen…“ angezeigt. Tragen Sie nach, aus welcher Vorlage der Workflow stammt (Sie können dabei gleich markieren, welcher Version er aktuell entspricht), danach lässt sich der Upgrade-Prozess normal durchlaufen.

Erweitert: Lassen Sie den KI-Assistenten es gemäß Ihrer Beschreibung ändern

Wenn die Geschäftsanforderungen nach dem Klonen nicht vollständig mit der Vorlage übereinstimmen, können Sie den KI-Assistenten bitten, Ihnen bei der Behebung des Problems zu helfen:

1. FAB in der unteren rechten Ecke öffnet die KI-Assistenten-Schublade
2. Beschreiben Sie Ihre Bedürfnisse – zum Beispiel „step.deliver von Telegram auf Feishu umstellen“
3. Der Assistent zeigt Ihnen eine Diff-Vorschau an, die Sie annehmen oder ablehnen können.
4. Klicken Sie auf „Übernehmen“, wenn Sie zufrieden sind. Der 10-stufige Rückgängig-Stack schützt Sie vor einem jederzeitigen Rollback

Wann sollten Sie auf einen KI-Assistenten oder eine Handschrift umsteigen?

Nächster Schritt

• Klassifizierungsdetails und typische Vorlagen — Ausgewählte Vertreter jeder Branchenkategorie verraten Ihnen, was jede Kategorie leisten kann
• Visueller Editor — Auf welche Schaltflächen sollten Sie nach dem Klonen klicken?
• Ki-assistent — Verwenden Sie natürliche Sprache, um Arbeitsabläufe zu ändern/generieren