Vercel Agent в проде: расследование, потом один план на доступ

Редакция 23 октября 2026 г.

Агент на read-only scopes изучает деплой, затем человек одобряет план с write-доступом к deployment.

Vercel Agent строит доступ к продакшену через планы: агент сначала разбирается с проблемой на read-only baseline, показывает, что собирается сделать и какие scopes попросит, и только после одного approve получает права на изменения — без «открой всю команду» и без approve на каждый вызов API.

Как устроен план

На примере упавшего deployment агент смотрит недавние релизы и build logs, сравнивает сломанный билд с последним рабочим — это укладывается в read:deployment. Если вывод — redeploy, следующий блок работ запрашивает read-write:deployment. Короткий read-only lookup может идти без плана; длинное расследование оформляется отдельным read-only планом, чтобы видеть задачи и прогресс.

В плане связаны четыре вещи: запрос пользователя, предложенные шаги, нужные scopes из реестра Vercel и проверка токена на каждом API-вызове. Baseline read-only сейчас включает все зарегистрированные scopes с префиксом read:; всё шире baseline или внешние действия вроде GitHub pull request ждут approve целиком.

Токены, resume и границы

Agent работает как авторизованное Vercel App и не может получить больше прав, чем у человека в команде — даже после согласия плана. OAuth выдаёт короткоживущий токен: baseline плюс одобренные дополнительные scopes. Право на deployment шире одного redeploy: имя деплоя в тексте плана само по себе токен не сужает; runtime перед работой проверяет, что план active, и только тогда подставляет credential.

Один план может смешивать правки в Vercel и открытие PR в GitHub — пользователь видит всё разом, у каждого провайдера свой credential. Approve на PR в acme/storefront не переносится на acme/payments. Списки прав Agent подтягивает из scope registry (с кешем): невалидный или устаревший scope отсекается до показа плана, а не расширяется «на всякий случай».

Approve может прийти после закрытия чата — stored plan хранит задачи, scopes и кто согласовал; при resume runtime снова грузит план и откажет stopped-плану, даже если токен ещё не истёк. Замена плана с повышенными правами требует нового review. Scopes режут blast radius операций, но рядом остаются sandbox, сетевая политика, секреты, rate limits и audit logs — разрешённый redeploy всё равно может уехать с неудачным коммитом, если человек не оценил предложенный фикс.

Источник: How Vercel Agent accesses production safely.