28 октября 2026 г.

Cloudflare Computer: как агент продолжает работу после сбоя и ждёт одобрения

Андрей Присекин
Автор

Андрей Присекин

Создаю AI-агентов, автоматизирую бизнес-процессы

Cloudflare Computer умеет восстановить прерванный запуск JavaScript-агента и остановить его перед действием, пока человек не ответит. Для агента, который ждёт разрешения на отправку сообщения или изменение данных, это полезнее обычной кнопки «повторить». Но безопасный повтор не возникает сам: незавершённый внешний вызов может исполниться дважды. Начинать стоит на тестовом окружении, без платежей и боевых ключей.

Меня в анонсе Cloudflare от 26 октября зацепило именно это различие. Когда кодовый агент падает между «отправил запрос» и «записал результат», кнопка повтора может отправить тот же запрос ещё раз. Если речь о черновике отчёта, неприятно. Если об оплате, уже другой разговор. Разберём, что сохраняет Computer, что оставляет разработчику и какой тест я бы устроил до внедрения.

Что именно вышло

Cloudflare Computer - набор для работы агента с файлами и исполняемым кодом в Cloudflare Workers. Рабочая область хранит файлы в Durable Object, то есть состояние не обязано жить только в памяти текущего вызова. JavaScript-бэкенд запускает отдельный Dynamic Worker и позволяет дать исполняемому коду заранее описанные функции приложения. Это не полноценный Linux-компьютер и не новая универсальная модель ИИ: модель выбирает действия, а Computer предоставляет ей рабочую среду.

Октябрьский changelog Computer посвящён двум конкретным возможностям: восстановлению прерванного запуска и ожиданию ответа снаружи. В примере агент может предложить оставить комментарий в GitHub, а твой сервер останавливает исполнение до решения человека. Сама модель не назначает себе разрешение. Ты пишешь функцию, которая требует одобрения, и приложение решает, кому показать запрос.

Код агента проходит проверку человеком перед внешним действием

Новость не означает, что любой уже развёрнутый агент Cloudflare автоматически стал отказоустойчивым. В документации JavaScript-бэкенда режим при прерывании по умолчанию называется fail: запуск завершается ошибкой. Восстановление надо включить явно для бэкенда либо отдельного исполнения. Это правильная осторожность. Тихо включать повтор для системы, которая пишет наружу, я бы тоже не стал.

Как работает восстановление запуска

Представь рабочую задачу: прочитать данные, составить ответ, получить разрешение и оставить комментарий. Обычный процесс держит промежуточные переменные в памяти. Перезапустили Durable Object или выкатили новую версию - прежний JavaScript больше не исполняется. При включённом onInterrupt: "replay" Computer записывает результаты уже завершённых вызовов и при восстановлении начинает JavaScript заново. Когда код доходит до прежних завершённых операций, он получает сохранённые результаты. Ранее выведенный текст повторно не печатается. Механизм описан в официальном changelog.

Звучит похоже на перемотку видеозаписи, но сравнение неполное. Повторяется код, а не физическое время. Такой запуск должен пройти тот же путь и сделать совместимые вызовы. В списке ограничений Computer прямо сказано: при несовпадении вызовов или вывода восстановление провалится; некоторые источники случайности и способы работы с сетью не воспроизводятся. Состояние файла и ответы вызовов сохраняются, но произвольный участок кода между ними не получает волшебной защиты от любого побочного действия.

Важная тонкость: рестарт Durable Object сам по себе не запускает восстановление немедленно. Согласно инструкции Cloudflare, оно начнётся при следующем обращении к workspace.runtime. Если нужно поднять прерванные задачи без нового пользовательского запроса, вызови recover() из alarm самого Durable Object. Я бы проверил это отдельно: остановил тестовый запуск, убедился, что он не проснулся «магически», и только потом добавлял сигнал будильника. Особенно если задача должна закончиться ночью без человека у экрана.

Где повтор превращается в двойное действие

Вот главный подвох. Сервис успел принять вызов «опубликовать комментарий», но наш процесс прервался до записи ответа. В журнале нет результата, поэтому при восстановлении Computer может повторить незавершённый вызов. На стороне GitHub первая операция уже могла состояться. В разделе про невоспроизводимые вызовы Cloudflare говорит это без мелкого шрифта: незавершённая операция может исполниться снова даже после успешного внешнего действия.

Как лечить? Для каждого вызова модуля Computer предоставляет callId, который сохраняется при повторе. Если внешняя система поддерживает ключ идемпотентности, передавай туда этот идентификатор. Тогда два обращения с одним ключом означают одну логическую операцию - при условии, что сам внешний сервис действительно реализует такую гарантию. Если ключа нет, Computer предлагает обернуть действие в unsafeToRepeat(): при прерывании этого вызова запуск упадёт вместо автоматического повторения. Отказ с ручной сверкой уже сделанного действия лучше двух списаний.

