Build with AI: Vertex AI Fine-tuning & Agentic AI 실전 워크샵

Instruct.KR + Sionic AI가 함께 진행하고 Google Developer Ecosystem이 후원하는 Build with AI 2026 핸즈온 워크샵 자료입니다. Vertex AI에서 Gemini 2.5 Flash를 LoRA SFT로 파인튜닝하고, Agent Development Kit(ADK)와 MCP로 도구를 연결한 에이전트를 만든 뒤, Cloud Run에 배포하는 전 과정을 실습합니다.

• 일시: 2026년 5월 28일 (목) 19:00 ~ 22:00
• 장소: 추후 공지
• 대상: 개발자 (초중급), 60 ~ 80명
• 주최: Instruct.KR, Sionic AI
• 후원: Google Developer Ecosystem

---

목차

1. 사전 준비 체크리스트
2. 환경 세팅 가이드
3. 세션 안내
4. 참고: BwAI 공식 Codelab 5종

---

사전 준비 체크리스트

워크샵 당일 원활한 진행을 위해 사전에 아래 항목을 준비해주세요.

• Python 3.10 이상 설치 (python3 --version)
• Node.js 18 이상 설치 (node --version) — Gemini CLI / MCP 서버 구동에 필요
• gcloud CLI 설치 및 로그인 (gcloud auth login)
• Gemini CLI 설치 (npm install -g @google/gemini-cli)
• Google Cloud 프로젝트 생성 및 빌링 활성화 → setup/credit_setup.md 참고
• API 활성화: Vertex AI, Cloud Storage, Cloud Run, BigQuery
• GitHub 계정으로 본 리포 클론 가능

준비 상태는 아래 명령으로 일괄 점검할 수 있습니다.

python setup/env_check.py

---

환경 세팅 가이드

# 1. 리포 클론
git clone https://github.com/<your-org>/bwai-vertexai-agentic-workshop.git
cd bwai-vertexai-agentic-workshop

# 2. 가상환경 생성 및 의존성 설치
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 3. 환경 점검
python setup/env_check.py

# 4. GCP 인증
gcloud auth login
gcloud auth application-default login
gcloud config set project <YOUR_PROJECT_ID>

# 5. (선택) 환경변수 설정
export PROJECT_ID=<YOUR_PROJECT_ID>
export LOCATION=asia-northeast3
export GCS_BUCKET=gs://<YOUR_BUCKET_NAME>
export GOOGLE_MAPS_API_KEY=<YOUR_KEY>

---

세션 안내

#	세션	내용	디렉토리
1	Vertex AI Fine-tuning	Gemini 2.5 Flash 한국어 고객응대 파인튜닝 (LoRA SFT) + Evaluation	./session-1-finetuning
2	ADK + MCP 에이전트	ADK 에이전트 + BigQuery/Maps MCP + Gemini CLI 연동	./session-2-adk-agent
3	Cloud Run 배포	세션 1 모델 + 세션 2 에이전트를 통합하여 Cloud Run 배포	./session-3-deploy

각 디렉토리의 README.md에 세부 실습 절차가 정리되어 있습니다.

---

참고: BwAI 공식 Codelab 5종

본 워크샵에서 활용·참조하는 Google 공식 Codelab입니다. (실제 URL은 워크샵 직전에 갱신됩니다.)

1. Getting Started with MCP, ADK and A2A — <TBD>
2. Building Personalized Agents with ADK, MCP, and Memory Bank — <TBD>
3. Build a Location Intelligence ADK Agent with MCP for BigQuery & Google Maps — <TBD>
4. Vibe Code with Gemini in Google AI Studio — <TBD>
5. Hands-on with Gemini CLI — <TBD>

---