단계 3: Memory Runtime 생성

가상 환경 확인: 터미널에서 (.venv) 프롬프트가 보이는지 확인하세요. 보이지 않으면 다음을 실행하세요:

cd /workspace/workshop-module-2/agentcore-reference && source .venv/bin/activate

AgentCore Runtime 생성 (Memory 포함)

Memory가 통합된 새로운 Runtime을 생성합니다.

스크립트 수정 필요: 제공된 스크립트는 agentcore configure CLI와의 대화형(PTY) 입력 방식을 사용하여 타임아웃이 발생할 수 있습니다. 아래 패치를 먼저 실행하세요.

python3 << 'PATCH'
import re
f = 'scripts/troubleshooting_agent_runtime_with_memory.py'
c = open(f).read()
if '--disable-memory' in c:
    print('Already patched')
else:
    c = re.sub(r",\n\s+'--authorizer-config',[^\n]+", "", c)
    c = c.replace("'--region', get_aws_region()\n        ]",
                   "'--region', get_aws_region(),\n            '--disable-memory'\n        ]")
    oauth = "f'\\n\\nyes\\n{oauth_discovery_url}\\n{oauth_client_id}\\n\\n\\n\\n' + 'no\\n' * 5"
    if 'run_with_pty' in c:
        s = c.index("        # Use pseudo-terminal")
        e = c.index("        result = run_with_pty(configure_cmd, oauth_input)") + len("        result = run_with_pty(configure_cmd, oauth_input)")
        c = c[:s] + f"        result = subprocess.run(configure_cmd, check=False, capture_output=True, text=True, timeout=600, shell=False, input={oauth})" + c[e:]
    elif "input='no\\n' * 10" in c:
        c = c.replace("input='no\\n' * 10", f"input={oauth}")
    open(f, 'w').write(c)
    print('Patched: PTY -> subprocess.run + --disable-memory')
PATCH

🔍 이 패치는 무엇을 변경하나요?

1. --disable-memory 옵션 추가 — 메모리 관련 대화형 프롬프트를 건너뜀

2. 불안정한 PTY(가상 터미널) 입력 방식을 안정적인 subprocess.run으로 교체

3. OAuth 인증 설정을 대화형 입력으로 전달 (yes → Discovery URL → Client ID 순서)

패치가 완료되면 Runtime을 생성합니다:

python3 scripts/troubleshooting_agent_runtime_with_memory.py create troubleshooting_agent_runtime_with_memory

🔍 이 스크립트는 무엇을 하나요?

1. Module 1과 동일한 에이전트에 MemoryHook 추가하여 새 Runtime 생성

2. 에이전트 시작 시 이전 대화 컨텍스트 자동 로드 (최근 10턴)

3. 메시지마다 전략별 메모리 검색 및 자동 저장

4. Runtime이 ACTIVE 상태가 될 때까지 대기

검증

Amazon Bedrock AgentCore Agent Runtime 콘솔로 이동하여 troubleshooting_agent_runtime_with_memory를 확인합니다.

상태가 Active인지 확인합니다.

Runtime with Memory

코드 분석: Memory Hook 통합

MemoryHook 클래스 전체 구조

class MemoryHook(HookProvider):
    """AgentCore Memory와 에이전트를 연결하는 Hook"""

    def __init__(self, memory_client, memory_id, actor_id, session_id):
        self.memory_client = memory_client
        self.memory_id = memory_id
        self.actor_id = actor_id
        self.session_id = session_id

    def register_hooks(self, registry: HookRegistry):
        """두 가지 이벤트 콜백 등록"""
        registry.add_callback(AgentInitializedEvent, self.on_agent_initialized)
        registry.add_callback(MessageAddedEvent, self.on_message_added)

on_agent_initialized: 세션 복원

def on_agent_initialized(self, event: AgentInitializedEvent):
    """에이전트 시작 시 이전 대화 컨텍스트 로드"""
    recent_turns = self.memory_client.get_last_k_turns(
        memory_id=self.memory_id,
        actor_id=self.actor_id,
        session_id=self.session_id,
        k=10,  # 최근 10턴 로드
    )
    # 시스템 프롬프트에 이전 세션 컨텍스트 추가
    event.agent.system_prompt += all_sessions_context

on_message_added: 4가지 전략 라우팅

def on_message_added(self, event: MessageAddedEvent):
    """메시지 수신 시 전략별 메모리 검색 및 대화 저장"""
    user_query = messages[-1]["content"][0]["text"].lower()

    # Q1: 권한/아키텍처 → SEMANTIC MEMORY
    if "permission" in user_query and "architecture" in user_query:
        self._add_context_user_query(namespace="facts", strategy="Semantic Memory")

    # Q2: SOP → USER PREFERENCE MEMORY
    elif "sop" in user_query:
        self._add_context_user_query(namespace="preferences", strategy="User Preference Memory")

    # Q3: 연결 확인 → SEMANTIC + TOOL CALLING
    elif "check connectivity" in user_query:
        self._add_context_user_query(namespace="facts", strategy="Semantic Memory")

    # Q4: 시스템 복구 → SUMMARIZATION MEMORY
    elif "system crashed" in user_query:
        self._add_context_user_query(namespace="{session_id}", strategy="Summarization Memory")

    # 모든 메시지 자동 저장
    self.memory_client.save_conversation(...)

메모리 강화 시스템 프롬프트 (Module 2 추가분)

규칙	설명
MEMORY_INTEGRATION_RULES	메모리 컨텍스트가 있으면 도구 호출 대신 메모리 직접 사용
SUMMARIZATION_MEMORY_OVERRIDE	요약 메모리 모드에서는 dns-resolve, connectivity 도구 호출 금지
VERBATIM QUOTE RULES	메모리에 저장된 정보(권한, PathID 등)를 정확히 인용
ERROR HANDLING	스로틀링 시 메모리 기반 가이드 제공, 지수 백오프 재시도

Module 1 vs Module 3 차이: Module 1은 memory_hook=None으로 메모리 없이 동작합니다. Module 2에서 MemoryHook을 추가하면, 시스템 프롬프트에 MEMORY-ENHANCED APPROACH 섹션이 추가되고, on_message_added에서 전략별 메모리 라우팅이 활성화됩니다.

이 시점의 아키텍처

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