자체 관리형 전략

Amazon Bedrock AgentCore 메모리의 자체 관리형 전략을 사용하면 메모리 추출 및 통합 파이프라인을 완벽하게 제어할 수 있습니다. 자체 관리형 전략을 사용하면 Amazon Bedrock AgentCore를 스토리지 및 검색에 활용하면서 사용자 지정 메모리 처리 워크플로를 구축할 수 있습니다.

배치 작업( BatchCreateMemoryRecords , BatchUpdateMemoryRecords , BatchDeleteMemoryRecords )과 함께 자체 관리형 전략을 사용하면 검색 기능을 위해 이러한 추출된 레코드를 Amazon Bedrock AgentCore 메모리에 직접 수집할 수 있습니다.

자체 관리형 전략을 사용하면 다음을 수행할 수 있습니다.

자체 관리형 전략 생성 및 사용

자체 관리형 전략은 트리거 구성에서 메모리 레코드 스토리지에 이르는 5단계 프로세스를 따릅니다.

사전 조건

자체 관리형 전략을 설정하기 전에 다음이 있는지 확인합니다.

인프라 설정

Amazon Bedrock AgentCore가 AWS 리소스에 액세스하는 데 필요한 S3 버킷, SNS 주제 및 IAM 역할을 포함한 필수 리소스를 생성합니다.

1단계: S3 버킷 생성

Amazon Bedrock AgentCore가 일괄 이벤트 페이로드를 전송할 계정에 S3 버킷을 생성합니다.

2단계: SNS 주제 생성

작업 알림을 위한 SNS 주제를 생성합니다. 세션 내 처리 순서가 사용 사례에 중요한 경우 FIFO 주제를 사용합니다.

3단계 - IAM 역할 생성

Amazon Bedrock AgentCore가 리소스에 액세스하기 위해 수임할 수 있는 IAM 역할을 생성합니다.

신뢰 정책

다음 신뢰 정책을 사용합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "bedrock-agentcore.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:bedrock-agentcore:<region>:<account-id>:memory/*"
                }
            }
        }
    ]
}

권한 정책

다음 권한 정책을 사용합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "S3PayloadDelivery",
            "Effect": "Allow",
            "Action": [
                "s3:GetBucketLocation",
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::your-agentcore-payloads-bucket",
                "arn:aws:s3:::your-agentcore-payloads-bucket/*"
            ]
        },
        {
            "Sid": "SNSNotifications",
            "Effect": "Allow",
            "Action": [
                "sns:GetTopicAttributes",
                "sns:Publish"
            ],
            "Resource": "arn:aws:sns:us-east-1:123456789012:agentcore-memory-jobs"
        }
    ]
}

추가 KMS 권한(암호화된 리소스를 사용하는 경우)

암호화된 리소스를 사용하는 경우 다음 KMS 권한을 추가합니다.

{
    "Sid": "KMSPermissions",
    "Effect": "Allow",
    "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
    ],
    "Resource": "arn:aws:kms:us-east-1:123456789012:key/your-key-id"
}

자체 관리형 전략 생성

Amazon Bedrock AgentCore 컨트롤 플레인 APIs를 사용하여 자체 관리형 전략으로 AgentCore 메모리를 생성하거나 업데이트합니다.

필수 권한

IAM 사용자 또는 역할에 다음이 필요합니다.

자체 관리형 전략을 사용하여 AgentCore 메모리 생성

AWS SDK CreateMemory 작업을 사용하여 자체 관리형 전략이 있는 AgentCore 메모리를 생성합니다.

aws bedrock-agentcore-control create-memory \
  --name "MyCustomMemory" \
  --description "Memory with self-managed extraction strategy" \
  --memory-execution-role-arn "arn:aws:iam::123456789012:role/AgentCoreMemoryRole" \
  --event-expiry-duration 90 \
  --memory-strategies '[
    {
      "customMemoryStrategy": {
        "name": "SelfManagedExtraction",
        "description": "Custom extraction strategy",
        "configuration": {
          "selfManagedConfiguration": {
            "triggerConditions": [
              {
                "messageBasedTrigger": {
                  "messageCount": 6
                }
              },
              {
                "tokenBasedTrigger": {
                  "tokenCount": 1000
                }
              },
              {
                "timeBasedTrigger": {
                  "idleSessionTimeout": 30
                }
              }
            ],
            "historicalContextWindowSize": 2,
            "invocationConfiguration": {
              "payloadDeliveryBucketName": "your-agentcore-payloads-bucket",
              "topicArn": "arn:aws:sns:us-east-1:123456789012:agentcore-memory-jobs"
            }
          }
        }
      }
    }
  ]'

페이로드 전송 이해

트리거 조건이 충족되면 Amazon Bedrock AgentCore는 특정 스키마를 사용하여 알림 및 페이로드를 보냅니다.

SNS 알림 메시지

{
  "jobId": "unique-job-identifier",
  "s3PayloadLocation": "s3://bucket/path/to/payload.json",
  "memoryId": "your-memory-id",
  "strategyId": "your-strategy-id"
}

S3 페이로드 구조

{
  "requestId": "request-identifier",
  "accountId": "123456789012",
  "memoryId": "your-memory-id",
  "actorId": "user-or-agent-id",
  "sessionId": "conversation-session-id",
  "strategyId": "your-strategy-id",
  "startingTimestamp": 1634567890,
  "endingTimestamp": 1634567920,
  "currentContext": [
    {
      "role": "USER",
      "content": {
        "text": "User message content"
      }
    },
    {
      "role": "ASSISTANT",
      "content": {
        "text": "Assistant response"
      }
    }
  ],
  "historicalContext": [
    {
      "role": "USER",
      "content": {
        "text": "User message content"
      }
    },
    {
      "role": "ASSISTANT",
      "content": {
        "text": "Previous assistant response"
      }
    },
    {
      "blob": "{}",
    }
  ]
}

사용자 지정 파이프라인 구축

이 섹션에서는 AWS Lambda 및 SQS를 사용하여 자체 관리형 메모리 처리 파이프라인을 구축하는 한 가지 방법을 보여줍니다. 이는 한 가지 예에 불과합니다. 요구 사항을 충족하는 모든 컴퓨팅 플랫폼(EC2, ECS, Fargate), 로직 및 처리 프레임워크를 사용하여 파이프라인을 구현할 수 있습니다.

1단계: 컴퓨팅 설정

2단계: 파이프라인 처리

다음 예제 파이프라인은 네 가지 주요 구성 요소로 구성됩니다.

구현 테스트

예: 테스트 이벤트 생성

aws bedrock-agentcore create-event \
  --memory-id "your-memory-id" \
  --actor-id "test-user" \
  --session-id "test-session-1" \
  --event-timestamp "2024-01-15T10:00:00Z" \
  --payload '[{
    "conversational": {
      "content": {"text": "I prefer Italian restaurants with outdoor seating"},
      "role": "USER"
    }
  }]'

예: 메모리 레코드 검색

# List records belonging to a specific namespace
aws bedrock-agentcore list-memory-records \
  --memory-id "your-memory-id" \
  --namespace "/actor/Jane/" # lists all records present in the given namespace

# List records belonging to a particular namespace hierarchy
aws bedrock-agentcore list-memory-records \
  --memory-id "your-memory-id" \
  --namespace-path "/" # lists all records present under the namespace hierarchy

모범 사례

자체 관리형 전략을 구현할 때 성능, 신뢰성, 비용 최적화 및 보안에 대한 다음 모범 사례를 따르세요.

성능 및 안정성

비용 최적화

처리 고려 사항

보안