Прерванный запрос может вызвать повтор; ключ идемпотентности отличает повтор от нового действия

Я бы проверял это на подставном модуле: он записывает событие в отдельный тестовый журнал, а затем намеренно не возвращает результат. После перезапуска смотришь журнал и число вызовов. Так виден риск повтора без списания денег или отправки реального письма. Это предложение по тесту, не заявление о прогнанном мной Cloudflare-стенде. В моём окружении публикации нет тестового Durable Object и ключей для его развёртывания.

Как добавить ожидание одобрения

Встроенный пример Cloudflare для approvals регистрирует модуль приложения с функцией публикации комментария. Внутри функция сначала вызывает ctx.interrupt() с данными будущего действия. Запуск ставится на паузу. Приложение может получить список ожиданий через workspace.runtime.pending() и передать выбранному вызову решение через respond(). При отказе функция не отправляет комментарий. При согласии продолжает выполнение, используя тот же ключ операции.

Здесь легко ошибиться с границей ответственности. Computer хранит ожидание, но не знает, кто у тебя вправе разрешать действия. Личность согласующего, просмотр текста перед отправкой, защита интерфейса и журнал решений - задача приложения. Я бы выводил человеку адрес получателя и полный текст, а не кнопку «Разрешить» без деталей. И разделил бы права: прочитать задачу агенту можно, отправить письмо клиенту - только после отдельного решения.

Время ожидания ответа не засчитывается в таймаут запуска, и по анонсу пауза переживает деплой. Но это не бесконечное право на выполнение: у Computer есть ограничения на журнал, время самой работы и совместимость между версиями. При смене пакета и параметров окружения прерванная задача может не восстановиться. Держи маршрут «отказать или перепроверить вручную», особенно для старых заявок. Не делай из зависшего одобрения безымянную задачу, которую уже никто не помнит.

Как попробовать без боевых данных

Документация Cloudflare и README проекта дают отправную точку: в существующем Worker-проекте установить пакет:

npm install @cloudflare/computer

После установки добавить binding Worker Loader и флаг nodejs_compat. Затем создать Workspace со storage Durable Object и WorkerJavaScriptBackend. Для первого опыта настрой вызов только локальной тестовой функции, без доступа к платежам и личным данным. Полный конфиг binding лучше брать из документации под конкретную дату совместимости Worker: выдранный из чужого репозитория пример быстро устареет.

Я бы провёл три небольшие проверки. Сначала прочитал тестовый файл и убедился, что обычный запуск работает. Потом включил onInterrupt: "replay", прервал задачу и проверил, возвращаются ли сохранённые результаты. Наконец добавил модуль с ctx.interrupt() и прокликал отказ и согласие. Только после этого подключал бы реальный API и заранее отвечал на вопрос: как он узнаёт, что вызов уже был выполнен? У Cloudflare пример с комментариями в GitHub, но это пример интерфейса, не обещание, что твой биллинг или CRM поймут callId.

О бюджете тоже без чудес. Сам пакет можно установить как зависимость, но рабочая система использует Worker, Durable Object, хранилище журнала и вызовы модели, которую ты подключишь отдельно. Длинное ожидание не тратит вычислительное время так же, как постоянно работающий процесс, однако записи, запросы и внешние сервисы никуда не исчезают. Я не нашёл в релизе тарифа «готовый агент за фиксированную сумму» и не стал бы его придумывать. Для оценки сначала посчитай число задач, обращений и объём сохранённых ответов на своём примере.

Когда это пригодится, а когда выбрать другой слой

Для агента, который читает рабочие файлы, вызывает функции твоего приложения и иногда ждёт человека, новый режим Computer выглядит логичным. Но Cloudflare помечает восстановление и ожидание экспериментальными: формат сохранённых данных и поведение могут измениться, а задачи могут не пережить обновление. Поэтому я бы не ставил это без отдельного теста на критический поток платежей или отправку большого тиража писем.

Сама задача «подождать человека» уже решалась и без Computer. У Cloudflare Workflows есть step.waitForEvent для ожидания события; AWS Step Functions умеет ждать callback token. А Temporal отдельно описывает replay кода и Activities для внешних API-вызовов. Разница здесь не в изобретении согласования, а в том, что ожидание и восстановление теперь доступны внутри рабочего JavaScript-окружения Computer. Выбор зависит от того, где уже живёт твоя логика, какой журнал действий нужен и как обрабатывается незавершённый внешний запрос.

Если агент только вызывает предсказуемую последовательность API, обычный workflow может оказаться проще. Если ему нужна рабочая область с файлами и запускаемым кодом, Computer заслуживает теста. В обоих случаях один и тот же вопрос остаётся открытым до твоей проверки: что произойдёт, если сеть оборвётся после действия, но до подтверждения результата? Начни с этого сценария. Красивый happy path потом успеешь показать на демо.

Источники

← Все статьи