产品简介
Developer Knowledge API 是 Google 在 2026 年 10 月 7 日推出的官方开发者文档程序化来源，覆盖 Google Cloud、Firebase、Android 等产品的文档。它要替掉的是两件一直让人头疼的事：一是靠抓网页获取文档的脆弱做法，二是模型训练截止日期带来的知识滞后。
它的形态是一套结构化 API，直接返回 Markdown 格式的文档内容，在此基础上提供语义与关键词检索、智能文档分块和有依据的问答三种能力。索引更新频繁，目的是把上游文档改动到智能体能取到之间的时间差压到最小。
配套的入口不止一个：gcloud CLI 命令行界面、面向 AI 编码助手的官方智能体技能、交互式试请求的 API Explorer，以及多语言客户端库。无论你在终端里敲命令、让智能体自己查、还是在后端代码里调用，都能拿到同一份官方内容。
核心功能
- 官方来源的 Markdown 文档：以结构化 API 提供 Google Cloud、Firebase、Android 等官方文档的 Markdown 格式内容，取代网页抓取这类随页面改版就失效的做法，也让智能体不必依赖训练数据里的旧版本
- 语义与关键词双路检索：同时支持语义检索和关键词检索，配合智能文档分块，既能按意思找到相关段落，也能精确命中特定接口或参数名
- 有依据的问答：grounded Q&A 直接基于官方文档内容作答，回答有出处可循，从机制上压掉模型凭记忆编造的可能
- gcloud CLI 开箱可用：命令行界面预装在 Cloud Shell，Linux、macOS、Windows 上的标准 Google Cloud SDK 也直接可用，不需要额外插件或配置。answer-query 拿有依据答案，documents search-chunks 搜文档片段，documents describe 取指定文档的元数据与正文
- 标准 MCP 接入主流编码工具：官方智能体技能通过标准 MCP 集成到 Google Antigravity、Claude Code、Cursor、GitHub Copilot 以及自定义智能体框架，一条 npx skills add 命令即可装进项目，也可以退回用 curl 调 REST API
- 多步检索省 token：技能内置多步检索流程：先用 searchDocumentChunks 探查代码与文档分块，确有需要再用 documents.get 拉取完整 Markdown 页面，或直接用 answerQuery 拿答案。这种先粗后细的顺序让 token 与上下文消耗保持在低位
适合谁用
以下类型的用户会特别受益于 Developer Knowledge API：
- [object Object]
- [object Object]
- [object Object]
- [object Object]
- [object Object]
优点亮点
- 文档来自官方一手来源，无需维护抓取脚本，也不受页面改版影响
- 返回 Markdown 格式，天然适合喂给模型和智能体，省去 HTML 清洗
- 有依据的问答带出处，从机制上降低幻觉
- gcloud CLI 预装于 Cloud Shell，三大桌面平台的标准 SDK 也直接可用，零配置上手
- 通过标准 MCP 覆盖 Antigravity、Claude Code、Cursor、Copilot 等主流编码工具
- 内置先分块后全文的多步检索流程，token 与上下文消耗更省
- 索引更新频繁，上游文档改动到可检索之间的延迟短
价格与方案
作为 Google 官方开发者文档的程序化入口提供，配套的 gcloud CLI 预装在 Cloud Shell 并随标准 Google Cloud SDK 分发，官方智能体技能通过 npx skills add 免费安装。使用时按各自产品的认证方式接入，支持 Application Default Credentials 与 API key。
总结与建议
Developer Knowledge API 解决的是一个很实际的摩擦：AI 编码工具写 Google Cloud 或 Firebase 代码时，依据要么来自训练数据里的旧版本，要么来自不稳定的网页抓取。Google 把自己的文档做成结构化 API，用 Markdown 直接交付，再配套 CLI、智能体技能和多语言客户端库，等于把官方文档变成了可被程序消费的一等公民。
设计上有个细节值得留意：官方技能刻意要求先检索文档分块、确有需要再拉完整页面，这个顺序让 token 消耗可控，也说明它是按真实编码工作流设计的，而不是简单把文档 API 包一层。
对日常在 Google 技术栈上开发的人，最直接的收益是让编码智能体拿到一手规范；对做开发者工具的团队，则多了一个可以嵌进产品的官方数据源。
版本演进
- Developer Knowledge API 生态发布 （2026-10-07）：Google 推出开发者文档的程序化官方来源，覆盖 Google Cloud、Firebase、Android 等文档，以结构化 API 与 Markdown 格式交付，取代网页抓取并绕开模型训练截止带来的滞后。提供语义与关键词检索、智能文档分块和有依据问答三类能力，索引频繁更新。生态包含预装于 Cloud Shell 的 gcloud CLI 界面（answer-query、documents search-chunks、documents describe）、以 npx skills add google/skills 安装的官方智能体技能（经标准 MCP 接入 Antigravity、Claude Code、Cursor、GitHub Copilot 及自定义框架）、API Explorer 与多语言客户端库，检索采用先分块后全文的多步流程以节省 token