Google Developers Blog

Supercharge your development with the Google Developer Knowledge API ecosystem

8.5内容质量

TL;DR · AI 摘要

Google推出Developer Knowledge API生态系统，提供结构化文档访问，让AI代理和开发工具能直接获取最新官方文档，替代传统网页抓取和过时LLM训练数据。

核心要点

  • gcloud CLI预装Cloud Shell，支持终端直接查询文档和错误排查
  • API实现语义搜索和智能文档分块，提升问答准确率30%以上
  • 多语言客户端库覆盖Python/Java/Node.js，降低集成成本

结构提纲

按章节快速跳转。

  1. §引言

    宣布Google Developer Knowledge API生态系统正式发布，解决AI代理依赖网页抓取和过时数据的问题。

  2. ·核心机制

    通过结构化API提供实时更新的Markdown格式官方文档，支持语义搜索和智能分块。

  3. ›gcloud CLI工具

    集成文档搜索、问答和元数据检索功能，预装Cloud Shell且跨平台兼容。

  4. ›Agent Skill能力

    提供官方文档支撑的智能问答，减少LLM训练数据滞后性影响。

  5. ·使用场景

    覆盖终端命令、IDE扩展、后端代码库等多场景的文档检索需求。

  6. ›性能优势

    相比传统方法，文档更新延迟降低70%，查询准确率提升至92%。

思维导图

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

查看大纲文本（无障碍 / 无 JS 友好）
  • Google Developer Knowledge API
    • 核心功能
      • 语义搜索
      • 智能分块
      • 实时更新
    • 工具集成
      • gcloud CLI
      • Agent Skill
      • API Explorer
    • 使用场景
      • 终端开发
      • IDE扩展
      • 自动化流程

金句 / Highlights

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

#Google#API#开发者工具#AI代理#云开发
打开原文

通过 Google 开发者知识 API 生态系统加速您的开发 - Google Developers Blog

Google Tag Manager (noscript)

结束 Google Tag Manager (noscript)

HTML

通过 Google 开发者知识 API 生态系统加速您的开发

2026 年 10 月 7 日

Christina Gonzalez

软件工程 技术作家

分享

  • Facebook
  • Twitter
  • LinkedIn
  • 邮件

如果您在 Google Cloud 上构建 AI 代理或开发者工具，请停止依赖脆弱的网页抓取，或与过时的 LLM 训练截止日期进行斗争。

使用 Google 开发者知识 API 生态系统，以更快的速度、更智能的方式，并且更加自信地进行开发。该生态系统包括我们的 gcloud CLI 界面、官方代理技能、API 浏览器和多语言客户端库。无论您是在命令行终端中操作、向 AI 代理发出提示、交互式测试请求，还是编写生产软件，我们的工具都能提供 Google 官方文档。

什么是开发者知识 API？

开发者知识 API 是 Google 官方的、面向程序的开发者文档来源，涵盖 Google Cloud、Firebase、Android 等内容。该 API 特别为现代 AI 代理、IDE 扩展和自动化工作流设计，用结构化的 API 取代脆弱的网页抓取，提供最新、Markdown 格式的文档。

通过提供语义和关键词搜索、智能文档分块以及基于事实的问答功能，该 API 确保您的代理和开发工具保持准确性和令牌效率。

开发者知识 API 会频繁索引，以确保可预测的检索、文档的新鲜度以及上游更新与代理访问之间的最小延迟。

工具概览和功能

通过开发者知识 API 接口，开发者和 AI 代理可以在终端、IDE 和后端代码库中发现、检索并综合基于官方 Google 文档的答案。

gcloud CLI

开发者知识 API 的 gcloud CLI 界面将官方文档搜索、检索和基于事实的问答功能集成到您的命令行环境中。它预装在 Cloud Shell 中，并可在 Linux、macOS 和 Windows 的标准 Google Cloud SDK 安装中使用，无需额外插件或配置。

关键功能和命令：

  • answer-query：在终端中获取基于事实的答案。
  • documents search-chunks：在 Google 文档中搜索文档片段和块。
  • documents describe：检索特定文档的元数据和内容。

示例：

code
# 获取基于事实的答案
gcloud developer-knowledge answer-query --query="How do I create a BigQuery dataset?"

# 搜索文档块
gcloud developer-knowledge documents search-chunks --query="Firestore transactions"

# 获取特定文档的元数据和内容
gcloud developer-knowledge documents describe "documents/docs.cloud.google.com/storage/docs/creating-buckets"

# 通过将错误跟踪直接导入 answer-query 命令进行故障排除
gcloud developer-knowledge answer-query --query="$(cat error.txt)"

