Workflow SDK 5: durable workflow без минутной очереди между шагами агента

За год клиенты Vercel прогнали через Workflow SDK больше 4 млрд шагов и 700 млн запусков — и пятая версия перестроила рантайм под дорогие агентные петли, а не только фоновые автоматизации. В четвёртой версии на каждый шаг уходило два прохода через очередь; в пятой несколько шагов могут выполниться подряд без лишнего сетевого круга, пока сценарий не упирается в ожидание, hook или таймаут.

Шифрование журнала событий

Event log хранит аргументы шагов, ответы, payload хуков и stream data, чтобы run пережил деплой или падение. Workflow SDK 5 шифрует каждый payload до выхода из вашего кода: AES-256-GCM и отдельный ключ на run — бэкенд видит только шифротекст.

На Vercel ключ выводится из deployment scope, без правок workflow-кода; расшифровка в dashboard или CLI идёт локально, с теми же правами, что у переменных окружения. На self-hosted Worlds ключ задаётся через getEncryptionKeyForRun() — один 32-байтовый ключ на все вызовы replay. Запись в чужой run шифруется публичным ключом целевого run; с experimental_retention: 0 inputs, outputs и stream удаляются сразу после завершения или fail, в observability остаются метаданные. Атрибуты run для поиска (order ID и т.п.) — открытым текстом, секреты туда не кладут.

Регион и отказоустойчивость

В версии 4 весь state жил в iad1, даже если функция крутилась в другом регионе — каждый шаг тянул прогресс через межрегиональные запросы. В пятой инфраструктура Workflow развёрнута во всех регионах Vercel Functions: run привязан к региону старта, очередь и streams обслуживаются локально. Регион можно переопределить в start(), если workflow должен жить рядом с БД. Старые v4 run остаются в iad1; при failover шаги могут уехать в запасной регион, но state не мигрирует.

Скорость агентных циклов

На замеренных workload Vercel даёт от 1,6× до 25× по latency и overhead (v5.2.0 против v4.8.12, 8 октября 2026, production iad1). Отдельно инкрементальный replay — больше не разбирает весь event log на каждом шаге; на Vercel World v5.2.0 по умолчанию пишет streams через WebSocket, чтобы durable-ответ не отставал от продюсера.

• между шагами, p75: 618 ms → 109 ms (5,7×);
• поздний overhead на длинном run, p75: 1 748 ms → 70 ms (25×);
• 1 020 шагов, медиана: 21,0 мин → 3,0 мин (7×);
• доставка stream 52,4 с агентного ответа, медиана: 226,1 с → 53,5 с;
• сжатие AI token stream — примерно на 80% меньше объёма в хранилище.

Общий примитив Worlds — storage, queue, streaming — тянет и чистый Workflow SDK (use workflow / use step), и агентные обвязки: WorkflowAgent в @ai-sdk/workflow, fx и durable-harness под Pi и OpenCode, beta Python SDK с теми же steps, sleeps и hooks. В v5 добавили отмену в полёте через AbortController, поиск по run attributes и trace viewer со span search и minimap.

Источник: Workflow SDK 5: built for production.