🤖 谷歌ADK课程-从头开始构建人工智能代理
欢迎 学习使用谷歌的代理开发工具包（ADK）构建强大的人工智能代理。本实践课程将带您从基础知识到构建复杂的多代理系统。
______________________________________________________________________
🎯 你将学到什么
- ✅ 构建能够 思考、行动和使用工具
- ✅ 创建 定制工具 为你的代理人
- ✅ 整合 谷歌搜索 和其他API
- ✅ 设计 多代理工作流 （顺序、并行、循环、协调模式）
- ✅ 生产准备就绪 代理系统
______________________________________________________________________
📖 课程模块
第1a天：从迅速到行动
构建你的第一个AI代理！
学习基本原理：什么是代理，如何创建它们，以及如何用工具赋予它们超能力。
话题：
- 什么是人工智能代理与简单的LLM
- 使用ADK创建基本代理
- 自定义Python函数工具
- 内置谷歌搜索工具
- 多回合对话
- 组合多种工具
📂 开始第1a天→
______________________________________________________________________
第1b天：代理架构
组建人工智能代理团队！
掌握复杂任务的多代理系统和工作流模式。
话题：
- 为什么多智能体>单片系统
- LLM协调员 -动态路由
- 序列模式 -装配线工作流程
- 相似模式 -并发执行
- 环形图案 -迭代细化
- 选择正确的图案
📂 开始第1b天→
______________________________________________________________________
⚡ 快速开始
1.先决条件
2.设置（5分钟）
# 1. Create virtual environment
python -m venv .venv
# 2. Activate it
.\.venv\Scripts\Activate.ps1 # Windows
source .venv/bin/activate # Linux/Mac
# 3. Install dependencies
pip install -r requirements.txt
# 4. ⚠️ IMPORTANT: Install this project (makes utils/ importable)
pip install -e .
# 5. Configure environment variables
copy .env.example .env # Then edit .env with your keys⚠️ 关键步骤： 这 pip install -e . 命令是 必需的 为了避免“没有名为'utils'的模块”的错误！
必填项 .env 文件：
GOOGLE_API_KEY=AIza...your-key-here
GEMINI_TEXT_MODEL=gemini-2.5-flash-lite
GEMINI_MULTIMODAL_MODEL=gemini-2.0-flash-preview-image-generation
GEMINI_PRO_MODEL=gemini-2.5-pro3.运行你的第一个代理！
# Make sure virtual environment is activated!
adk run Day1/1a-from-prompt-to-action/basic_agent您应该看到一个交互式聊天界面！键入您的问题，客服将作出回应。 🎉
备选方案： 运行独立的Python脚本：
python Day1/1a-from-prompt-to-action/01_basic_agent.py需要详细的设置帮助吗？ → See 设置.md\ 了解 adk run → See ADK_USAGE_GUIDE.md
______________________________________________________________________
📂 存储库结构
Google-Course/
│
├── 📄 SETUP.md ← Complete setup guide
├── 📄 QUICK_REFERENCE.md ← Command cheat sheet
├── 📄 .env.example ← API key template
├── 📄 requirements.txt ← All dependencies
│
├── 📁 Day1/
│ │
│ ├── 📁 1a-from-prompt-to-action/
│ │ ├── README.md ← Module guide
│ │ ├── 01_basic_agent.py ← Start here!
│ │ ├── 02_agent_with_custom_tool.py
│ │ ├── 03_agent_with_google_search.py
│ │ ├── 04_multi_tool_agent.py
│ │ └── 05_interactive_agent.py
│ │
│ └── 📁 1b-agent-architectures/
│ ├── README.md ← Module guide
│ ├── 01_llm_coordinator_pattern.py
│ ├── 02_sequential_pattern.py
│ ├── 03_parallel_pattern.py
│ ├── 04_loop_pattern.py
│ └── 05_pattern_comparison.py
│
└── 📁 .venv/ ← Virtual environment______________________________________________________________________
🎓 学习路径
对于完全初学者：
START HERE
↓
1. Read SETUP.md (setup everything)
↓
2. Day 1a/README.md (concepts)
↓
3. Run Day 1a scripts (01 → 05)
↓
4. Day 1b/README.md (multi-agent)
↓
5. Run Day 1b scripts (01 → 05)
↓
BUILD YOUR OWN AGENT! 🚀快速学习者：
- 运行上面的安装命令
- 在每个Day文件夹中运行脚本（01-05）
- 阅读代码中的注释以理解
- 检查QUICK_REFERENCE.md以获取命令
______________________________________________________________________
🛠️ 技术栈
| 组件 | 版本 | 目的 |
|---|---|---|
| 谷歌广告 | 1.18.0+ | 代理框架 |
| python | 3.12+ | 编程语言 |
| 双子座-2.5-flash | 最新 | AI模型（快速且支持工具！） |
| 皮茨 | 2025.2 | 时区支持 |
为什么选择双生2.5睫毛？
- ⚡ 最快的Gemini型号
- ✅ 完整的工具/功能调用支持
- 🎯 非常适合学习和生产
______________________________________________________________________
📝 是什么让这门课程与众不同
✅ 动手的 -每个概念都有可运行的代码\ ✅ 渐进式 -从简单开始，构建到高级\ ✅ 生产准备就绪 -学习实际系统中使用的模式\ ✅ 有据可查 -清晰的评论和指南\ ✅ 模块化 -每个脚本都是自包含的\ ✅ 现代 -使用最新的ADK功能和最佳实践
______________________________________________________________________
🆘 常见问题
“找不到模块：google.adk”
# Activate virtual environment first!
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt“找不到API密钥”
# Set the environment variable:
$env:GOOGLE_API_KEY="your-key-here"
# Or create .env file:
copy .env.example .env
# Then edit .env and add your key“无法激活脚本”
# Windows: Set execution policy
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser更多故障排除： 看 设置.md
______________________________________________________________________
📚 其他资源
______________________________________________________________________
🎯 准备好开始了吗？
完全初学者？
有Python和API密钥吗？
- 运行上面的安装命令
- 跳到 第1a天/01_basic_agent.py
只是想快速参考？ → See 快速引用.md
______________________________________________________________________
🌟 学生建造什么
在本课程结束时，您将能够构建：
- 🔍 研究代理 -可以搜索和分析信息
- 💬 聊天助理 -具有工具调用功能
- 🏭 工作流管道 -多代理流水线
- 🔄 迭代精炼器 -质量循环模式
- 🎯 智能路由器 -LLM协调员
______________________________________________________________________
问题？问题？检查SETUP.md中的故障排除部分！
准备好构建AI代理了吗？走吧！ 🚀
______________________________________________________________________
最后更新时间： 2025年11月| ADK版本： 1.18.0+ | 型号： 双子座-2.5-flash