Blöcke

Jeder Block tut genau eine Sache. Seine Einstellungen findest du im Inspektor, sobald du ihn auswählst; seine Ports sitzen auf der Arbeitsfläche, die Eingänge links und die Ausgänge rechts. Diese Seite listet jede Blockart in den Gruppen der Blockauswahl und erklärt dann die Werte, die zwischen Blöcken wandern, Vorlagen wie {{body.id}} und Bedingungen.

Wie ein Durchlauf abläuftCopy Anchor Link

• Ein Block läuft, sobald jeder Eingang mit einer Verbindung einen Wert hat. Er sendet dann Werte aus einigen seiner Ausgänge, und nur die Blöcke, die daran hängen, laufen als Nächstes.
• Start läuft zuerst. Die Blöcke „Wert“ und „Variable lesen“, in die nichts verbunden ist, laufen ebenfalls am Anfang.
• Blöcke laufen nebeneinander, wenn es geht. Ein Block „Zeigen und warten“ kann auf dich warten, während ein Block „Abfragen“ weiterläuft.
• Mehrere Blöcke können fehlschlagen: „Anfrage“, „Abfragen“, „Tool“, „Flow“, „Auswerten“ und „Datei schreiben“ haben einen Ausgang fail. Ist er verbunden, kommt der Fehler dort heraus und der Durchlauf geht weiter. Ist er es nicht, schlägt der ganze Durchlauf an diesem Block fehl.
• Der Durchlauf endet, wenn nichts mehr läuft.

Der Inspektor jedes Blocks hat außerdem Titel (auf dem Block angezeigt; leer zeigt er den Namen der Blockart) und Pausiert (Werte gehen direkt durch). Ein pausierter Block ist abgeblendet und wird übersprungen: Was hineinkommt, geht direkt aus seinem ersten Ausgang wieder heraus.

AuslöserCopy Anchor Link

StartCopy Anchor Link

Hier beginnt ein Durchlauf: mit der Taste Ausführen, über einen Agenten (wenn der Flow ein Tool ist), einen Zeitplan, einen Webhook oder echolot flow run. Sein Inspektor enthält die Auslöser des Flows; siehe Ausführen und Auslöser.

Ein Flow hat genau einen Block „Start“. Er steht nicht in der Blockauswahl.

AusgabeCopy Anchor Link

Was der Durchlauf zurückgibt: an den Agenten, der den Flow aufgerufen hat, an die Befehlszeile, an den Aufrufer des Webhooks oder an einen übergeordneten Flow. Ein Flow hat höchstens einen.

AktionenCopy Anchor Link

AnfrageCopy Anchor Link

Sendet eine gesicherte Anfrage des Arbeitsbereichs (HTTP, GraphQL oder eine MCP-Anfrage) mit ihrer Auth, ihren Skripten, Prüfungen und der Umgebung des Durchlaufs.

Eine Anfrage ist erfolgreich, wenn sie mit 2xx antwortet und ihre Prüfungen, Skript-Tests und Skripte alle bestehen, wie in der Ausführung. Variablen, die ein Flow übergibt, gelten nur für dieses Senden und haben Vorrang vor denen der Umgebung.

Im Flow Place a test order ist der Ausgang success von Sign in mit send von Create order verbunden: Die Bestellung wird erst aufgegeben, nachdem die Anmeldung geklappt hat, und das Token, das Sign in erfasst, steht schon in {{token}}.

ToolCopy Anchor Link

Führt eines der eigenen Tools von Echolot aus, etwa einen Mock starten, einen Ordner ausführen, eine Spec prüfen oder ein Tool eines MCP-Servers aufrufen – mit denselben Regeln wie für Agenten.

Ein Block „Tool“ kann keinen anderen Flow ausführen; dafür gibt es den Block „Flow“.

FlowCopy Anchor Link

Führt einen anderen Flow des Arbeitsbereichs aus und sendet, was bei dessen Block „Ausgabe“ angekommen ist.

Flows führen sich höchstens 8 Ebenen tief gegenseitig aus. Secrets wandern nicht als Werte zwischen Flows: Sichere sie stattdessen als Variablen.

PersonenCopy Anchor Link

Blöcke dieser Gruppe halten den Durchlauf an und fragen dich etwas. In der App öffnet sich ein Blatt; wenn ein Agent den Flow gestartet hat, geht die Frage an den Client des Agenten; in der Befehlszeile wird sie im Terminal gestellt. Bei Durchläufen, die Zeitpläne und Webhooks starten, ist niemand da, den man fragen könnte – ein Block dieser Gruppe schlägt dort fehl, ebenso echolot flow run --no-input.

FragenCopy Anchor Link

Fragt Werte mit einem kleinen Formular ab.

