View a markdown version of this page

AgentCore 메모리 생성 - Amazon Bedrock AgentCore

AgentCore 메모리 생성

AgentCore CLI, AWS 콘솔 또는 CreateMemory AWS SDK 작업을 사용하여 AgentCore 메모리를 생성할 수 있습니다. 메모리를 생성할 때 장기 메모리를 추출하려는 경우 이름, 설명, 암호화 설정, 원시 이벤트의 만료 타임스탬프, 메모리 전략과 같은 설정을 구성할 수 있습니다.

AgentCore 메모리를 생성할 때 애플리케이션의 요구 사항을 충족하기 위해 다음 요소를 고려하세요.

이벤트 보존 - 단기 메모리에 대해 원시 이벤트가 보존되는 기간(최대 365일)을 선택합니다.

참고

eventExpiryDuration는 쓰기 시 이벤트별로 적용됩니다. 업데이트는 변경 후 생성된 이벤트에만 영향을 줍니다. 이전에 저장된 이벤트는 원래 만료를 유지하고 연장할 수 없으며 만료된 이벤트는 복구할 수 없습니다.

보안 요구 사항 - 애플리케이션이 민감한 정보를 처리하는 경우 암호화에 고객 관리형 AWS KMS 키를 사용하는 것이 좋습니다. 고객 관리형 AWS KMS 키를 제공하지 않더라도 서비스는 여전히 서비스 관리형 키를 사용하여 데이터를 암호화합니다.

메모리 전략 - 재정의 전략이 포함된 내장 또는 내장을 사용하여 이벤트를 의미 있는 장기 메모리로 처리하는 방법을 정의합니다. 전략을 정의하지 않으면 원시 이벤트가 포함된 단기 메모리만 저장됩니다. 자세한 내용은 장기 메모리 사용을 참조하세요.

명명 규칙 - 특히 애플리케이션에서 여러 스토어를 사용하는 경우 각 AgentCore 메모리의 목적을 식별하는 데 도움이 되는 명확하고 설명이 포함된 이름을 사용합니다.

예
AgentCore CLI

  1. AgentCore CLI 메모리 명령은 기존 agentcore 프로젝트 내에서 실행해야 합니다. 아직 프로젝트가 없는 경우 먼저 프로젝트를 생성합니다.

    agentcore create --name my-agent --no-agent
cd my-agent

    기본 메모리 생성(단기만 해당):

    agentcore add memory --name my_agent_memory
agentcore deploy

    장기 전략을 사용하여 메모리를 생성합니다.

    agentcore add memory --name ShoppingSupportAgentMemory \
  --strategies SUMMARIZATION,USER_PREFERENCE
agentcore deploy

    메모리 상태 확인:

    agentcore status
Interactive

  1. 를 실행agentcore하여 TUI를 연 다음 추가를 선택하고 메모리를 선택합니다.

  2. 메모리 이름을 입력합니다.

    메모리 마법사: 이름 입력

  3. 이벤트 만료 기간을 선택합니다.

    메모리 마법사: 이벤트 만료 기간 선택

  4. 장기 메모리 추출을 위한 메모리 전략 선택:

    메모리 마법사: 메모리 전략 선택

  5. 구성을 검토하고 Enter 키를 눌러 확인합니다.

    메모리 마법사: 구성 검토
AWS SDK

  1. 자세한 내용은 AWS SDK를 참조하세요.

    import boto3
import time

# Initialize the Boto3 clients for control plane and data plane operations
control_client = boto3.client('bedrock-agentcore-control')
data_client = boto3.client('bedrock-agentcore')

print("Creating a new memory resource...")

# Create the memory resource with defined strategies
response = control_client.create_memory(
    name="ShoppingSupportAgentMemory",
    description="Memory for a customer support agent.",
    memoryStrategies=[
        {
            'summaryMemoryStrategy': {
                'name': 'SessionSummarizer',
                'namespaceTemplates': ['/summaries/{actorId}/{sessionId}/']
            }
        },
        {
            'userPreferenceMemoryStrategy': {
                'name': 'UserPreferenceExtractor',
                'namespaceTemplates': ['/users/{actorId}/preferences/']
            }
        }
    ]
)

memory_id = response['memory']['id']
print(f"Memory resource created with ID: {memory_id}")

# Poll the memory status until it becomes ACTIVE
while True:
    mem_status_response = control_client.get_memory(memoryId=memory_id)
    status = mem_status_response.get('memory', {}).get('status')
    if status == 'ACTIVE':
        print("Memory resource is now ACTIVE.")
        break
    elif status == 'FAILED':
        raise Exception("Memory resource creation FAILED.")
    print("Waiting for memory to become active...")
    time.sleep(10)
Console

  1. ====== AgentCore 메모리를 생성하려면

  2. Amazon Bedrock AgentCore 콘솔을 엽니다.

  3. 왼쪽 탐색 창에서 메모리를 선택합니다.

  4. 메모리 생성을 선택합니다.

  5. 메모리 이름에 AgentCore 메모리의 이름을 입력합니다.

  6. (선택 사항) 단기 메모리(원시 이벤트) 만료의 경우 AgentCore 메모리가 이벤트를 저장할 기간(일)을 설정합니다.

  7. (선택 사항) 추가 구성에서 다음을 설정합니다.

    1. 메모리 설명에 AgentCore 메모리에 대한 설명을 입력합니다.

    2. 자체 AWS KMS 키를 사용하여 데이터를 암호화하려면 다음을 수행합니다.

      1. KMS 키에서 암호화 설정 사용자 지정(고급)을 선택합니다.

      2. AWS KMS 키 선택에서 기존 AWS KMS 키의 ARN을 선택하거나 입력합니다. 또는 AWS KMS 생성을 선택하여 새 AWS KMS 키를 생성합니다.

  8. (선택 사항) 장기 메모리 추출 전략에서 하나 이상의 메모리 전략을 선택합니다. 자세한 내용:

  9. 메모리 생성을 선택하여 AgentCore 메모리를 생성합니다.

주제