Адаптер Grok Build для Vercel AI SDK: как он работает

13 августа 2026 года адаптер Grok Build получил официальный путь к HarnessAgent в Vercel AI SDK 7. Теперь продукт может запускать Grok Build через тот же программный интерфейс, который Vercel предлагает для девяти поддерживаемых агентных сред разработки, — без пересборки слоя оркестрации под каждую из них.

Что представляет собой адаптер Grok Build

Речь о выпуске адаптера, а не о новой модели Grok.

Чтобы понять нововведение, достаточно разделить систему на уровни. Модель генерирует ответы. Агентная среда для работы с кодом превращает модель в исполнителя: управляет файлами, инструментами, сессиями и разрешениями, а также поддерживает цикл работы над задачей. Agent Client Protocol, или ACP, служит общим языком между клиентом и совместимой агентной средой. Адаптер переводит этот протокол в интерфейс, с которым уже умеет работать приложение.

Новый пакет Vercel называется @ai-sdk/harness-grok-build. Он соединяет HarnessAgent с CLI Grok Build по протоколу ACP, используя внутри более низкоуровневый пакет @ai-sdk/harness-acp.

Вся цепочка выглядит так:

Ваше приложение → HarnessAgent → адаптер Grok Build → CLI Grok Build внутри песочницы

Универсальный слой ACP — это инфраструктурная обвязка. Адаптер Grok Build — готовый коннектор, в котором уже заданы пакет, исполняемый файл, схема аутентификации, команда запуска и сопоставление инструментов. Механика самого протокола подробно разобрана в материале об адаптере ACP для агентных сред AI SDK. Здесь речь только о практическом подключении Grok Build.

До этого выпуска для добавления рантайма ACP приходилось самостоятельно описывать его профиль. После запуска 13 августа у Grok Build появился официальный адаптер и тот же сценарий работы с сессиями HarnessAgent, что у Claude Code, Codex, Deep Agents, OpenCode и Pi. На тот момент список включал шесть агентных сред.

С 31 августа 2026 года добавление fx в Vercel расширило список до девяти агентных сред: Claude Code, Cline, Codex, Cursor, Deep Agents, fx, Grok Build, OpenCode и Pi. Адаптер fx пополнил каталог, но не изменил работу адаптера Grok Build.

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

Почему это важно

Главное изменение — объём интеграционной работы.

Методы HarnessAgent.generate() и HarnessAgent.stream() возвращают результаты, совместимые с AI SDK. Если в продукте уже есть чат или интерфейс задач на базе AI SDK, Grok Build можно встроить в существующий поток результатов. Серверная агентная среда поменяется, а пользовательскому интерфейсу не понадобится новый формат ответа только из-за смены исполнителя.

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

Этот выпуск не делает Grok Build быстрее, дешевле или точнее. Он лишь добавляет поддерживаемое подключение. Пользователям, которые работают с Grok Build только через его собственный CLI, адаптер тоже ничего не даёт. Решение предназначено для тех, кто строит продукт или внутреннюю систему вокруг ИИ-агентов для программирования.

Кому пригодится новый адаптер

Основателю продукта для разработчиков, которому нужен ещё один рантайм

Допустим, вы развиваете продукт на AI SDK для ревью кода с помощью ИИ или исправления репозиториев. Grok Build можно добавить как ещё одну серверную агентную среду, не создавая для неё отдельные API сессий и протокол потоковой передачи.

Практическое изменение невелико: установить адаптер, подключить песочницу того же типа и выбирать Grok Build для подходящего клиента или задачи. В результате появляется ещё один рантайм — без отдельного продуктового контура, который пришлось бы поддерживать.

Платформенному инженеру, который сравнивает девять агентных сред

Платформенная команда может поручить одну и ту же ограниченную задачу в репозитории Grok Build и другой поддерживаемой среде, а затем сравнить качество выполнения и характер сбоев в рамках общего прикладного сценария.

Важно сохранить корректные условия сравнения. ACP версии 1 не всегда передаёт данные об использовании ресурсов на каждом шаге, поэтому адаптер не позволит точно сопоставить расход токенов шаг за шагом, если Grok не вернёт итоговые значения. Сравнивать результаты и сквозное поведение можно. Полагаться на одинаковую полноту всех полей наблюдаемости — нельзя.

Команде внутренних инструментов, которая исправляет репозитории

Команда внутренних инструментов может отправить задачу по исправлению упавших тестов в изолированное рабочее пространство, транслировать текст агента оператору и уничтожить сессию после завершения работы. Граница песочницы защищает хост, а явно заданный жизненный цикл не позволяет временным сессиям превратиться в забытую инфраструктуру.

Главное преимущество здесь — операционный контроль. Агент, изменяющий код, работает в ограниченной среде, а приложение определяет, когда эта среда создаётся и уничтожается.

Специалисту по безопасности или надёжности, который оценивает запуск

Ему предстоит принять вполне конкретное решение. Для прямой аутентификации используется XAI_API_KEY, а для аутентификации через AI Gateway — учётные данные Gateway. Режим auto по умолчанию выбирает AI Gateway, если такие данные доступны, и прямую аутентификацию xAI в остальных случаях.

Разрешения также нужно проверять на реальной границе инструментов. Grok Build не объявляет режимы сессий ACP, а часть безопасной встроенной работы может выполняться без запроса разрешения ACP. Политика, составленная для другой агентной среды, ещё не доказывает, что Grok Build будет вести себя так же.

Как запустить рекомендованную конфигурацию

