Start

Der Start-Block ist der Standard-Auslöser für Workflows, die in Sim erstellt werden. Er sammelt strukturierte Eingaben und verteilt sie an den Rest deines Graphen für Editor-Tests, API-Bereitstellungen und Chat-Erlebnisse.

Der Start-Block befindet sich in der Startposition, wenn du einen Workflow erstellst. Behalte ihn dort, wenn du denselben Einstiegspunkt für Editor-Ausführungen, Deploy-to-API-Anfragen und Chat-Sitzungen verwenden möchtest. Tausche ihn mit Webhook- oder Schedule-Triggern aus, wenn du nur ereignisgesteuerte Ausführung benötigst.

Von Start bereitgestellte Felder

Der Start-Block gibt je nach Ausführungsumgebung unterschiedliche Daten aus:

Eingabeformat-Felder — Jedes Feld, das du hinzufügst, wird als <start.fieldName> verfügbar. Zum Beispiel erscheint ein customerIdFeld als <start.customerId> in nachgelagerten Blöcken und Vorlagen.
Nur-Chat-Felder — Wenn der Workflow über das Chat-Seitenfeld oder ein bereitgestelltes Chat-Erlebnis ausgeführt wird, stellt Sim auch <start.input> (neueste Benutzernachricht), <start.conversationId> (aktive Sitzungs-ID) und <start.files> (Chat-Anhänge) bereit.

Halte die Eingabeformat-Felder auf die Namen beschränkt, auf die du später verweisen möchtest – diese Werte sind die einzigen strukturierten Felder, die über Editor-, API- und Chat-Ausführungen hinweg geteilt werden.

Konfiguriere das Eingabeformat

Verwende den Eingabeformat-Unterblock, um das Schema zu definieren, das für alle Ausführungsmodi gilt:

Füge ein Feld für jeden Wert hinzu, den du sammeln möchtest.
Wähle einen Typ (string, number, boolean, object, array oder files). Dateifelder akzeptieren Uploads von Chat- und API-Aufrufern.
Gib Standardwerte an, wenn du möchtest, dass das manuelle Ausführungsmodal automatisch Testdaten einfügt. Diese Standardwerte werden für bereitgestellte Ausführungen ignoriert.
Ordne Felder neu an, um zu steuern, wie sie im Editor-Formular erscheinen.

Referenzieren Sie strukturierte Werte nachgelagert mit Ausdrücken wie <start.customerId> abhängig vom Block, den Sie verbinden.

Wie es sich je nach Einstiegspunkt verhält

Wenn Sie im Editor auf Ausführen klicken, rendert der Start-Block das Eingabeformat als Formular. Standardwerte erleichtern das erneute Testen ohne erneute Dateneingabe. Durch das Absenden des Formulars wird der Workflow sofort ausgelöst und die Werte werden unter <start.feldName> (zum Beispiel <start.sampleField>) verfügbar.

Dateifelder im Formular werden direkt in die entsprechenden <start.fieldName> hochgeladen; verwenden Sie diese Werte, um nachgelagerte Tools oder Speicherschritte zu versorgen.

Die Bereitstellung als API verwandelt das Eingabeformat in einen JSON-Vertrag für Clients. Jedes Feld wird Teil des Anforderungskörpers, und Sim erzwingt primitive Typen bei der Aufnahme. Dateifelder erwarten Objekte, die auf hochgeladene Dateien verweisen; verwenden Sie den Ausführungs-Datei-Upload-Endpunkt, bevor Sie den Workflow aufrufen.

API-Aufrufer können zusätzliche optionale Eigenschaften einbeziehen. Diese werden in den <start.fieldName>Ausgaben beibehalten, sodass Sie experimentieren können, ohne sofort neu bereitzustellen.

Bei Chat-Bereitstellungen bindet sich der Start-Block an die aktive Konversation. Die neueste Nachricht füllt <start.input>, die Sitzungskennung ist unter <start.conversationId> verfügbar, und Benutzeranhänge erscheinen unter <start.files>, zusammen mit allen Eingabeformatfeldern, die als <start.fieldName> definiert sind.

Wenn Sie den Chat mit zusätzlichem strukturiertem Kontext starten (zum Beispiel aus einer Einbettung), wird dieser mit den entsprechenden <start.fieldName>Ausgaben zusammengeführt, wodurch nachgelagerte Blöcke konsistent mit API- und manuellen Ausführungen bleiben.

Referenzierung von Start-Daten in nachgelagerten Komponenten

Verbinde <start.fieldName> direkt mit Agenten, Tools oder Funktionen, die strukturierte Daten erwarten.
Verwende Template-Syntax wie <start.sampleField> oder <start.files[0].url> (nur für Chat) in Prompt-Feldern.
Halte <start.conversationId> bereit, wenn du Ausgaben gruppieren, den Gesprächsverlauf aktualisieren oder die Chat-API erneut aufrufen musst.

Best Practices

Behandle den Start-Block als einzigen Einstiegspunkt, wenn du sowohl API- als auch Chat-Aufrufer unterstützen möchtest.
Bevorzuge benannte Eingabeformat-Felder gegenüber dem Parsen von rohem JSON in nachgelagerten Knoten; Typumwandlung erfolgt automatisch.
Füge unmittelbar nach dem Start Validierung oder Routing hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.
Verbinde <start.fieldName> direkt mit Agenten, Tools oder Funktionen, die strukturierte Daten erwarten.
Verwende Template-Syntax wie <start.sampleField> oder <start.files[0].url> (nur im Chat) in Prompt-Feldern.
Halte <start.conversationId> bereit, wenn du Ausgaben gruppieren, Gesprächsverlauf aktualisieren oder die Chat-API erneut aufrufen musst.

Bewährte Praktiken

Behandle den Start-Block als einzigen Einstiegspunkt, wenn du sowohl API- als auch Chat-Aufrufer unterstützen möchtest.
Bevorzuge benannte Eingabeformat-Felder gegenüber dem Parsen von rohem JSON in nachgelagerten Knoten; Typumwandlung erfolgt automatisch.
Füge Validierung oder Routing unmittelbar nach dem Start hinzu, wenn bestimmte Felder für den Erfolg deines Workflows erforderlich sind.