Skip to content

day-02.md

Latest commit

 

History

History
60 lines (42 loc) · 2.3 KB

day-02.md

File metadata and controls

60 lines (42 loc) · 2.3 KB

Day 02 - Hello World with YAML

Challenge Link: Advent of Agents - Day 02

Day 02 Screenshot

Key Learnings

  • 可以在 5 分钟内不使用任何代码构建第一个 AI 智能体
  • ADK 支持使用 YAML 配置文件定义智能体，实现快速开发
  • 使用 uvx adk create --type=config 命令可以快速创建基于 YAML 的智能体项目（无需安装 ADK）
  • 生成的 root_agent.yaml 文件包含智能体的基本配置（名称、描述、指令、模型）
  • 可以使用 uvx adk web 命令启动 Web 界面与智能体交互
  • 支持使用 Gemini 模型（如 gemini-2.5-flash 或 gemini-3）
  • 使用 uvx 可以直接运行 ADK 命令，无需预先安装 google-adk 包
  • 在 root_agent.yaml 中加入 tools 字段即可配置工具

Challenges Faced

  • 后续使用方便起见，这次直接安装了完整的 google-adk 包
  • 注意⚠️：其中的 MCP 组件强制要求Python版本在3.10以上，新建环境时要注意编译器的选择
  • 在Pycharm终端调用agent互动时，无法显式输出日志，只能通过prompt要求输出思考过程

Code Examples

创建 YAML 配置智能体

# 使用 uvx 创建新的智能体项目（无需安装 ADK）
uvx adk create --type=config agents/my_agent


# 使用 uvx 启动 Web 界面
uvx --from google-adk adk web agents/

root_agent.yaml 示例配置

# yaml-language-server: $schema=https://raw.githubusercontent.com/google/adk/agents/config_schemas/AgentConfig.json
name: root_agent
description: A helpful assistant for user questions.
instruction: Answer user questions to the best of your knowledge.
model: gemini-2.5-flash

tools:
  - name: google_search

Resources

Questions / Open Topics