Vercel AI SDK: agent harness теперь поддерживает нативные подписки

14 сентября 2026 года Vercel обновила AI SDK harness layer: теперь слой для запуска coding agents через единый интерфейс может использовать их собственные нативные подписки, если конкретный harness поддерживает такой способ входа.

На практике это означает, что для ряда агентных инструментов разработчику больше не обязательно отдельно прокидывать provider API credentials только ради запуска harness. При этом сама архитектура остаётся контролируемой: реальные учётные данные разрешаются на стороне host и не должны без необходимости попадать внутрь sandbox.

Что именно изменилось

Harness layer в AI SDK позволяет запускать разные coding agents через единый интерфейс HarnessAgent. Идея в том, что приложение работает с общей абстракцией, а конкретный агент можно менять без переписывания основной логики приложения.

После обновления этот слой умеет использовать native subscription authentication там, где сам agent harness поддерживает вход через подписку. Vercel отдельно подчёркивает, что для включения новой возможности не требуется менять код или добавлять новые настройки.

Как работает режим direct

В режиме direct AI SDK сначала использует явные credentials провайдера из окружения, если они настроены. Если таких credentials нет, harness layer может использовать нативную подписку, найденную на host.

То есть существующие конфигурации с API keys не ломаются и не меняют поведение неожиданно. Подписка становится дополнительным способом авторизации, когда явных provider credentials нет.

Что происходит в режиме auto

Режим auto ведёт себя похожим образом, если не настроены credentials для AI Gateway. В этом случае система также может использовать provider credentials из окружения либо нативную подписку на host.

Это удобно для локальной разработки и agent environments, где разработчик уже авторизован в используемом coding agent и не хочет создавать ещё один набор секретов только для harness layer.

Режим ai-gateway не использует нативные подписки

Для ai-gateway поведение намеренно другое. По информации Vercel, этот режим никогда не читает нативные подписки.

Это важное разделение. Если инфраструктура проекта построена вокруг AI Gateway, авторизация остаётся в рамках gateway-модели и не начинает автоматически подхватывать локальные subscription credentials.

Где хранятся credentials

Одна из ключевых деталей обновления связана с безопасностью. Нативные subscription credentials остаются на host. Как и в случае с API keys, разрешение credentials происходит на границе host environment.

OAuth access tokens при необходимости обновляются там же. Если используемый sandbox поддерживает соответствующий механизм, внутрь harness можно передать placeholder credentials, а настоящий token будет подставлен в исходящий запрос уже на host.

Такой подход уменьшает необходимость передавать реальные секреты в среду, где агент выполняет код.

Какие agent harnesses поддерживаются

Vercel указывает, что native subscription credentials работают через harness adapters в тех случаях, когда сам harness поддерживает subscription login. В опубликованном списке перечислены:

• Claude Code;
• Cline;
• Codex;
• Cursor;
• fx;
• GitHub Copilot;
• Grok Build;
• OpenCode;
• Pi.

Важно понимать формулировку правильно: AI SDK не создаёт собственную подписку для этих сервисов. Он использует уже доступный на host способ авторизации, если конкретный harness умеет с ним работать.

Почему единый HarnessAgent полезен

Главная ценность harness layer не только в авторизации. Он создаёт общий программный интерфейс поверх разных agent harnesses. Это позволяет архитектуре приложения меньше зависеть от конкретного coding agent.

Например, команда может тестировать разные harnesses для одного workflow, не переписывая всю бизнес-логику вокруг каждого инструмента. Авторизация через native subscriptions делает такой сценарий удобнее в средах, где разработчики уже используют соответствующие подписки.

Что это меняет для локальной разработки

Для локального agent workflow обновление сокращает количество дублирующихся credentials. Если разработчик уже вошёл в поддерживаемый coding agent через его штатную подписку, harness layer может использовать эту авторизацию вместо требования ещё одного provider key.

При этом приоритет явных environment credentials сохраняется. Поэтому production и CI/CD окружения можно продолжать строить на контролируемых секретах, не полагаясь на пользовательскую локальную сессию.

Что это меняет для sandbox

Agent harness часто запускает команды и код в изолированной среде. Передавать туда настоящий OAuth token или API key без необходимости нежелательно.

Описанная Vercel схема позволяет держать реальный credential на host boundary и, если sandbox это поддерживает, использовать placeholder внутри изолированной среды. Настоящий token подставляется только при outbound request.

Это не отменяет обычные требования к безопасности agent systems, но делает границу между execution environment и credential storage более явной.

Когда лучше использовать API credentials

Native subscription authentication не означает, что API keys больше не нужны. Для серверных production-систем, CI/CD, общих командных окружений и инфраструктуры с централизованным биллингом явные service credentials часто остаются более предсказуемым вариантом.

Новая возможность особенно полезна там, где harness запускается на машине или host environment пользователя, уже имеющего штатную подписку соответствующего coding agent.

Что стоит проверить перед использованием

Главное

Обновление AI SDK harness layer делает работу с coding agents гибче: один HarnessAgent может использовать штатную subscription authentication разных harnesses без изменения прикладного кода, когда такая авторизация поддерживается.

При этом Vercel сохранила важное разделение режимов. direct и при определённых условиях auto могут использовать нативную подписку, а ai-gateway её не читает. Реальные credentials остаются на host boundary, а OAuth tokens обновляются там же.

Исходный англоязычный материал

Эта статья является русской адаптацией официального материала Vercel от 14 сентября 2026 года AI SDK harness layer now supports native subscription authentication. Факты и поведение режимов авторизации сохранены по оригинальному источнику.

Если вы проектируете AI-автоматизацию, agent workflow или интеграцию через API и нужно выбрать безопасную схему запуска и хранения credentials, можно описать задачу A.S Groups. Сначала разберём архитектуру и только потом выберем подходящий стек.