17 СЕНТ. 2026

За последние несколько месяцев мы тесно сотрудничали со Speakeasy для выпуска новых SDK Google GenAI для наших API Interactions, Agents и Webhooks. Сегодня мы рады объявить о партнерстве со Speakeasy, в рамках которого их пакет генерации кода OpenAPI переходит в статус open-source.

Python

Скопировано

Почему для клиентской генерации нужны открытые инструменты

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

В мае 2026 года, как раз перед началом конференции Google I/O и запуском общего доступа к Interactions API, используемый нами поставщик генерации SDK был приобретен другой компанией, которая неожиданно объявила о прекращении его работы.

Этот внезапный сбой показал, что проприетарные генераторы с закрытым исходным кодом создают неприемлемые риски для платформы. Если индустрия полагается на OpenAPI при определении интерфейсов, то инструменты для компиляции этих интерфейсов в клиентские библиотеки, интерфейсы командной строки (CLI) и инструменты для агентов должны представлять собой открытую инфраструктуру.

Оценка дальнейших шагов

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

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

В Google DeepMind мы используем искусственный интеллект в процессах разработки, но при этом верим в необходимость выбора правильного инструмента для каждого уровня стека. Преобразование формальных спецификаций API в многоязычные SDK требует детерминизма и строгой типизации. Совместно со Speakeasy мы объединяем быстрый детерминированный генератор в ядре и ИИ-агенты Antigravity, ускоряющие создание кастомных частей SDK.

Поддержка создававшихся ранее вручную генераторов раньше требовала усилий нескольких инженеров. Сегодня эта архитектура обслуживает наш конвейер клиентов для шести целевых платформ (три выпущенных SDK и еще несколько готовятся к выходу) силами примерно одного поддерживающего инженера.

Что открывается сегодня

Чтобы гарантировать разработчикам доступ к высококачественным и поддерживаемым инструментам генерации SDK без риска столкнуться с подобными сбоями в будущем, Speakeasy открывает исходный код всего своего клиентского пакета OpenAPI под лицензией AGPLv3.

Многоязычные генераторы SDK: генерируют клиентские библиотеки для 7 языков (Python, TypeScript, Go, Java, C#, PHP, Ruby). Каждая библиотека включает статическую типизацию, потоковую передачу Server-Sent Events (SSE), повторные попытки и пагинацию.

Агентно-ориентированный генератор CLI: компилирует автономные бинарные файлы CLI. ИИ-агенты для написания кода могут напрямую взаимодействовать с вашим API из терминала без необходимости создавать временные HTTP-скрипты.

Генератор MCP-сервера документации: превращает спецификации OpenAPI и документацию в формате Markdown в сервер протокола Model Context Protocol (MCP). Код-агенты, такие как Antigravity, могут запрашивать актуальные, проверенные схемы вместо того, чтобы угадывать устаревшие методы.

Генератор лицензируется под AGPLv3. Это позволяет запускать его в вашей среде разработки или CI-конвейере, сохраняя при этом полные права собственности на сгенерированный код/SDK под выбранной вами лицензией (например, MIT или Apache 2.0). Если вы измените сам компилятор генератора, лицензия AGPL гарантирует, останутся ли эти улучшения открытыми для сообщества.

Попробуйте в деле

Вы можете протестировать новый API Gemini Interactions уже сегодня с помощью наших обновленных SDK. Если вы хотите сгенерировать собственные клиентские библиотеки, интерфейсы командной строки или MCP-серверы, вы найдете генератор Speakeasy на GitHub и сможете запустить его для своих спецификаций OpenAPI.

Спасибо за чтение! Продолжайте создавать.

Вперед