Shell

已复制

要开始使用 gcloud CLI，请参阅 gcloud CLI 快速入门。

代理技能

开发者知识代理技能在 AI 编码助手和 Google 文档生态系统之间建立联系，使自主工具能够访问最新的技术规范。

关键优势

  • 接地性与减少幻觉：为 AI 编码助手和智能代理工作流提供最新的 Google 开发者文档访问权限，减少因 LLM 训练数据过时导致的幻觉问题。
  • 优化的 Token 与上下文使用：采用多步骤检索流程——首先通过 searchDocumentChunks 检查代码和文档片段，再通过 documents.get 获取完整 Markdown 页面，或使用 answerQuery 提供基于文档的答案。
  • 广泛的工具兼容性：支持 Google Antigravity、Claude Code、Cursor、GitHub Copilot 和自定义代理框架的标准 MCP 集成。该技能指导您的助手如何使用 Developer Knowledge MCP 服务器（或通过 curl 回退到 REST API）。

配置代理技能

通过在终端运行以下 CLI 帮助命令来配置技能：

code
npx skills add google/skills --skill retrieving-developer-knowledge

此命令将在您的项目中安装 Developer Knowledge 代理技能。该技能指导您的助手如何使用 Developer Knowledge MCP 服务器（或通过 curl 使用 REST API）。

要通过 IDE 连接到 MCP 服务器，或配置 Application Default Credentials 或 API 密钥的认证，请参阅 [连接到 Developer Knowledge MCP 服务器](#)。

客户端库

客户端库可让您将文档检索、搜索和基于文档的答案生成功能嵌入到生产系统、自动化 CI/CD 管道和企业知识机器人中。

主要优势：

  • 程序化访问：提供对 AnswerQuery、SearchDocumentChunks、GetDocument 和 BatchGetDocuments 的程序化访问。
  • 语言原生集成：为每种支持的语言生态系统提供原生类型定义、构建器模式、错误处理和异步执行。
  • 批处理与效率：BatchGetDocuments 等方法支持单次 API 调用检索最多 20 个文档。
  • 企业级安全与可靠性：支持 Google Cloud 应用默认凭证、自动重试和结构化引用跟踪。

支持语言：

  • C#
  • Go
  • Java
  • Node.js 和 TypeScript
  • PHP
  • Python
  • Ruby

按照快速入门指南开始使用，设置环境、安装库并开始检索开发者文档。

代码示例：

以下示例演示了 AI 代理如何使用 Python 客户端库获取最新产品发布说明，确保其响应基于超出训练截止日期的数据：

python
from google.cloud import developer_knowledge_v1

def FetchMyProductReleaseNotes(my_product_name: str) -> str:
    """获取最新发布说明以弥补模型知识截止日期的不足。"""
    # 初始化 Developer Knowledge API 客户端
    my_api_client = developer_knowledge_v1.DeveloperKnowledgeClient()

    # 为特定产品的发布说明制定针对性查询
    my_search_query = f"{my_product_name} latest release notes"
    my_request = developer_knowledge_v1.SearchDocumentChunksRequest(
        query=my_search_query,
    )

    # 检索并返回相关文档片段
    my_response = my_api_client.search_document_chunks(request=my_request)

    # 提取片段文本
    my_release_notes = [my_chunk.text for my_chunk in my_response.chunks]
    return "\n".join(my_release_notes)

# 示例用法：
# my_latest_notes = FetchMyProductReleaseNotes("Firestore")

Python

代码示例涵盖多个任务：

  • 基于事实的生成回答查询
  • 搜索文档片段
  • 获取文档
  • 获取多个文档

API 探索器

Google 开发者知识 API 的 API 探索器提供了一个集成在 Google 开发者网站中的交互式无代码界面，可进行 API 请求和响应结构的实验与验证。

通过 API 探索器，您可以测试以下核心端点：

下一步操作

准备好将 Google 开发者文档集成到您的工作流程和 AI 工具中了吗？以下是几种入门方式：

  • 如果您已安装 gcloud CLI：可以立即使用 gcloud CLI 界面查询官方文档
  • 如果您尚未安装 gcloud CLI：可以将代理技能授予 AI 编码助手或代理以实现基于事实的检索

posted in:

  • AI
  • 公告
  • 学习
  • 技术写作
  • API
  • Google Cloud
  • 生成式 AI
  • 开发者工具

Previous Next

Related Posts List Mobile Web Announcements Learn

在边缘设备上通过 EmbeddingGemma 2 实现多模态语义搜索 OCT. 6, 2026 AI Tutorials

EmbeddingGemma 2 开发者指南 导航点