Skip to content

day-02.md

Latest commit

 

History

History
70 lines (51 loc) · 3.13 KB

day-02.md

File metadata and controls

70 lines (51 loc) · 3.13 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 包

Challenges Faced

  • 网站上给的 command 是错误的，运行 uvx --from google-adk adk web 时默认时读取 a directory of agents，而不是在 agent directory。
  • Tutorial: AI agent with Google Search(YAML) instruction 也是错的. adk web 运行的时候directory应该在agent的parent folder里。
  • Tutorial: Multi-agent app with MCP (YAML) 要安装Node.Js 是firecrawl的dependency。firecrawl需要注册，free tier不需要花钱，api key能在设置里找到。

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

adk api_server 的使用

以调取api的模式使用agent不能直接点击网页或者和UI直接交互。just in case有人和我一样不懂怎么调取api，下面是使用范例。

输入adk api_server 之后新开一个terminal

curl -X POST http://localhost:8000/apps/my_agent/users/u_123/sessions/s_123 -H "Content-Type: application/json"

apps 后面是agent的名字，user后面是userId，session后面是sessionId.

curl -X POST http://localhost:8000/run -H "Content-Type: application/json" -d '{"appName":"my_agent", "userId":"u_123", "sessionId":"s_123", "newMessage": {"role": "user", "parts":[{"text": "hello"}]}}'

app_name、userId、sessionId需要和上文对应。text后输入user想说的话。 你会在这个terminal看到model的回复。

Resources

Questions / Open Topics