使用说明

🤖 谷歌ADK课程-从头开始构建人工智能代理

欢迎学习使用谷歌的代理开发工具包（ADK）构建强大的人工智能代理。本实践课程将带您从基础知识到构建复杂的多代理系统。

🎯 你将学到什么

✅ 构建能够 思考、行动和使用工具
✅ 创建 定制工具 为你的代理人
✅ 整合 谷歌搜索 和其他API
✅ 设计 多代理工作流 （顺序、并行、循环、协调模式）
✅ 生产准备就绪 代理系统

📖 课程模块

第1a天：从迅速到行动

构建你的第一个AI代理！

学习基本原理：什么是代理，如何创建它们，以及如何用工具赋予它们超能力。

话题：

什么是人工智能代理与简单的LLM
使用ADK创建基本代理
自定义Python函数工具
内置谷歌搜索工具
多回合对话
组合多种工具

📂 开始第1a天→

第1b天：代理架构

组建人工智能代理团队！

掌握复杂任务的多代理系统和工作流模式。

话题：

为什么多智能体>单片系统
LLM协调员 -动态路由
序列模式 -装配线工作流程
相似模式 -并发执行
环形图案 -迭代细化
选择正确的图案

📂 开始第1b天→

⚡ 快速开始

1.先决条件

Python 3.12+ (下载)
Google API密钥 (获取免费密钥)

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-pro

3.运行你的第一个代理！

# 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

📚 其他资源

设置.md -完整的设置指南，包括故障排除
快速引用.md -所有命令和代码模板
谷歌人工智能工作室 -获取免费的API密钥
ADK GitHub -官方ADK存储库

🎯 准备好开始了吗？

完全初学者？

阅读设置.md 第一
然后开始第1a天

有Python和API密钥吗？

运行上面的安装命令
跳到第1a天/01_basic_agent.py

只是想快速参考？ → See 快速引用.md

🌟 学生建造什么

在本课程结束时，您将能够构建：

🔍 研究代理 -可以搜索和分析信息
💬 聊天助理 -具有工具调用功能
🏭 工作流管道 -多代理流水线
🔄 迭代精炼器 -质量循环模式
🎯 智能路由器 -LLM协调员

问题？问题？检查SETUP.md中的故障排除部分！

准备好构建AI代理了吗？走吧！ 🚀

_{最后更新时间： 2025年11月| ADK版本： 1.18.0+ | 型号：双子座-2.5-flash}