Блоки

Каждый блок делает одно дело. Его настройки — в инспекторе, когда вы выбираете блок; его порты — на холсте, входы слева и выходы справа. На этой странице перечислены все виды блоков в тех группах, которые использует список блоков, а затем объясняются значения, которые передаются между блоками, шаблоны вроде {{body.id}} и условия.

Как идёт запускCopy Anchor Link

• Блок выполняется, когда у каждого входа, в который ведёт связь, есть значение. Затем он отправляет значения из некоторых своих выходов, и дальше выполняются только блоки, связанные с этими выходами.
• Первым выполняется «Старт». Блоки «Значение» и «Получить переменную», в которые ничто не ведёт, тоже выполняются в самом начале.
• Блоки выполняются параллельно, когда это возможно. Блок «Показать и ждать» может ждать вас, пока блок «Опрос» продолжает работу.
• Несколько блоков могут завершиться ошибкой: у «Запрос», «Опрос», «Инструмент», «Сценарий», «Вычислить» и «Записать файл» есть выход fail. Если он связан, ошибка выходит через него, и запуск продолжается. Если нет, весь запуск завершается ошибкой на этом блоке.
• Запуск заканчивается, когда ничего не остаётся в работе.

В инспекторе каждого блока есть также Название (показывается на блоке; если пусто, это название вида) и Приостановлен (значения проходят насквозь). Приостановленный блок затемнён и пропускается: то, что приходит в него, сразу выходит из его первого выхода.

ТриггерыCopy Anchor Link

СтартCopy Anchor Link

Здесь начинается запуск: кнопка Запустить, агент (когда сценарий — инструмент), расписание, вебхук или echolot flow run. В его инспекторе находятся Триггеры сценария; см. Запуск и триггеры.

В сценарии ровно один блок «Старт». В списке блоков его нет.

РезультатCopy Anchor Link

То, что возвращает запуск: агенту, вызвавшему сценарий, командной строке, вызывающему вебхук или родительскому сценарию. В сценарии не больше одного такого блока.

ДействияCopy Anchor Link

ЗапросCopy Anchor Link

Отправляет сохранённый запрос рабочего пространства (HTTP, GraphQL или запрос MCP) с его авторизацией, скриптами, проверками и окружением запуска.

Запрос успешен, если ответ 2xx, а его проверки, тесты скриптов и скрипты пройдены, как в Прогоне. Переменные, которые передаёт сценарий, побеждают переменные окружения только для этой отправки.

В сценарии Place a test order выход success блока Sign in связан с send блока Create order: заказ создаётся только после того, как вход удался, а токен, который захватывает Sign in, уже лежит в {{token}}.

ИнструментCopy Anchor Link

Выполняет один из собственных инструментов Echolot, например запускает мок, прогоняет папку, проверяет спецификацию линтером или вызывает инструмент MCP-сервера, по тем же правилам, что и для агентов.

Блок «Инструмент» не может запустить другой сценарий; для этого есть блок «Сценарий».

СценарийCopy Anchor Link

Запускает другой сценарий рабочего пространства и отправляет то, что получил его блок «Результат».

Сценарии запускают друг друга на глубину не более 8. Секреты не передаются между сценариями как значения: сохраняйте их как переменные.

ЛюдиCopy Anchor Link

Блоки группы «Люди» приостанавливают запуск и о чём-то спрашивают вас. В приложении открывается лист; если запуск начал агент, вопрос уходит клиенту агента; в командной строке вопрос задаётся в терминале. У запусков, которые начинают расписания и вебхуки, спросить некого, поэтому блок группы «Люди» там завершается ошибкой, как и при echolot flow run --no-input.

СпроситьCopy Anchor Link

Запрашивает значения небольшой формой.

В листе есть Отменить и Продолжить. Ответы на поля secret скрыты в журнале запуска.

Показать и ждатьCopy Anchor Link

Показывает сообщение, код для копирования и ссылку для открытия, затем ждёт Продолжить или пока значение не придёт на until. Используйте для входа по коду устройства: показывайте код, пока блок «Опрос» ждёт одобрения.

Во всех пяти можно использовать шаблоны.

Если until связан, в листе написано Продолжится само, когда это будет сделано. Прекратить ожидание закрывает его и завершает блок ошибкой.

ОдобритьCopy Anchor Link

Просит вас одобрить, прежде чем сценарий пойдёт дальше, перед тем, что нельзя отменить.

Одобрение всегда остаётся за человеком. Когда агент запускает сценарий и отвечает на блок «Одобрить», Echolot сначала задаёт вопрос вам. В Place a test order блок «Одобрить» Keep the order? спрашивает Keep order {{body.id}} for CHF {{body.total.amount}}? о заказе, который магазин только что создал; Отклонить отправляет его в Cancel order.

ЛогикаCopy Anchor Link

ЕслиCopy Anchor Link

Отправляет то, что пришло, в true или false по условию.

Morning stock check использует блок «Если» Running low? с value.body.items.some(p => p.stock.bern < 5) для товаров, которые вернул магазин.

ВетвлениеCopy Anchor Link

Отправляет то, что пришло, в первый вариант, условие которого выполняется, иначе в default.

ВычислитьCopy Anchor Link

Выполняет JavaScript над тем, что пришло. Результат — последнее выражение: ({ id: value.body.id }) или a + b. Код с собственным return выполняется как тело функции, и результат — то, что вернул return. Promise ожидается. pm.test и pm.expect работают как в скриптах, а их результаты учитываются как тесты запуска. Строки console.log попадают в журнал запуска.

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

