Google Developers Blog

Why client SDK generation belongs in the open

8.5内容质量

TL;DR · AI 摘要

Google开源SDK生成工具以降低平台风险，与Speakeasy合作实现多语言SDK生成的确定性和类型安全。

核心要点

  • 开源SDK生成工具可避免单点故障风险，如Google因供应商关闭导致的中断
  • Speakeasy工具链使Google维护成本降低至1人维护6个SDK目标
  • Antigravity AI代理加速SDK定制部分开发，提升生成效率

结构提纲

按章节快速跳转。

  1. §引言

    Google因供应商关闭事件推动SDK生成工具开源化

  2. ·SDK生成挑战

    多语言SDK生成需处理流协议、错误层次和类型联合等复杂问题

  3. ›开源解决方案

    与Speakeasy合作实现确定性生成和类型安全

  4. ·实施效果

    维护成本降低至1人维护6个SDK目标，集成Antigravity AI加速开发

思维导图

用一张图看清主题之间的关系。

查看大纲文本（无障碍 / 无 JS 友好）
  • SDK生成开源化
    • 背景与挑战
      • 供应商关闭风险
      • 多语言生成复杂性
    • 解决方案
      • Speakeasy开源工具链
      • Antigravity AI集成
    • 实施成果
      • 维护成本降低
      • 类型安全保障

金句 / Highlights

值得收藏与分享的关键句。

#OpenAPI#SDK生成#开源工具#AI代理
打开原文

为何客户端 SDK 生成应开源 - Google Developers Blog

Google Tag Manager (noscript)

结束 Google Tag Manager (noscript)

HTML

为何客户端 SDK 生成应开源

2026 年 9 月 17 日

Amir Hardon

高级软件工程师

Philipp Schmid

开发者关系工程师

分享

  • Facebook
  • Twitter
  • LinkedIn
  • 邮件

过去几个月，我们与 Speakeasy 密切合作，为我们的 Interactions、Agents 和 Webhooks API 推出了新的 Google GenAI SDK。今天，我们很激动地宣布，我们已与 Speakeasy 合作，将其 OpenAPI 代码生成套件开源。

code
from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="分析这个提交日志并查找回归问题。",
)

print(interaction.output_text)

Python

已复制

为何客户端生成需要开源工具

从快速演进的 OpenAPI 规范中生成多语言的、符合语言习惯的 SDK 是一项工程挑战。多年来，包括 Google 在内的前沿 AI 生态系统一直依赖专用工具来生成能够处理复杂流协议、严格错误层次结构和丰富类型联合的客户端库，而不会显得像是机器生成的。

2026 年 5 月，就在我们为 Google I/O 和 Interactions API 的通用可用性做准备时，我们使用的 SDK 生成提供商被收购，并突然宣布关闭。

这一突如其来的中断凸显了专有、闭源生成器带来的不可接受的平台风险。如果行业依赖 OpenAPI 来定义接口，那么将这些接口编译成客户端库、CLI 和代理工具的工具应该是开放的基础设施。

评估未来路径

在我们紧张的时间表内重新设计 SDK 流程时，我们的首要任务是最大限度地减少对开发者的干扰并避免破坏性变更。

我们与 Speakeasy 合作，就地迁移我们的客户端库，核心承诺是将生成器套件开源。这次迁移需要精心的工程：在所有目标语言中对类型定义进行对齐，保留严格的错误层次结构和流行为，并将生成器直接集成到我们内部的单体仓库和构建系统中。

在 Google DeepMind，虽然我们在开发工作流程中广泛使用 AI，但我们相信为堆栈的每一层选择合适的工具。将正式的 API 规范转换为多语言 SDK 需要确定性和严格的类型安全。通过 Speakeasy，我们在核心部分使用快速且确定性的生成器，并结合 Antigravity AI 代理加速 SDK 的定制部分。

以前维护手动编写的生成器需要多名工程师。如今，这种设置使我们能够用大约一名工程师维护人员，为六个目标（三个已发布的 SDK，更多即将推出）提供客户端流水线支持。

今日开源的内容

为了帮助确保更广泛的开发者生态系统能够访问高质量、良好维护的 SDK 生成工具，而无需面临类似中断的风险，Speakeasy 在 AGPLv3 许可证下开源了其完整的 OpenAPI 客户端套件。

  • 多语言 SDK 生成器：为 7 种语言（Python、TypeScript、Go、Java、C#、PHP、Ruby）生成客户端库。每个库都包含静态类型、服务器发送事件（SSE）流、重试和分页功能。
  • 原生代理 CLI 生成器：生成独立的 CLI 二进制文件。AI 编码代理可以直接从终端会话运行您的 API，无需编写临时的 HTTP 脚本。
  • 文档 MCP 服务器生成器：将您的 OpenAPI 规范和 Markdown 文档转换为模型上下文协议（MCP）服务器。像 Antigravity 这样的编码代理可以查询实时验证的模式，而不是猜测过时的方法。

该生成器采用 AGPLv3 许可证。这使您可以在开发或 CI 流水线中运行它，同时仍可完全拥有在您选择的许可证（如 MIT 或 Apache 2.0）下生成的代码/SDK 的所有权。如果您修改了生成器编译器本身，AGPL 保证这些改进将对社区保持开放。

立即体验

您现在可以使用我们更新后的 SDK 探索新的 Gemini 交互 API。如果您想生成自己的客户端库、CLI 或 MCP 服务器，可以在 GitHub 上找到 Speakeasy 生成器并将其应用于您的 OpenAPI 规范。

感谢阅读！继续构建吧。

posted in:

  • AI
  • 公告
  • 学习

上一篇

下一篇

相关文章

列表

AI

云

公告

学习

Agent 异常检测功能现已在 Gemini 企业代理平台的私有预览版中上线

2026 年 9 月 16 日

最佳实践

构建零信任 AI 代理：判断意图而非仅仅语法

2026 年 9 月 15 日

导航点 /