Google A2A Sample 실행 테스트

2025.07.20 기준 작성 

A2A 란? 


A2A 설치 링크 : 
https://github.com/a2aproject/a2a-samples


Google API Key 링크 :
https://aistudio.google.com/u/1/apikey


agent.json 확인 링크 :
http://localhost:10000/.well-known/agent.json


설치 방법 : 
1. A2A sample 프로젝트를 다운 받는다.
https://github.com/a2aproject/a2a-samples  

Agent2Agent(A2A) 프로토콜 발표- Google Developers Blog

 

 

2. 에이전트 하나를 실행 시켜 볼건데 langgraph 에이전트로 실행해 보겠다. 
   a. 먼저 폴더 이동 

cd samples/python/agents/langgraph

   
   b. langgraph 폴더 최상 위에 .env 파일을 하나 새로 만들어 준다. 
   
   c. .env 파일에 아래 내용을 복사해서 넣는다. 
   `GOOGLE_API_KEY=여기에 Google API Key 발급 후 복붙` 
   https://aistudio.google.com/u/1/apikey
   d. 아래 명령어들을 입력 하여 langgraph 에이전트를 실행 한다.

   uv sync
   uv run app

   
   아래와 같이 실행이 되었다면 성공한 것이다.

3. 이제 해당 에이전트를 이용 하기 위해 A2A를 실행 해보자.

•  프로젝트 메인으로 위치 이동 후 demo/ui 폴더로 이동 한다.

cd demo/ui

 

• env 파일을 생성후 위에 생성한 .env 파일 내용을 복사해서 넣어준다.
• 아래 명령어를 입력해서 서버를 실행 한다. 

uv run main.py

아래처럼 보인다면 정상 실행 된 것이다. 
브라우저를 통해 실행중인 서버를 한번 접속해 보자.

4. A2A 웹 화면에서 이제 2.에서 실행한 langgraph 에이전트를 연결 시켜 보자. 

• 좌측 메뉴에 로봇 이미지(Agents) 클릭후 
     업로드 버튼(화살표가 위로 향한 이미지)을 누른다.

 

• langgraph agent의 url 을 입력하고 Read를 누른다.
  
  

 

• 채팅 아이콘을 누른다. 

• + 버튼을 눌러 채팅을 시작한다. 
  
  
• sample 프로젝트에서 langgraph 에이전트는 환전을 위한 agent 이므로 환전 관련 질문을 해본다.
  
  
• 이제 아래 처럼 응답이 나왔다면 성공! !

5. A2A는 독립적인 AI 에이전트 간의 원활한 통신 및 협업을 위한 용도 이므로 위와 같이 여러 에이전트를 실행후 agent를 추가 해주면, 
   응용이 가능하다.