단계 1: A2A 초기 설정

워크숍 파일 가져오기

사전 프로비저닝된 Bastion 인스턴스에서 workshop-module-3 파일을 가져옵니다.

환경 변수를 설정합니다:

export ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
export BASTION_ID=$(aws cloudformation describe-stacks --stack-name sample-application \
  --query 'Stacks[0].Outputs[?OutputKey==`BastionInstanceId`].OutputValue' --output text)

Bastion에서 파일을 압축하여 S3로 업로드합니다:

COMMAND_ID=$(aws ssm send-command --instance-ids "$BASTION_ID" \
  --document-name AWS-RunShellScript \
  --parameters '{"commands":["cd /root && tar czf /tmp/wm3.tar.gz workshop-module-3 && aws s3 cp /tmp/wm3.tar.gz s3://baseline-deploy-'"$ACCOUNT_ID"'/wm3.tar.gz"]}' \
  --query Command.CommandId --output text)
aws ssm wait command-executed --command-id "$COMMAND_ID" --instance-id "$BASTION_ID"

S3에서 다운로드하고 압축을 해제합니다:

cd /workspace && aws s3 cp s3://baseline-deploy-${ACCOUNT_ID}/wm3.tar.gz .
tar xzf wm3.tar.gz && rm -f wm3.tar.gz

에이전트 런타임 확인

Agent-to-Agent (A2A) 통신을 구현하기 전에, 두 AgentCore 에이전트가 AWS 계정에 성공적으로 배포되어 실행 중인지 확인합니다.

콘솔에서 Amazon Bedrock AgentCore 서비스로 이동합니다. 왼쪽 패널에서 Agent Runtime을 클릭합니다. a2a_troubleshooting_agent_runtime과 a2a_performance_agent_runtime이라는 이름의 두 에이전트가 이미 생성되어 있는 것을 확인할 수 있습니다.

A2A 두 에이전트

사전 프로비저닝된 두 개의 AgentCore Runtime:

• a2a_troubleshooting_agent_runtime (Connectivity Agent용)

• a2a_performance_agent_runtime (Performance Agent용)

Connectivity Agent 런타임 테스트

프로젝트 폴더로 이동하고 환경 활성화:

cd /workspace/workshop-module-3/agentcore-connectivity-agent && source .venv/bin/activate

의존성 패키지 설치:

pip install -r requirements.txt

에이전트 테스트:

python3 test/test_agent_m2m.py a2a_troubleshooting_agent_runtime \
  --prompt "안녕하세요" --interactive

영어: Hello

Connectivity Agent 초기 연결

도구 확인 질문:

어떤 툴을 사용할 수 있지?

영어: Can you list the tools you have access to?

에이전트가 dns-resolve와 connectivity 도구를 응답해야 합니다.

Connectivity Agent 테스트

종료:

exit

Performance Agent 런타임 테스트

Performance 에이전트 디렉토리로 이동:

cd /workspace/workshop-module-3/agentcore-performance-agent

의존성 패키지 설치:

pip install -r requirements.txt

에이전트 테스트:

python3 test/test_agent_m2m.py a2a_performance_agent_runtime \
  --prompt "안녕하세요" --interactive

영어: Hello

Performance Agent 초기 연결

도구 확인 질문:

어떤 툴을 사용할 수 있지?

영어: Can you list the tools you have access to?

에이전트가 network-flow-monitor와 traffic-mirroring 도구를 응답해야 합니다.

Performance Agent 테스트

종료:

exit

코드 분석: 사전 프로비저닝된 에이전트 아키텍처

A2A 모듈 전체 구조

/workshop-module-3/
├── agentcore-connectivity-agent/     # Connectivity Agent (AgentCore Runtime)
│   ├── agent_config/
│   │   └── agent.py                 # TroubleshootingAgent (191줄) — 동의 기반 워크플로우
│   ├── scripts/                     # 배포 스크립트
│   └── test/                        # 테스트 도구
│
├── agentcore-performance-agent/      # Performance Agent (AgentCore Runtime)
│   ├── agent_config/
│   │   └── agent.py                 # PerformanceAgent (238줄) — 3개 분석 도구
│   ├── basline-infra/               # CloudFormation 인프라
│   └── test-infra/                  # 성능 이슈 생성 도구
│
└── a2a/                              # A2A 프로토콜 계층
    ├── a2a-collaborator-agent/       # Host Agent (AgentCore Runtime)
    │   └── agent.py                 # HostAgent (860줄) — 라우팅 + Rate Limiting
    ├── a2a-connectivity-agent/       # A2A Server (ECS)
    │   └── agent_executer.py        # AgentCoreExecutor (280줄)
    └── a2a-performance-agent/        # A2A Server (ECS)
        └── agent_executer.py        # AgentCoreExecutor (325줄)

두 에이전트 비교

구분	Connectivity Agent	Performance Agent
클래스	TroubleshootingAgent (191줄)	PerformanceAgent (238줄)
도구	dns-resolve, connectivity	network-flow-monitor, traffic-mirroring, fix-retransmissions
특징	동의 기반 워크플로우 (check → 동의 → fix)	자동 분석 워크플로우
Gateway	/app/troubleshooting/agentcore/gateway_url	/a2a/app/performance/agentcore/gateway_url
모델	Claude Sonnet 4	Claude Sonnet 4

Connectivity Agent 핵심 코드

class TroubleshootingAgent:
    """동의 기반 네트워크 진단 에이전트"""
    def __init__(self, bearer_token, ...):
        self.system_prompt = """
        PERMISSION VALIDATION WORKFLOW:
        1. connectivity(action="check")로 분석
        2. 문제 발견 시 사용자에게 설명
        3. 명시적 동의 확인 (Yes/Please fix)
        4. connectivity(action="fix")로 수정
        5. connectivity(action="check")로 검증
        """

Performance Agent 핵심 코드

class PerformanceAgent:
    """네트워크 성능 분석 에이전트"""
    def __init__(self, bearer_token, ...):
        aws_account_id = get_aws_account_id()  # STS에서 자동 감지

        self.system_prompt = f"""
        ADVANCED PERFORMANCE TOOLS:
        1. analyze_network_flow_monitor — Flow Monitor 분석
        2. analyze_traffic_mirroring_logs — PCAP 패킷 분석
        3. fix_retransmissions — TCP 설정 자동 복구

        DEFAULT REGION: us-east-1
        SESSION AWS ACCOUNT: {aws_account_id}
        """

A2A 통신 아키텍처 개요

핵심 포인트: A2A 모듈은 3계층 아키텍처입니다. (1) Collaborator Agent가 사용자 요청을 라우팅, (2) ECS 기반 A2A Server가 프로토콜을 변환, (3) AgentCore Runtime이 실제 에이전트를 실행합니다. 이 단계에서는 (3)만 테스트하여 각 에이전트가 독립적으로 동작하는지 확인합니다.

이 단계가 완료되었습니다. 다음 단계로 진행하세요.