실패한 수집 리드라이브
단기 메모리에서 장기 메모리로의 추출은 일반적으로 자동입니다. 어떤 이유로든 단기 메모리에서 장기 메모리로의 추출이 실패하면 AgentCore 메모리는 문제를 해결하려고 시도합니다. 문제가 지속되면 개발자 개입이 필요할 수 있으며 실패한 작업은 메모리 리소스의 전용 대기열로 이동합니다. 한 가지 예는 계정이 허용되는 것보다 빠른 속도로 장기 메모리에 수집하는 경우입니다. 이 경우 트래픽이 낮아질 때까지 기다렸다가 영향을 받는 작업을 수동으로 리드라이브해야 합니다.
를 호출ListMemoryExtractionJobs하여 실패한 작업을 확인하고 실패 사유 코드를 확인하여 실패 이유를 확인할 수 있습니다. 를 호출StartMemoryExtractionJobs하여 작업을 장기 메모리에 다시 수집합니다. 벤딩된 지표를 모니터링FailedExtraction하여 문제를 알리는 것이 좋습니다. 이 지표에는 StrategyId, Resource(메모리 ARN) 및 StrategyType에 대한 차원도 있습니다. AgentCore 메모리는 추출 작업이 실패하고 추출 작업 스토리지에 기록될 때마다이 지표 수를 내보냅니다.
기본 제공 전략의 경우 유일한 실패 시나리오는 수집 한도에 도달하는 것입니다. 기본 제공 재정의를 사용하는 경우 계정에서 사용하도록 선택한 모델 또는 AgentCore 메모리에 부여한 권한과 관련된 문제를 포함하여 추가 장애 시나리오가 있습니다.
| 실패 사유 코드 | 설명 | 권장 완화 조치 |
|---|---|---|
|
|
이 계정이 장기 메모리 처리를 위해 할당된 분당 토큰 할당량을 초과했습니다. |
Service Quotas를 통해 Bedrock Agentcore 할당량 "장기 메모리 추출을 위한 분당 토큰"에 대한 더 높은 제한을 요청합니다. 그런 다음 실패한 추출의 jobID에서 StartMemoryExtractionJob API를 호출합니다. |
|
|
CreateMemory 중에 제공된 memoryExecutionRoleArn에는 메모리에 연결된 사용자 지정 전략에 제공된 모든 모델 IDs를 호출할 수 있는 적절한 권한이 없습니다. |
역할에 여기에 정의된 권한 및 신뢰 정책이 있는지 확인하고 누락된 권한을 추가합니다. 또는 UpdateMemory를 호출하여 적절한 권한이 있는 다른 역할로 전환합니다. 그런 다음 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출합니다. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 내부 오류를 수신했습니다. |
Bedrock의 일시적인 서비스 오류일 수 있습니다. 나중에 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출하여 다시 시도하세요. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 제한 예외를 수신했습니다. |
계정이 Bedrock에서 해당 모델에 대한 적절한 TPM 및 RPM 할당량을 요청했는지 확인합니다. 할당량 증가 후 또는 트래픽이 적은 시간에 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출합니다. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 모델 오류 예외를 수신했습니다. |
이는 일반적으로 Bedrock의 일시적인 서비스 오류입니다. 나중에 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출하여 다시 시도하세요. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 모델 제한 시간 예외를 수신했습니다. |
이는 모델 처리 시간이 제한 시간을 초과할 때 발생합니다. 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출하기 전에 더 빠른 모델로 전환하는 것이 좋습니다. |
|
|
사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 리소스를 찾을 수 없습니다. |
메모리와 연결된 사용자 지정 전략에 제공된 modelID가 올바른지 확인합니다. 필요한 경우 UpdateMemory를 호출하여 해당 값을 업데이트합니다. 그런 다음 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출합니다. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 모델 준비 안 됨을 수신했습니다. |
모델이 준비 상태가 될 때까지 기다립니다. 자세한 내용은 Bedrock 설명서를 참조하세요. 그런 다음 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출합니다. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 서비스 사용 불가를 수신했습니다. |
이는 일반적으로 Bedrock의 일시적인 서비스 오류입니다. 나중에 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출하여 다시 시도하세요. |
|
|
서비스가 사용자 지정 전략에 제공된 모델을 호출하려고 할 때 Bedrock에서 검증 예외를 수신했습니다. |
메모리와 연결된 사용자 지정 전략에 제공된 modelID가 올바른지 확인합니다. 필요한 경우 UpdateMemory를 호출하여 해당 값을 업데이트합니다. 그런 다음 실패한 추출의 jobID에서 StartMemoryExtractionJobs API를 호출합니다. |
