# Google ADK 完整使用教程

> **Agent Development Kit (ADK)** — Google 开源的 AI 智能体开发框架
>
> 版本：v1.8.0+ | 语言：Python | 许可证：Apache 2.0

---

## 📖 教程目录

### 第一部分：入门基础

| 章节 | 标题 | 说明 |
|------|------|------|
| [第01章](./01-introduction-and-setup.md) | ADK 简介与环境搭建 | 框架概述、核心特性、安装配置 |
| [第02章](./02-quick-start-hello-world.md) | 快速开始：Hello World | 创建第一个 Agent、运行与测试 |

### 第二部分：核心开发

| 章节 | 标题 | 说明 |
|------|------|------|
| [第03章](./03-llm-agent-in-depth.md) | LLM 智能体详解 | Agent 配置、指令设计、模型选择 |
| [第04章](./04-custom-tools.md) | 自定义工具开发 | 函数工具、MCP 工具、OpenAPI 集成 |
| [第05章](./05-multi-agent-systems.md) | 多智能体系统 | 协调器模式、工作流编排、Agent 间通信 |
| [第06章](./06-session-and-state.md) | 会话与状态管理 | Session、State、Memory 机制详解 |

### 第三部分：进阶与部署

| 章节 | 标题 | 说明 |
|------|------|------|
| [第07章](./07-callbacks-and-events.md) | 回调机制与事件系统 | Before/After 回调、事件处理、自定义逻辑 |
| [第08章](./08-evaluation.md) | 智能体评估 | 评估集设计、自动化测试、性能分析 |
| [第09章](./09-deployment.md) | 部署指南 | Docker 容器化、Cloud Run、Vertex AI Agent Engine |
| [第10章](./10-advanced-topics.md) | 高级主题 | 安全最佳实践、A2A 协议、多模型适配 |

---

## 📂 代码文件说明

| 文件 | 对应章节 | 说明 |
|------|----------|------|
| `code/setup_demo.py` | 第01章 | 环境搭建与安装验证 |
| `code/hello_world.py` | 第02章 | Hello World 示例 |
| `code/llm_agent_demo.py` | 第03章 | LLM 智能体完整示例 |
| `code/custom_tools_demo.py` | 第04章 | 自定义工具开发示例 |
| `code/multi_agent_demo.py` | 第05章 | 多智能体系统示例 |
| `code/session_state_demo.py` | 第06章 | 会话与状态管理示例 |
| `code/callback_demo.py` | 第07章 | 回调机制示例 |
| `code/eval_demo.py` | 第08章 | 评估示例 |
| `code/deploy_demo.py` | 第09章 | 部署配置示例 |
| `code/advanced_demo.py` | 第10章 | 高级功能示例 |

---

## 🚀 快速导航

### 我是新手，从哪里开始？
👉 从 [第01章](./01-introduction-and-setup.md) 开始，按顺序学习。

### 我只想快速体验？
👉 直接跳到 [第02章](./02-quick-start-hello-world.md) 的 Hello World。

### 我想构建多智能体系统？
👉 重点学习 [第05章](./05-multi-agent-systems.md)。

### 我想部署到生产环境？
👉 查看 [第09章](./09-deployment.md)。

---

## 🔗 官方资源

- **官方文档**：https://google.github.io/adk-docs/
- **GitHub 仓库**：https://github.com/google/adk-python
- **示例代码**：https://github.com/google/adk-samples
- **Java 版本**：https://github.com/google/adk-java
- **Web 版本**：https://github.com/google/adk-web

---

## 📋 前置要求

- **Python**：3.10 或更高版本（v1.19.0+ 要求）
- **pip**：Python 包管理器
- **Google AI Studio API Key**：用于 Gemini 模型调用
- **（可选）** 其他 LLM 的 API Key（如 OpenAI、DeepSeek 等）

---

> 💡 **提示**：本教程所有代码示例均提供详细中文注释，建议配合代码文件一起阅读。