用于 ADK 的 Google Developer Knowledge MCP 工具¶
ADK 已支持PythonTypeScript
Google Developer Knowledge MCP 服务器提供了对 Google 公开开发者文档的程序化访问,使你能够将此知识库集成到自己的应用程序和工作流中。通过将你的 ADK 智能体连接到 Google 的官方文档库,可以确保你收到的代码和指南是最新且基于权威上下文的。
使用场景¶
- 实现指南:询问实现特定功能的最佳方式(例如,使用 Firebase Cloud Messaging 处理推送通知)。
- 代码生成与说明:搜索文档中的代码示例,例如使用 Python 列出 Cloud Storage 项目中的所有 Bucket。
- 故障排除与调试:查询错误消息或 API 密钥水印以快速解决问题。
- 比较分析与总结:对 Cloud Run 和 Cloud Functions 等服务进行比较。
先决条件¶
- 一个 Google Cloud 项目
- 已启用 Developer Knowledge API
- 已完成身份验证配置(OAuth 或 API 密钥)
安装¶
你必须在你的 Google Cloud 项目中启用 Developer Knowledge MCP 服务器。
请参考官方安装指南 (Installation Guide)以获取精确的 gcloud 命令和说明。
在智能体中使用¶
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
DEVELOPER_KNOWLEDGE_API_KEY = "YOUR_DEVELOPER_KNOWLEDGE_API_KEY"
root_agent = Agent(
model="gemini-2.5-pro",
name="google_knowledge_agent",
instruction="在 Google 开发者文档中搜索实现指南。",
tools=[
McpToolset(
connection_params=StreamableHTTPConnectionParams(
url="https://developerknowledge.googleapis.com/mcp",
headers={"X-Goog-Api-Key": DEVELOPER_KNOWLEDGE_API_KEY},
),
)
],
)
import { LlmAgent, MCPToolset } from "@google/adk";
const DEVELOPER_KNOWLEDGE_API_KEY = "YOUR_DEVELOPER_KNOWLEDGE_API_KEY";
const rootAgent = new LlmAgent({
model: "gemini-2.5-pro",
name: "google_knowledge_agent",
instruction: "在 Google 开发者文档中搜索实现指南。",
tools: [
new MCPToolset({
type: "StreamableHTTPConnectionParams",
url: "https://developerknowledge.googleapis.com/mcp",
transportOptions: {
requestInit: {
headers: {
"X-Goog-Api-Key": DEVELOPER_KNOWLEDGE_API_KEY,
},
},
},
}),
],
});
export { rootAgent };
可用工具¶
| 工具名称 | 描述 |
|---|---|
search_documents |
搜索 Google 的开发者文档,根据你的查询寻找相关页面和片段 |
get_documents |
使用搜索结果中的父引用获取多个文档的完整页面内容 |