第 15 章 Google ADK文档adk.wiki
附录 B adk.wiki / adk.dev 文档地图
附录 B adk.wiki / adk.dev 文档地图
本书的目标是让你理解 ADK 的"为什么"，但真正的 API 细节以官方文档为准。本附录把官方文档（英文 adk.dev / 中文镜像 adk.wiki）的主要章节映射到本书章节，方便你按需深读。
B.1 文档站结构
官方文档分六大板块：
- 主页：产品介绍、FAQ
- 构建智能体（Build Agents）：快速入门、教程、Agents、图工作流、多智能体、模型
- 运行智能体（Run Agents）：运行时、部署、可观测性、评估、安全
- 组件（Components）：工具、技能、上下文、MCP、A2A、Grounding
- 集成（Integrations）：生态合作伙伴
- 参考手册（Reference）：各语言 API、CLI、Agent Config、REST API
B.2 章节映射表
| 本书章节 | 官方文档对照（adk.dev） | 中文镜像（adk.wiki） |
|---|---|---|
| 第 1 章 框架版图 | —（选型内容为本书原创） | — |
| 第 2 章 第一个 Agent | /get-started/python/、/get-started/quickstart/ |
/get-started/python/ |
| 第 3 章 工具与上下文 | /agents/tools/、/tools-custom/function-tools/、/context/、/sessions/ |
/components/tools/ |
| 第 4 章 多智能体 | /workflows/collaboration/、/agents/ |
/agents/ |
| 第 5 章 图工作流 | /graphs/ |
/graphs/ |
| 第 6 章 动态工作流 + HITL | /graphs/dynamic/、/graphs/human-input/ |
/graphs/dynamic/、/graphs/human-input/ |
| 第 7 章 模型中立/协议 | /agents/models/、/skills/、/mcp/、/a2a/、/grounding/ |
/models/、/skills/、/mcp/、/a2a/ |
| 第 8 章 部署 | /deploy/、/runtime/api-server/ |
/deploy/、/runtime/ |
| 第 9 章 可观测性 | /observability/ |
/observability/ |
| 第 10 章 评估 | /evaluate/ |
/evaluate/ |
| 第 11 章 安全 | /safety/、/tools-custom/confirmation/、/tools-custom/authentication/ |
/safety/ |
| 第 12 章 复盘与边界 | —（为本书原创综合） | — |
| 第 13 章 总结与进阶 | /get-started/agents-cli/、/visual-builder/、/runtime/api-server/、/live/ |
/visual-builder/ |
| 附录 A 多语言 | /get-started/（python/typescript/go/java/kotlin） |
/get-started/ |
B.3 关键文档路径详解
构建智能体
- 快速入门：
/get-started/python/、/get-started/typescript/、/get-started/go/ - 模型配置：
/agents/models/（子页面：google-gemini/、anthropic/、openai/、litellm/、ollama/、vllm/、routing/） - 图工作流：
/graphs/（子页面：dynamic/、human-input/、routes/、data-handling/） - 工作流模式：
/workflows/patterns/、/workflows/collaboration/
运行智能体
- 命令行：
/runtime/command-line/ - API Server：
/runtime/api-server/ - 部署：
/deploy/（cloud-run/、gke/、agent-runtime/） - 可观测性：
/observability/（logging/、metrics/、traces/） - 评估：
/evaluate/（criteria/、custom_metrics/、user-sim/、environment_simulation/） - 安全：
/safety/
组件
- 函数工具：
/tools-custom/function-tools/ - MCP 工具：
/tools-custom/mcp-tools/ - OpenAPI 工具：
/tools-custom/openapi-tools/ - 工具确认：
/tools-custom/confirmation/ - 工具认证：
/tools-custom/authentication/ - 上下文：
/context/（session/、state/、memory/、caching/、compaction/） - 技能：
/skills/ - MCP：
/mcp/ - A2A：
/a2a/ - Grounding：
/grounding/
B.4 参考手册
- Python API：
/api-reference/python/ - TypeScript API：
/api-reference/typescript/ - Go API：
/api-reference/go/ - Java API：
/api-reference/java/ - Kotlin API：
/api-reference/kotlin/ - CLI 参考：
/api-reference/cli/ - Agent Config 参考：
/api-reference/agentconfig/ - REST API：
/api-reference/rest/ - 版本日志：
/release-notes/
B.5 开源仓库参考
如果需要源码级确认（本书写作时正是这样做的）：
- adk-python 源码：
https://github.com/google/adk-python - adk-docs 文档源码：
https://github.com/google/adk-docs - adk-samples 示例：
https://github.com/google/adk-samples
阅读建议：先读本书建立心智模型，再用本附录按需深读官方文档。官方文档是"词典"，本书是"地图"——两者配合，才能熟练使用 ADK。