21 октября 2026 года Cloudflare представила функцию createAI в Agents SDK. Она объединяет возможности workers-ai-provider и ai-gateway-provider: работу с Workers AI, каталогом AI Gateway, динамическими маршрутами и моделями поставщиков. На Mentoring.digital объясняем, как оценить переход без предположения, что достаточно заменить имя импорта.
Что происходит со старыми пакетами
Оба прежних пакета объявлены устаревшими, развитие их возможностей заморожено. Анонс предлагает перейти в удобное время. Это не сообщение о том, что все существующие интеграции немедленно перестали работать. Сначала выясните, какой пакет и какой его интерфейс использует конкретный проект.
В примере для AI SDK createAI импортируется из agents/models/ai-sdk. Для подключения можно использовать binding AI либо идентификатор аккаунта и API token. В таблице миграции прежнему параметру apiKey соответствует apiToken. Эти сведения описывают новый интерфейс, но не подтверждают достаточность прав любого уже выпущенного токена.
Сопоставьте не только название модели
Редакционный план: выпишите используемые модели, выбранный gateway, параметры запроса и ожидания к ответу. Отдельно обозначьте резервный маршрут при отказе. Сходный текст ответа в одном запросе ещё не подтверждает правильность маршрутизации, журналирования и обработки ошибки.
createAI поддерживает настройки gateway, fallback и BYOK. Для потоков через binding заявлено возобновление при обрыве ответа для маршрутов каталога и dynamic. Не переносите это утверждение автоматически на любой способ обращения к любой модели: проверяйте условия конкретного пути.
AI Search переносится отдельно
Функция createAISearch из workers-ai-provider не превращается в createAI. В анонсе для неё указан отдельный пакет ai-search-provider и createAISearchNamespace. Если проект использует одновременно генерацию и поиск, это две части проверки, а не одна механическая замена.
Для безопасного пробного перехода используйте разрешённый тестовый запрос без конфиденциальных данных. Сравните обычный ответ, поток и отказ; сохраните версию пакета и фактически применённую конфигурацию. Не записывайте настоящий токен в пример или отчёт.
С разбором JavaScript-интеграции поможет наставник по JavaScript. Редакция изучила первичный анонс и документацию, но не запускала миграцию приложений читателей и не заявляет собственных результатов тестирования.
