Google给AI开了个“官方文档接口”

10月7日，Google发布了Developer Knowledge API生态，一个文档网站，把Google Cloud、Firebase、Android的官方文档做成了可以程序化调用的API。

AI不用再抓网页了，直接像查数据库一样查官方文档。

这东西到底是什么

Developer Knowledge API是Google官方的、程序化访问的开发者文档权威来源。

几个关键点帮你快速理解：

• 它返回的不是HTML网页，而是结构化的Markdown格式文档，AI拿来就能用，不用再做网页解析

• 覆盖Google Cloud、Firebase、Android三大平台的开发者文档

• 支持语义搜索和关键词搜索，不是只能精确匹配

• 有智能文档分块，先返回相关片段，需要时再取全文，省token

• 提供有依据的问答能力，答案带引用来源，减少瞎编

• 频繁建立索引，上游文档更新后能快速同步，不会拿半年前的内容回答你

说白了，Google把自己的文档包装成了"给AI调的接口"。

四个入口，覆盖不同工作方式

Google给了四个不同的入口，对应不同的使用场景。

1. gcloud CLI：终端里直接查

如果你习惯在终端干活，gcloud CLI已经内置了这个功能。Cloud Shell里预装了，本地装了Google Cloud SDK也能用，不需要额外插件。

三个核心命令：answer-query直接问问题拿有依据的答案，documents search-chunks搜索文档片段，documents describe取特定文档的完整内容。甚至可以把报错信息直接管道传进去排查问题。

2. 智能体技能：接进你的AI编码助手

这是最有意思的一个入口。

Google提供了一个MCP智能体技能，一行命令装到项目里，就能让你的AI编码助手连上Google官方文档。

支持的平台包括：Google Antigravity、Claude Code、Cursor、GitHub Copilot。

还有自定义智能体框架，用的是标准MCP集成，助手自己知道什么时候该搜文档、搜什么、怎么用结果。

它用的是多步检索工作流，先用searchDocumentChunks定位相关片段，再用documents.get取完整Markdown页面，或者直接用answerQuery拿带引用的答案。

不是一股脑把整个文档塞给AI，省token也省时间。

3. 客户端库：嵌进生产系统

如果你要在自己的产品里集成文档检索——比如做一个企业知识机器人、CI/CD里的自动文档检查、或者客服系统里的技术问答——客户端库是正经选择。

支持7种语言：C#、Go、Java、Node.js/TypeScript、PHP、Python、Ruby。

每种语言都有原生类型定义、构建器模式、异步支持，不是那种自动生成的敷衍SDK。

BatchGetDocuments一次能取20个文档，支持Google Cloud ADC认证、自动重试和结构化引用跟踪。

4. APIs Explorer：零代码试一下

不确定API返回什么结构？

Google APIs Explorer里可以直接在网页上试四个核心端点，看请求参数和响应结构。

它解决了什么问题

第一个是网页抓取的脆弱性。

很多AI工具查文档靠爬网页，Google的文档页面结构一调整，爬虫就挂了。而且爬下来的HTML里混着导航、广告、相关链接，AI还得自己过滤正文，过滤错了就答非所问。

第二个是LLM训练截止日期的过时问题。

GPT也好、Claude也好，训练数据有截止日期，之后发布的API、新增的参数、废弃的接口，它们都不知道。用官方API实时查，就不存在这个问题。

第三个是token效率。

不是把整篇文档塞给AI，而是先搜相关片段，需要时再取全文。这个多步检索的设计，在长文档场景下能省不少token。

第四个是减少幻觉。

answerQuery返回的答案带引用来源，AI可以追溯到具体文档，不是凭空生成。对代码这种容错率低的场景，"有依据"比"看起来对"重要得多。