단계 1: 가상 환경 활성화

배스천 인스턴스 연결

이 워크샵의 모듈을 완료하기 위해 배스천 인스턴스를 사용합니다. 시작하려면:

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

CloudFormation 스택

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

CloudFormation Outputs

1. CodeServer에 접속합니다

CodeServer

환경 설정

다음으로, workshop-module-1 폴더로 이동하여 zip 파일을 다운로드하고 내용을 추출합니다:

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

다음 명령어를 사용하여 가상 환경을 활성화합니다:

cd agentcore-reference && source .venv/bin/activate

가상 환경 활성화

가상 환경이 활성화되면 프롬프트 앞에 (.venv) 접두사가 표시됩니다.

프로젝트 구조 분석

워크샵 환경의 디렉토리 구조를 이해합니다:

/workspace/workshop-module-1/agentcore-reference/
├── .bedrock_agentcore.yaml    # AgentCore 런타임 설정
├── main.py                     # 에이전트 엔트리포인트
├── agent_config/               # 에이전트 핵심 로직
│   ├── agent.py               # TroubleshootingAgent 클래스 (179줄)
│   ├── memory_hook_provider.py # 메모리 훅 (모듈 3에서 활용)
│   ├── access_token.py        # OAuth2 토큰 관리
│   ├── context.py             # 런타임 컨텍스트
│   ├── streaming_queue.py     # 스트리밍 응답 큐
│   └── utils.py               # SSM 파라미터 헬퍼
├── scripts/                    # 배포 및 설정 스크립트
│   ├── agentcore_gateway.py   # Gateway 생성/삭제 (410줄)
│   ├── agentcore_agent_runtime.py # Runtime 생성/삭제
│   ├── cognito_credentials_provider.py # Cognito 설정 (805줄)
│   └── utils.py               # 공통 유틸리티
├── prerequisite/               # Lambda 도구 배포
│   ├── lambda-dns/            # DNS 해석 도구
│   ├── lambda-connectivity/   # 연결성 분석 도구
│   └── lambda-cloudwatch/     # CloudWatch 모니터링 도구
└── test/                       # 에이전트 테스트
    └── test_agent.py          # 대화형 테스트 스크립트

핵심 의존성 (requirements.txt)

패키지	역할
strands-agents	Strands AI 에이전트 프레임워크
strands-agents-tools	기본 도구 (current_time 등)
strands-agents-builder-bedrock	Amazon Bedrock 모델 통합
bedrock-agentcore-client	AgentCore Runtime SDK
mcp	Model Context Protocol 클라이언트
boto3	AWS SDK for Python

핵심 포인트: 이 프로젝트는 Strands Agents Framework를 기반으로 합니다. Agent, BedrockModel, MCPClient 세 가지 핵심 클래스로 에이전트를 구성하며, AgentCore Runtime이 서버리스 인프라를 관리합니다.

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