A2A Protocol 블로그를 바탕으로 A2A Protocol의 기본 개념과 A2A Protocol Python SDK를 사용한 개발 방법을 배웠습니다.

이 글에서는 A2A Protocol Validator를 사용하여 A2A Protocol을 검증하고 AgentCard를 시각화하여 편리한 디버깅을 하는 방법을 소개합니다:

• 주어진 도메인이 A2A Protocol을 지원하는지 확인
• AgentCard 시각화

공개적으로 배포된 A2A Agent의 경우 도메인을 직접 입력하여 검증할 수 있습니다.

로컬에서 실행되는 A2A Agent를 검증하는 방법은?

• Agent 준비

git clone https://github.com/sing1ee/a2a-python-currency.git
cd a2a-python-currency
uv run python main.py

출력:

Installed 27 packages in 33ms
INFO:     Started server process [61455]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://localhost:10000 (Press CTRL+C to quit)

이렇게 하면 Currency Agent가 로컬에서 실행되며 포트 10000에서 접근할 수 있습니다.

• 로컬 Agent 서비스 매핑 - Cloudflare Zero Trust 사용 설치는 문서를 참조하세요. 제 환경은 Mac입니다

brew install cloudflared

• Zero Trust 프록시 시작

cloudflared tunnel --url localhost:10000

출력:

+--------------------------------------------------------------------------------------------+
2025-06-03T09:03:02Z INF |  Your quick Tunnel has been created! Visit it at (it may take some time to be reachable):  |
2025-06-03T09:03:02Z INF |  https://sheriff-honor-undefined-relate.trycloudflare.com                                  |
2025-06-03T09:03:02Z INF +--------------------------------------------------------------------------------------------+

https://sheriff-honor-undefined-relate.trycloudflare.com 은 로컬 Agent 서비스에 접근할 수 있는 임시 도메인입니다.

A2A Protocol Validator 열기

A2A Protocol Validator를 열고 위의 도메인을 입력하면 도메인이 A2A Protocol을 지원하는지 확인할 수 있습니다.

이러한 단계를 통해 빠르게 디버깅할 수 있습니다. 향후 A2A 온라인 클라이언트를 출시하여 실행을 더욱 편리하게 만들 예정입니다.