구글 Advent of Agents 2025 따라 하기 - Day 2

https://adventofagents.com/

Advent of Agents 2025

4일 차까지 열렸다. 얼른 따라가야 한다. 그나마 미국이 우리나라보다 날짜가 하루 늦어서 다행이다. 

2일 차의 타이틀은 'Hello World with YAML' 이다. 코드 한 줄 없이 Gemini로 5분 만에 첫 번째 AI 에이전트를 만드는 과정이라고 소개돼 있다. 그대로 따라 해 보겠다.

% uvx --from google-adk adk create --type=config my_agent

zsh: command not found: uvx

처음부터 난관이다. uv는 들어봤는데 uvx는 또 무엇이란 말인가. 참고로 난 아직도 pip를 쓰고 있다. 구글링 해서 설치부터 들어간다. 난 맥 유저니까 Homebrew로 설치했다.

% brew install uv

# 중간 생략..
==> Fetching downloads for: uv
✔︎ Bottle Manifest uv (0.9.15)                                                                      [Downloaded    8.1KB/  8.1KB]
✔︎ Bottle uv (0.9.15)                                                                               [Downloaded   18.2MB/ 18.2MB]
==> Pouring uv--0.9.15.arm64_tahoe.bottle.tar.gz
🍺  /opt/homebrew/Cellar/uv/0.9.15: 17 files, 43.3MB
# 이하 생략..

uv 설치 완료, 아까 실패했던 거 재시도..

% uvx --from google-adk adk create --type=config my_agent

Installed 105 packages in 120ms
Choose a model for the root agent:
1. gemini-2.5-flash
2. Other models (fill later)
Choose model (1, 2):

잘 된다. 그다음부터는 2일 차 페이지에 첨부된 아래 유튜브 영상을 그대로 따라 했다.

https://youtu.be/bPGf51XBJ44?si=QnslF88py0UshTG5

오.. 에이전트가 만들어진 것 같다. 중간에 api key를 생성해야 하는데 쓰여있는 대로 아래 Google AI Studio라는 페이지로 이동해서 프로젝트를 먼저 생성하고 대충 이름을 정해서 api key를 생성했다.

반응형

https://aistudio.google.com/api-keys

로그인 - Google 계정

이어서 2일 차 페이지에 쓰여 있는 대로 터미널에서 아래 명령어를 타이핑했다.

uvx --from google-adk adk web my_agent/

브라우저를 띄우고 127.0.0.1:8000에 접속해 봤다. 잘 되겠지, 뭐..

라고 생각했으나 안 된다. 모르겠다. 2일 차에서 막힐 줄은 몰랐다.

https://www.econovill.com/news/articleView.html?idxno=721112

[속보] 클라우드플레어 장애 발생… 주요 사이트 접속 지연· 오류 - ER 이코노믹리뷰

혹시 cloudflare 장애 때문일까? 내일 다시 해봐야겠다.

---

노트북을 덮기 직전에 혹시나 하고 유튜브 영상과 2일 차 페이지에 적힌 명령어를 비교해 봤다. 띠용.. 영상에는 아래와 같이 프로젝트 경로명(my_agent/)이 빠져 있다.

터미널에서 이대로 입력해서 웹 서버를 띄웠더니..

잘 된다. 2일 차 따라 하기 성공! 끝. 3일 차에 투 비 컨티뉴드..