설정 구조

디렉토리 레이아웃

cloud-operation-ai/
├── content/                              # 워크샵 콘텐츠 (마크다운)
│   ├── index.{en-US,ko-KR}.md           # 메인 소개
│   ├── imaging-platform-architecture.md  # ExampleCorp 아키텍처
│   ├── module-1-agentcore-runtime/       # 모듈 1 콘텐츠
│   ├── module-2-agentcore-memory/        # 모듈 3 콘텐츠
│   ├── module-3-a2a/                     # 모듈 4 콘텐츠
│   ├── module-4-cloudwatch-investigations/ # 모듈 2 콘텐츠
│   ├── summary.md                        # 요약
│   └── cleanup.md                        # 리소스 정리
│
├── assets/                               # 실습용 코드 자산
│   ├── module-1/agentcore-reference/     # 모듈 1 참조 구현
│   │   ├── agent_config/
│   │   │   ├── agent.py                  # TroubleshootingAgent
│   │   │   ├── memory_hook_provider.py   # Memory Hook
│   │   │   └── utils.py
│   │   ├── prerequisite/                 # Lambda 함수들
│   │   │   ├── lambda-dns/
│   │   │   ├── lambda-connectivity/
│   │   │   └── lambda-cloudwatch/
│   │   ├── test/                         # 테스트 스크립트
│   │   ├── Dockerfile
│   │   └── main.py                       # 엔트리포인트
│   │
│   ├── workshop-module-3/                # A2A 에이전트들
│   │   ├── a2a/
│   │   │   ├── a2a-collaborator-agent/   # Collaborator
│   │   │   ├── a2a-connectivity-agent/   # Connectivity
│   │   │   └── a2a-performance-agent/    # Performance
│   │   ├── agentcore-connectivity-agent/ # AgentCore 호스팅 버전
│   │   └── agentcore-performance-agent/  # AgentCore 호스팅 버전
│   │
│   └── workshop-module-4/               # CloudWatch 설정
│
└── static/images/                        # 워크샵 이미지 (81개)

핵심 파일

TroubleshootingAgent (agent_config/agent.py)

Strands Framework 기반의 AI 에이전트 클래스입니다.

주요 책임:

• BedrockModel 초기화 (Claude Sonnet 4)

• MCP Client를 통한 Gateway 연결

• Agent 인스턴스 생성 (도구 + Memory Hook)

Memory Hook Provider (memory_hook_provider.py)

AgentCore Memory와의 통합을 담당합니다.

주요 책임:

• 에이전트 초기화 시 이전 대화 컨텍스트 로드

• 메시지 수신 시 관련 메모리 검색 및 주입

• 대화 내용 자동 저장

Collaborator Agent (a2a-collaborator-agent/agent.py)

A2A 프로토콜을 통한 멀티 에이전트 오케스트레이션을 담당합니다.

주요 책임:

• Agent Card 기반 원격 에이전트 발견

• 요청 분석 및 라우팅

• send_message_tool을 통한 A2A 통신

• Rate Limiting 및 Exponential Backoff

엔트리포인트 (main.py)

BedrockAgentCoreApp의 진입점입니다.

from bedrock_agentcore.runtime import BedrockAgentCoreApp

app = BedrockAgentCoreApp()

@app.entrypoint
async def invoke(payload, context):
    user_message = payload["prompt"]
    session_id = context.session_id
    # 에이전트 태스크 생성 및 스트리밍 응답 반환

Docker 설정

FROM ghcr.io/astral-sh/uv:python3.11-bookworm-slim
CMD ["opentelemetry-instrument", "python", "-m", "main"]