2. 환경 설정하기

2. 환경 설정하기

첫 A2A 에이전트를 만들기 전에 개발 환경부터 준비할게요.

출처: 문서

본문

사전 요구사항

  • Python 3.10 이상.
  • 터미널 또는 명령 프롬프트에 접근할 수 있는 환경.
  • 저장소를 클론하기 위한 Git.
  • 코드 편집기(예: Visual Studio Code)를 권장해요.

저장소 클론하기

아직 안 했다면 A2A Samples 저장소를 클론해요:

git clone https://github.com/a2aproject/a2a-samples.git -b main --depth 1
cd a2a-samples

Python 환경 & SDK 설치

Python 프로젝트에는 가상 환경을 사용하는 걸 권장해요. A2A Python SDK는 의존성 관리에 uv를 사용하지만, venv와 함께 pip를 써도 돼요.

가상 환경을 만들고 활성화해요:

venv 사용(표준 라이브러리):

Mac/Linux:

python -m venv .venv
source .venv/bin/activate

Windows:

python -m venv .venv
.venv\Scripts\activate

A2A SDK와 필요한 Python 의존성을 설치해요:

pip install -r samples/python/requirements.txt

설치 확인하기

설치 후 Python 인터프리터에서 a2a 패키지를 임포트할 수 있어야 해요:

python -c "import a2a; print('A2A SDK imported successfully')"

이 명령이 오류 없이 실행되고 성공 메시지를 출력하면 환경이 올바르게 설정된 거예요.

더 알아보기 (Learn more)