스터디 - A2A 프로토콜, 테스트

이번엔 내가 직접 구글의 A2A(Agent-to-Agent) 프로토콜을 설치하고 돌려본 과정을 공유해볼게.

처음엔 좀 복잡할 줄 알았는데, 생각보다 금방 된다. 특히나 영상 튜토리얼이 있어서 따라 하기 훨씬 편했어.

 

A2A 프로토콜이 뭐냐면

구글이 2025년에 공개한 오픈 프로토콜인데, 쉽게 말하면 AI끼리 서로 소통하고 협업할 수 있게 만들어주는 표준이야. 예를 들어 LangGraph, CrewAI, Google ADK처럼 다른 프레임워크로 만들어진 에이전트들도 A2A만 있으면 한 군데서 다 연결돼서 일 잘하게끔 도와주는 거지.

주요 특징 간단히 정리하면:

• 에이전트들이 서로 어떤 기능 있는지 파악하고, 일 나눠주는 방식이 딱 정해져 있음
• HTTP, JSON-RPC 같은 기존 표준 쓰니까 배워두면 응용도 쉬움
• 텍스트, 파일, 폼, 스트림 등 다양한 형태로 데이터 주고받을 수 있음

 

1단계: 코드 먼저 클론

git clone https://github.com/google/A2A.git
cd A2A

2단계: API 키 넣고 환경 세팅

Google AI Studio 가서 API 키 발급 받고, 아래의 각 LnagGraph, Google ADK 폴더 내 .env 파일 만들어서 키를 이렇게 넣으면 돼.

GOOGLE_API_KEY=여기에_API_키_입력

3단계: 에이전트 서버 실행

이번 실습에선 샘플 에이전트 2개를 실행해봤어.

첫 번째: LangGraph (환율 변환 에이전트)

cd A2A/samples/python/agents/langgraph
uv run .

접속 주소는 http://localhost:10000이고, http://localhost:10000/.well-known/agent.json에서 기능 확인 가능해.

두 번째: Google ADK (환불 처리 에이전트)

cd A2A/samples/python/agents/google_adk
uv run .

얘는 http://localhost:10002에서 돌아감. 위랑 마찬가지로 .agent.json에서 상세 정보 확인 가능.

4단계: 데모 UI 띄우기

cd A2A/demo/ui
uv run main.py

UI는 http://localhost:12000에서 열려. 여기서 에이전트 등록이나 테스트 다 가능해.

5단계: 에이전트들 등록

브라우저에서 http://localhost:12000 들어가서

1. 상단 "Agents" 탭 클릭
2. Add Agent 입력창에 http://localhost:10000 입력 → Read → Save
3. 똑같이 localhost:10002 도 추가

앞에서 만든 두 개 에이전트 등록 끝!

6단계: 테스트"Conversations" 탭 → + 버튼으로 새 대화 시작

 

응용도 가능함

A2A는 아직 베타 수준 느낌이지만, 확실히 에이전트 간 협업 표준이라는 점에서 의미가 커. 설치나 실행이 생각보다 쉬웠고, 이걸 기반으로 더 실용적인 프로젝트도 가능할 것 같아.

나는 이제 다음 단계로 내가 직접 만든 에이전트도 붙여보고, 다른 프레임워크랑도 연동해보려고 해. GitHub에 샘플을 찾아보면 재미있을 듯.

• A2A 프로토콜 맞춰서 나만의 에이전트 만들어볼 수 있음
• 다양한 프레임워크랑 엮어서 더 복잡한 작업도 가능
• 에이전트들끼리 협업하는 워크플로우도 구성 가능