Workflow-Variablen

Echo verwaltet für jede Workflow-Ausführung einen Laufzeitkontext. Eingaben gelangen in diesen Kontext, abgeschlossene Schritte ergänzen Ausgaben und unterstützte Aktionsfelder können Werte mit {{...}} interpolieren.

Eingaben

Deklarierte Workflow-Eingaben können Typ, Standardwert, Pflichtstatus, Beschreibung, Optionen und Bezeichnung besitzen. Das aktuelle Formular „Konfigurieren“ zeigt bereits im Workflow deklarierte Eingaben an und erlaubt die Änderung ihrer Standardwerte; es bietet keinen allgemeinen Editor zum Hinzufügen neuer Eingaben.

Ein Testlauf stellt den eingegebenen Text stets sowohl als {{input}} als auch als {{transcription}} bereit. Andere Triggerpfade können je nach Aufrufer Transkription, markierten Text, Zwischenablage, aktive App und weiteren Laufzeitkontext übergeben.

Die Laufzeit reserviert folgende Namen; Benutzer-Workflows dürfen sie nicht mit „Variable setzen“ überschreiben:

transcription, selected_text, clipboard, active_app, active_window_title, workflow_id, workflow_name und app_context.

Sprachplätze können nach einem gesprochenen Trigger eigene sichere Feldnamen ergänzen. Weitere Einzelheiten finden Sie unter Sprachplätze.

Ausgaben

Eine Aktion mit Datenausgabe besitzt einen Standardnamen in der Aktionsreferenz. Im Tab E/A eines Knotens kann Ausgabe diesen Standard durch einen verständlichen Alias wie trimmed oder response_body ersetzen.

Abgeschlossene Schrittdaten werden außerdem unter der stabilen Knoten-ID gespeichert. Eine Graphkante kann daher {{source_node_id}} an den nächsten Knoten übergeben, während ein ausdrücklicher Ausgabealias späteren Aktionen eine lesbare Referenz bietet.

Der Gültigkeitsbereich im Editor gilt nur vorwärts: Die E/A-Auswahl enthält Workflow-Eingaben und Ausgabealias früherer Aktionen, niemals Ausgaben späterer Aktionen. In einem Graphen ist eine explizite vorgelagerte Kante die eindeutigste Abhängigkeit. Verlassen Sie sich nicht allein auf die Position auf der Arbeitsfläche.

Auf Workflow-Ebene benennt Workflow-Ausgabe die zurückzugebende Variable. Echo fällt danach auf die letzte konfigurierte Schrittausgabe und schließlich, sofern vorhanden, auf processed_text zurück. Ein Name, dem nie ein Wert zugewiesen wird, kann keinen Rückgabewert liefern.

Interpolation

Verwenden Sie in unterstützten Feldern doppelte geschweifte Klammern:

{{input}}
{{trimmed}}
{{response.status}}
{{count + 1}}
{{name || 'Anonymous'}}
{{upper(trim(name))}}

Die Interpolation unterstützt Variablen- und Eigenschaftszugriff, Ausdrücke, gebräuchliche Funktionen, Arithmetik, Vergleiche, Bedingungen und Rückfallausdrücke. Aus Gründen der Abwärtskompatibilität wird ein fehlender Wert in doppelten Klammern als leere Zeichenfolge aufgelöst. Validieren Sie Pflichtangaben daher, statt einen sichtbaren Fehler vorauszusetzen.

Wiederverwendbare Konstanten — gemeinsame Werte, referenziert als {{constants.KEY}} — werden im Einstellungs-Tab des Rezepteditors unter Globale Workflow-Konstanten gepflegt. Behandeln Sie sie als gewöhnliche Workflow-Eingabe, nicht als Geheimnisspeicher.

Nicht jedes Feld unterstützt Interpolation, und nicht jede Aktion stellt dieselbe Eingabesteuerung bereit. Prüfen Sie die erzeugten Felder und das Beispiel der Aktion, statt Verhalten zu erraten.

Geheimnisse

Workflow-Variablen, Sprachplätze, Knotenwerte, Ausgabealias, Konsole und Ausführungsverlauf sind kein Geheimnisspeicher. Fügen Sie API-Schlüssel, Zugriffstoken, Passwörter, private Schlüssel oder Anmeldedaten niemals in gewöhnliche Variablen, Beispiele, Testeingaben, Prompts, Dateipfade oder Rezept-YAML ein.

Verwenden Sie konfigurierte Anbieter- oder Executor-Profile für LLM-Anmeldedaten. Behandeln Sie Umgebungsvariable abrufen, Shell-, HTTP-, Datei-, Plugin- und LLM-Aktionen als ausdrückliche Vertrauensgrenzen: Eine Aktion, die Daten lesen oder übertragen kann, kann ein Geheimnis in ihrer Eingabe offenlegen, auch wenn der Name des Workflows harmlos erscheint.

Bevor Sie Inhalte von Drittanbietern importieren oder ausführen, folgen Sie den rekursiven Berechtigungen und vergleichen Sie jede Aktion mit den erzeugten Berechtigungsmetadaten in der Aktionsreferenz.