ЗадержкаCopy Anchor Link

Ждёт, затем передаёт значение дальше.

Порты: value на входе, value на выходе.

ЦиклыCopy Anchor Link

ПовторитьCopy Anchor Link

Отправляет index столько раз, сколько указано в Количество, считая с 0, затем done.

Для каждогоCopy Anchor Link

По очереди отправляет каждый элемент списка, затем done. Настроек нет.

СобратьCopy Anchor Link

Собирает в один список то, что приходит во время цикла, и отправляет его, когда цикл закончится. Настроек нет.

Каждый круг цикла заканчивается до начала следующего, а блоки, до которых он доходит, выполняются заново в каждом круге. Значения извне цикла, например вход из «Старта», доступны каждому кругу.

ОпросCopy Anchor Link

Отправляет сохранённый запрос снова и снова, пока не выполнится условие (вход одобрен, задача завершена) или не истечёт срок.

В отличие от «Запроса», ответ не 2xx не считается ошибкой «Опроса»: он отправляет снова, пока не выполнится Пока не.

ДанныеCopy Anchor Link

ЗначениеCopy Anchor Link

Постоянное значение: текст, число, true или false, список или объект.

ШаблонCopy Anchor Link

Текст, в котором {{name}} заполняется из пришедшего объекта и переменных запуска.

Порты: values на входе (объект), text на выходе.

ВыбратьCopy Anchor Link

Достаёт значения из пришедшего по пути, по одному выходу на каждое.

Пути — это общая часть JSONPath:

Задать переменнуюCopy Anchor Link

Сохраняет значения как переменные, чтобы последующие блоки и запросы читали их как {{name}}.

Если включён secret, значение попадает в связку ключей и никогда в файл, а в журнале запуска и в том, что видят агенты, оно скрыто с момента выхода из предыдущего блока. Если path ничего не находит, переменная сохраняет прежнее значение, поэтому ответ с токеном без нового токена обновления не стирает имеющийся. См. секреты.

Порты: value на входе, value на выходе (то, что пришло, передаётся дальше).

Получить переменнуюCopy Anchor Link

Читает переменную так, как её видят запросы: сначала собственные переменные запуска, затем окружения, рабочего пространства и глобальные.

РезультатCopy Anchor Link

ПоказатьCopy Anchor Link

Передаёт пришедшее дальше без изменений, чтобы вы могли на него посмотреть: выберите блок после запуска и прочитайте Последний запуск в инспекторе.

Порты: value на входе, value на выходе.

ЖурналCopy Anchor Link

Пишет строку в журнал запуска.

Порты: value на входе, value на выходе. В Place a test order блок Order failed записывает Create order answered {{status}}, когда заказ создать не удаётся.

ПроверитьCopy Anchor Link

Проверяет пришедшее. Каждая проверка — результат теста запуска, а непройденная проверка заставляет echolot flow run завершиться с ошибкой.

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

УведомитьCopy Anchor Link

Показывает уведомление macOS от Echolot. При первом разе macOS запрашивает разрешение. В командной строке уведомление вместо этого печатается.

Порты: value на входе, value на выходе. Morning stock check заканчивается блоком «Уведомить» Restock с заголовком Restock Bern.

Записать файлCopy Anchor Link

Записывает пришедшее в файл внутри папки рабочего пространства.

Уже существующий файл заменяется. Собственные файлы рабочего пространства трогать нельзя: папки requests, flows, environments, mocks, mcp-servers и specs, workspace.toml и скрытые файлы. Для CSV список объектов становится строкой на каждый объект со столбцом на каждый ключ; всё остальное записывается по одному значению в строке.

Значения между блокамиCopy Anchor Link

Значения — это JSON: текст, числа, true и false, списки, объекты или null.

Объект ответаCopy Anchor Link

«Запрос» и «Опрос» отправляют ответ как объект:

{
  "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 — разобранный JSON, если ответ в формате JSON, иначе текст, а если ответ пуст, то null.
• Имена заголовков в нижнем регистре. Заголовок, отправленный несколько раз, объединяется через , .
• time — весь обмен в миллисекундах.
• Тело больше 8 МБ приходит как null с "truncated": true. Полный ответ по-прежнему лежит в истории.

ШаблоныCopy Anchor Link

Настройки с пометкой «шаблоны разрешены» заполняют {{name}} из того, что пришло в блок:

• {{status}}, {{body.id}} или {{body.items[0].sku}}: ключ или путь в пришедшем объекте.
• {{value}} в «Журнале», «Уведомить» и «Записать файл»: всё пришедшее значение.
• Переменные, которые сохранил блок «Задать переменную» с областью run.

Имя, которое ни с чем не совпадает, остаётся как есть, так что собственные {{variables}} блока «Запрос» по-прежнему разрешаются из окружения при отправке. Объекты и списки записываются как текст JSON.

УсловияCopy Anchor Link

«Если», «Ветвление», «Опрос» и «Проверить» принимают выражение JavaScript, истинное или ложное. value — это то, что пришло; Пока не в «Опросе» читает его как response, что работает и везде.

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

Выражение, которое выбрасывает исключение, завершает блок ошибкой (в «Проверить» оно проваливает эту проверку).

ОграниченияCopy Anchor Link

Чтобы неверная связь не могла работать бесконечно, запуск останавливается после 10 000 выполнений блоков или через час. Запуски, которые начинают вебхуки, останавливаются через две минуты.