Das Blatt hat Abbrechen und Fortfahren. Antworten auf Felder vom Typ secret sind im Durchlaufprotokoll verborgen.

Zeigen und wartenCopy Anchor Link

Zeigt eine Nachricht, einen Code zum Kopieren und einen Link zum Öffnen und wartet dann auf Fortfahren oder darauf, dass ein Wert an until ankommt. Nutze es für Geräteanmeldungen: Zeige den Code, während ein Block „Abfragen“ auf die Genehmigung wartet.

Alle fünf nehmen Vorlagen an.

Ist until verbunden, steht auf dem Blatt Danach geht es von selbst weiter. Nicht mehr warten schließt es und lässt den Block fehlschlagen.

GenehmigenCopy Anchor Link

Bittet dich um Genehmigung, bevor der Flow weitergeht – vor etwas, das sich nicht rückgängig machen lässt.

Genehmigen ist immer Sache der Person. Wenn ein Agent einen Flow ausführt und einen Block „Genehmigen“ beantwortet, legt Echolot dir die Frage zuerst vor. In Place a test order fragt der Block „Genehmigen“ namens Keep the order? Keep order {{body.id}} for CHF {{body.total.amount}}? mit der Bestellung, die der Shop gerade angelegt hat; Ablehnen schickt sie weiter zu Cancel order.

LogikCopy Anchor Link

WennCopy Anchor Link

Sendet, was hereinkommt, nach einer Bedingung an true oder false.

Morning stock check verwendet einen Block „Wenn“ namens Running low? mit value.body.items.some(p => p.stock.bern < 5) auf die Produkte, die der Shop zurückgegeben hat.

SwitchCopy Anchor Link

Sendet, was hereinkommt, an den ersten Fall, dessen Bedingung zutrifft, sonst an default.

AuswertenCopy Anchor Link

Führt JavaScript auf dem aus, was hereinkommt. Der letzte Ausdruck ist das Ergebnis: ({ id: value.body.id }) oder a + b. Code mit einem eigenen return läuft als Rumpf einer Funktion, und was return liefert, ist das Ergebnis. Ein Promise wird abgewartet. pm.test und pm.expect funktionieren wie in Skripten, und ihre Ergebnisse zählen als Tests des Durchlaufs. Zeilen von console.log landen im Durchlaufprotokoll.

// Inputs: pages. Joins the lists that Collect gathered.
return pages.flat();

VerzögernCopy Anchor Link

Wartet und gibt den Wert dann weiter.

Ports: value ein, value aus.

SchleifenCopy Anchor Link

WiederholenCopy Anchor Link

Sendet index so oft wie Anzahl, von 0 aufwärts gezählt, dann done.

Für jedesCopy Anchor Link

Sendet nacheinander jedes Element einer Liste, dann done. Es hat keine Einstellungen.

SammelnCopy Anchor Link

Sammelt, was während einer Schleife ankommt, in einer Liste und sendet sie, wenn die Schleife fertig ist. Es hat keine Einstellungen.

Jede Runde einer Schleife ist fertig, bevor die nächste beginnt, und die Blöcke, die sie erreicht, laufen in jeder Runde erneut. Werte von außerhalb der Schleife, etwa eine Eingabe von Start, bleiben für jede Runde verfügbar.

AbfragenCopy Anchor Link

Sendet eine gesicherte Anfrage immer wieder, bis eine Bedingung zutrifft (eine Anmeldung genehmigt, ein Job fertig) oder die Frist abläuft.

Anders als bei „Anfrage“ lässt eine Antwort außerhalb von 2xx den Block „Abfragen“ nicht fehlschlagen: Er sendet erneut, bis Bis zutrifft.

DatenCopy Anchor Link

WertCopy Anchor Link

Ein fester Wert: Text, eine Zahl, true oder false, eine Liste oder ein Objekt.

VorlageCopy Anchor Link

Text, dessen {{name}} aus dem ankommenden Objekt und den Variablen des Durchlaufs gefüllt wird.

Ports: values ein (ein Objekt), text aus.

AuswählenCopy Anchor Link

Greift per Pfad Werte aus dem heraus, was hereinkommt, je einen pro Ausgang.

Pfade sind der gemeinsame Teil von JSONPath:

Variable setzenCopy Anchor Link

Sichert Werte als Variablen, damit spätere Blöcke und Anfragen sie mit {{name}} lesen.

Mit secret an kommt der Wert in den Schlüsselbund, nie in eine Datei, und ab dem Moment, in dem er den Block verlässt, ist er im Durchlaufprotokoll und in dem, was Agenten sehen, verborgen. Findet path nichts, behält die Variable ihren alten Wert, sodass eine Token-Antwort ohne neues Refresh-Token das vorhandene nicht löscht. Siehe Secrets.

