단계 1: 가상 환경 활성화

CodeServer 접속

모듈 3를 시작하기 위해 CodeServer에 접속합니다.

1. CloudFormation로 이동하여 왼쪽 패널에서 vscode를 선택합니다

CloudFormation 스택

1. Outputs 탭을 선택하고 Password 복사 후 URL을 클릭하여 vscode를 오픈합니다.

CloudFormation Outputs

1. CodeServer에 접속합니다

VSCode 화면

환경 설정

CodeServer 터미널에서 workshop-module-2 작업 디렉토리를 설정합니다:

mkdir -p /workspace/workshop-module-2 && cd /workspace/workshop-module-2 && curl https://ws-assets-prod-iad-r-iad-ed304a55c2ca1aee.s3.us-east-1.amazonaws.com/25286efc-5ab4-45b2-a654-bc31f00e0426/cloudops-zip-files/module-2.zip --output module-2.zip && unzip module-2.zip
cd agentcore-reference && source .venv/bin/activate

가상 환경 활성화

모듈 2는 모듈 1에서 생성한 Cognito, Gateway, Targets를 재사용합니다. 별도의 재생성이 필요하지 않습니다.

프로젝트 구조 분석

모듈 3 디렉토리 구조

/workspace/workshop-module-2/agentcore-reference/
├── .bedrock_agentcore.yaml         # AgentCore 런타임 설정
├── main.py                          # 에이전트 엔트리포인트
├── agent_config/
│   ├── agent.py                    # TroubleshootingAgent (모듈 1과 동일)
│   ├── memory_hook_provider.py     # ★ MemoryHook 클래스 (559줄) — 핵심 변경
│   ├── access_token.py             # OAuth2 토큰 관리
│   ├── context.py                  # 런타임 컨텍스트
│   ├── streaming_queue.py          # 스트리밍 응답 큐
│   └── utils.py                    # SSM 파라미터 헬퍼
├── scripts/
│   ├── setup_memory.py             # ★ 메모리 리소스 생성 및 초기 데이터 적재
│   ├── troubleshooting_agent_runtime_with_memory.py  # ★ 메모리 통합 런타임
│   └── utils.py                    # 공통 유틸리티
├── memory-strategies/              # ★ 메모리 전략 문서
│   ├── semantic-memory-strategy.md
│   ├── summary-memory-strategy.md
│   ├── user-preference-memory.md
│   └── custom-memory-strategy.md
├── sops/                           # SOP 문서 (사용자 선호도 메모리 소스)
│   └── connectivity-troubleshooting-sop.md
└── tests-by-strategy/              # 전략별 테스트
    └── integration/
        └── test_01_runtime_connectivity_with_memory.py

모듈 1과의 핵심 차이점

구분	모듈 1	모듈 2
메모리	없음 (Stateless)	AgentCore Memory (4가지 전략)
memory_hook_provider.py	기본 스텁	559줄 완전 구현
세션 관리	단일 세션	크로스 세션 컨텍스트 유지
응답 개인화	없음	사용자 선호도 기반 응답
인프라 재사용	-	Cognito, Gateway, Targets 모듈 1 것 재사용

메모리 전략 아키텍처

핵심 포인트: 모듈 2는 모듈 1의 모든 인프라를 재사용합니다 (Cognito, Gateway, Lambda Targets). 새로 추가되는 것은 memory_hook_provider.py의 MemoryHook 클래스와 AgentCore Memory 리소스뿐입니다. 이 설계 덕분에 기존 에이전트에 메모리를 비침투적으로 추가할 수 있습니다.

이 단계가 완료되었습니다. Next를 클릭하여 진행하세요.