Самый короткий полноценный вариант использует Vercel Sandbox и стандартные настройки адаптера.

1. 1

   Установите пакеты

   Добавьте общий API агентных сред, адаптер Grok Build и реализацию Vercel Sandbox:

   pnpm add @ai-sdk/harness @ai-sdk/harness-grok-build @ai-sdk/sandbox-vercel

2. 2

   Передайте учётные данные песочницы и модели

   Для описанного варианта с Vercel Sandbox сделайте доступным VERCEL_OIDC_TOKEN. Для прямой аутентификации Grok передайте XAI_API_KEY. При работе через Gateway понадобятся соответствующие учётные данные AI Gateway; переменная AI_GATEWAY_BASE_URL позволяет переопределить базовый URL, когда это требуется. Стандартный режим адаптера auth: 'auto' выберет доступный маршрут.

3. 3

   Создайте сессию, выполните задачу и уничтожьте сессию

   Используйте актуальный пример агентной среды Grok Build:

   import { HarnessAgent } from '@ai-sdk/harness/agent';
   import { grokBuild } from '@ai-sdk/harness-grok-build';
   import { createVercelSandbox } from '@ai-sdk/sandbox-vercel';
   
   const agent = new HarnessAgent({
     harness: grokBuild,
     model: 'grok-build-0.1',
     sandbox: createVercelSandbox({
       runtime: 'node24',
       ports: [4000],
     }),
   });
   
   const session = await agent.createSession();
   
   let exitCode = 0;
   try {
     const result = await agent.stream({
       session,
       prompt: 'Check the test failures and fix the production code.',
     });
   
     for await (const part of result.stream) {
       if (part.type === 'text-delta') {
         process.stdout.write(part.text);
       }
     }
   } catch (err) {
     exitCode = 1;
     console.error(err);
   } finally {
     await session.destroy();
     process.exit(exitCode);
   }

4. 4

   Учтите сетевую установку при первой сессии

   Для первой сессии нужен исходящий доступ в сеть: агентная среда ACP устанавливает закреплённую версию пакета @xai-official/grok@1.0.5 внутри песочницы. Если исходящие соединения запрещены, процесс завершится сбоем ещё до того, как агент приступит к полезной работе.

Деталь, которую легко упустить, — порт. Grok Build нужна сетевая песочница как минимум с одним открытым портом для моста ACP. В примере используются Node 24 и порт 4000. Объект песочницы без такого сетевого маршрута не является равноценной конфигурацией.

В текущем примере значение model: 'grok-build-0.1' передаётся в HarnessAgent. Если требуется управление на уровне адаптера, замените grokBuild на createGrokBuild(). Тогда можно выбрать способ аутентификации, передачу учётных данных, глубину рассуждений, серверы MCP, порт моста, тайм-аут запуска или собственную функцию для токена моста. Если не указать reasoningEffort, Grok Build использует настроенное значение по умолчанию.

Ограничения, о которых важно знать

Адаптер наследует ограничения ACP версии 1, и в рабочей среде их нельзя игнорировать.

• Данные об использовании неполны. ACP не раскрывает границы шагов модели и расход ресурсов по каждому шагу. Адаптер определяет границы косвенно и помечает расход как неизвестный, если Grok не передаёт итоговые значения.
• Управлять уже запущенным ходом единообразным способом нельзя. В ACP нет общего API для вмешательства в середине хода или ручного сжатия контекста.
• Фильтрация встроенных инструментов ограничена. Инструменты хоста фильтровать можно, но попытка отфильтровать встроенные инструменты Grok вызывает ошибку неподдерживаемой возможности.
• Каталог инструментов может устареть. Когда список инструментов хоста меняется, Grok Build должен обновить свой список ACP MCP. Если он продолжит использовать старый список, ход завершится явной ошибкой.

Есть и риск, связанный с управлением релизами. Пакеты агентных сред AI SDK имеют статус экспериментальных, поэтому между версиями возможны несовместимые изменения. Адаптер Grok закрепляет версию CLI и команду запуска ACP внутри пакета, а createGrokBuild() не позволяет их переопределить. Поддерживаемый сценарий благодаря этому проще, но момент обновления закреплённого рантайма определяет сам пакет адаптера.

По умолчанию для моста используется случайный 32-байтовый токен. Если заменить функцию его генерации, она должна возвращать действительно секретное значение. Это средство защиты, а не удобное место для понятной строки, используемой при разработке.

Наконец, этот выпуск не меняет ценообразование. Выбранный способ аутентификации Grok и сетевая песочница по-прежнему связаны с собственными эксплуатационными расходами. Адаптер сокращает объём нестандартной интеграции, но не устраняет необходимую инфраструктуру.

Что делать дальше

Приступайте уже на этой неделе, если используете AI SDK 7 и хотите сделать Grok Build одним из доступных рантаймов для программирования. Начните с ограниченной задачи в репозитории, оставьте стандартный адаптер, проверьте успешный сценарий и обработку сбоя, а также убедитесь, что сессия корректно очищается.

Если продукт должен работать с несколькими агентными средами, перед запуском в рабочей среде проведите короткую оценку. Сравните результаты задач, поведение разрешений, восстановление после сбоев и полную стоимость выполнения. Не выбирайте победителя по расходу ресурсов на отдельных шагах: ACP может не передать эти данные.

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

Изменение вас не затрагивает, если вы работаете с Grok Build напрямую, вызываете модели Grok без агентной среды для программирования или не разрабатываете приложение, которому нужно переключаться между агентными рантаймами.

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