← 返回全部情报
Google Developer Knowledge API:用官方文档检索、分块与 grounded Q&A,替代脆弱网页抓取;配套 gcloud、agent skill、MCP 与多语言客户端 的封面

·Blog·工程博客收录 2026-10-15

Google Developer Knowledge API:用官方文档检索、分块与 grounded Q&A,替代脆弱网页抓取;配套 gcloud、agent skill、MCP 与多语言客户端

Developer Knowledge APIgrounded Q&AMCPagent skillgcloud

一句话结论

Google 把 Cloud、Firebase、Android 等官方文档做成可编程接口:语义加关键词搜索、智能分块、带引用的问答,并配上 gcloud、官方 agent skill、MCP 与七种语言客户端,让编码助手和 CI 直接读新鲜 Markdown,而不是靠抓网页或过期训练数据。

打开原文 Google Developers Blog:Supercharge your development with the Google Developer Knowledge API ecosystem

背景与理念

面向 agent 与 IDE 扩展时,靠网页抓取或模型训练截止日拿文档既脆又容易过期。Developer Knowledge API 被定位成 Google Cloud、Firebase、Android 等开发者文档的官方程序化真源,返回结构化、Markdown 格式的内容,并针对现代 AI agent、IDE 扩展和自动化工作流设计。语义搜索、关键词搜索、智能分块与 grounded Q&A 合在一起,目标是让工具既准确又省 token。索引会频繁更新,以缩短上游文档改动与 agent 能读到之间的滞后。

具体做法

  1. gcloud CLI 面。Cloud Shell 预装,标准 Google Cloud SDK(Linux / macOS / Windows)无需额外插件:`answer-query` 做 grounded 回答,`documents search-chunks` 搜片段,`documents describe` 取单篇元数据与正文;也可把错误堆栈直接管道进 `answer-query`。
  2. 官方 agent skill。一条 `npx skills add google/skills --skill retrieving-developer-knowledge` 把技能装进项目;技能教助手走 Developer Knowledge MCP(或退回 REST/`curl`),兼容 Google Antigravity、Claude Code、Cursor、GitHub Copilot 与自建框架。
  3. 多步检索再回答。先用 `searchDocumentChunks` 看代码与文档块,再按需 `documents.get` 拉完整 Markdown,或直接 `answerQuery` 要带依据的答案,以控制上下文体积。
  4. 多语言客户端与批取。C#、Go、Java、Node/TypeScript、PHP、Python、Ruby 均可嵌入检索与问答;`BatchGetDocuments` 单次最多取 20 篇;鉴权走 Application Default Credentials,并支持自动重试与结构化引用追踪。
  5. APIs Explorer。在开发者站点上零代码试核心端点,核对请求与响应结构后再写进生产。

关键数据/例子

接口能力写得很具体:搜索分块、取整页、最多 20 篇批量拉取,以及终端里的 grounded 问答。示例里用 `gcloud developer-knowledge answer-query --query="How do I create a BigQuery dataset?"` 直接问答,用 `documents search-chunks --query="Firestore transactions"` 搜片段,或对 `documents/docs.cloud.google.com/storage/docs/creating-buckets` 做 `describe`。Python 示例则用 `SearchDocumentChunksRequest` 拉某产品最新 release notes,把模型训练截止之外的变更接回来。技能安装命令是固定的一行 `npx skills add`。

创新点

第一,把「官方文档」做成可被 agent 调用的真源 API,而不是再维护一套爬虫。第二,检索默认走「先分块、再按需取全文或问答」的多步路径,把 token 花在真正相关的段落上。第三,同一套能力同时出现在终端、MCP/skill 与七种语言客户端里,方便从个人助手一路接到 CI 与企业知识机器人。

可否复用

  1. 已有 gcloud 的环境先跑 `answer-query` / `search-chunks`,确认检索结果是否覆盖你关心的产品线。
  2. 给编码助手装上 `retrieving-developer-knowledge` skill,并接上 MCP;鉴权优先用 ADC,避免把密钥写进提示。
  3. 在 agent 工作流里强制「先 searchDocumentChunks,再 get 或 answerQuery」,不要一上来整页灌上下文。
  4. 生产侧用客户端库的 BatchGetDocuments(≤20)和引用字段,把回答绑回具体文档,方便审计与回归。

笔记会在输入时自动保存。