Ports: value ein, value aus (das Hereingekommene, weitergegeben).

Variable lesenCopy Anchor Link

Liest eine Variable so, wie Anfragen sie sehen: zuerst die des Durchlaufs, dann die der Umgebung, des Arbeitsbereichs und die globalen.

AusgabeCopy Anchor Link

AnzeigenCopy Anchor Link

Gibt weiter, was hereinkommt, unverändert, damit du es dir ansehen kannst: Wähle den Block nach einem Durchlauf aus und lies Letzter Durchlauf im Inspektor.

Ports: value ein, value aus.

LogCopy Anchor Link

Schreibt eine Zeile ins Durchlaufprotokoll.

Ports: value ein, value aus. In Place a test order schreibt Order failed Create order answered {{status}}, wenn sich die Bestellung nicht aufgeben lässt.

PrüfenCopy Anchor Link

Prüft, was hereinkommt. Jede Prüfung ist ein Testergebnis des Durchlaufs, und eine fehlgeschlagene lässt echolot flow run fehlschlagen.

value.status === 200   // Answers 200
value.time < 2000      // Within two seconds

MitteilenCopy Anchor Link

Zeigt eine macOS-Mitteilung von Echolot. macOS fragt beim ersten Mal nach der Erlaubnis. In der Befehlszeile wird die Mitteilung stattdessen ausgegeben.

Ports: value ein, value aus. Morning stock check endet mit einem Block „Mitteilen“ namens Restock mit dem Titel Restock Bern.

Datei schreibenCopy Anchor Link

Schreibt, was hereinkommt, in eine Datei im Ordner des Arbeitsbereichs.

Eine vorhandene Datei wird ersetzt. Die eigenen Dateien des Arbeitsbereichs sind tabu: die Ordner requests, flows, environments, mocks, mcp-servers und specs, workspace.toml und versteckte Dateien. Bei CSV wird aus einer Liste von Objekten eine Zeile pro Objekt mit einer Spalte pro Schlüssel; alles andere wird mit einem Wert pro Zeile geschrieben.

Werte zwischen BlöckenCopy Anchor Link

Werte sind JSON: Text, Zahlen, true und false, Listen, Objekte oder null.

Das AntwortobjektCopy Anchor Link

„Anfrage“ und „Abfragen“ senden eine Antwort als Objekt:

{
  "status": 201,
  "reason": "Created",
  "headers": { "content-type": "application/json", "location": "/v1/orders/ord_9Px3Kd" },
  "body": { "id": "ord_9Px3Kd", "total": { "amount": 449, "currency": "CHF" } },
  "time": 182.4,
  "url": "https://demo.echolot.dev/v1/orders"
}

• body ist geparstes JSON, wenn die Antwort JSON ist, sonst Text, und null, wenn sie leer ist.
• Header-Namen sind kleingeschrieben. Ein Header, der mehrfach gesendet wurde, wird mit , verbunden.
• time ist der ganze Austausch in Millisekunden.
• Ein Body über 8 MB kommt als null mit "truncated": true an. Die vollständige Antwort steht weiterhin im Verlauf.

VorlagenCopy Anchor Link

Einstellungen mit dem Hinweis „Vorlagen sind erlaubt“ füllen {{name}} aus dem, was in den Block hereinkam:

• {{status}}, {{body.id}} oder {{body.items[0].sku}}: ein Schlüssel oder ein Pfad in das Objekt, das hereingekommen ist.
• {{value}} bei „Log“, „Mitteilen“ und „Datei schreiben“: der ganze Wert, der hereingekommen ist.
• Variablen, die ein Block „Variable setzen“ mit der Ebene run gesichert hat.

Ein Name, der nichts trifft, bleibt, wie er ist, sodass die eigenen {{variables}} eines Blocks „Anfrage“ beim Senden weiterhin aus der Umgebung aufgelöst werden. Objekte und Listen werden als JSON-Text geschrieben.

BedingungenCopy Anchor Link

„Wenn“, „Switch“, „Abfragen“ und „Prüfen“ nehmen einen JavaScript-Ausdruck, der wahr oder falsch ist. value ist das Hereingekommene; Bis bei „Abfragen“ liest es als response, was auch überall sonst funktioniert.

value.status == 200
response.status === 200 && !!(response.body && response.body.access_token)
value.body.items.length > 0

Ein Ausdruck, der eine Ausnahme auslöst, lässt den Block fehlschlagen (bei „Prüfen“ lässt er diese Prüfung fehlschlagen).

GrenzenCopy Anchor Link

Damit eine falsche Verbindung nicht ewig laufen kann, stoppt ein Durchlauf nach 10.000 Blockausführungen oder einer Stunde. Durchläufe, die Webhooks starten, stoppen nach zwei Minuten.