기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

에이전틱 검색을 사용하여 지식 베이스 쿼리

에이전트 검색은 파운데이션 모델을 사용하여 복잡한 쿼리를 하위 쿼리로 지능적으로 분해하고, 지식 기반에서 관련 정보를 반복적으로 검색하고, 검색된 결과가 원래 쿼리에 응답하기에 충분한지 평가합니다. 이 접근 방식은 단일 검색 패스가 완전히 해결하지 못할 수 있는 복잡한 다단계 질문의 검색 정확도를 개선합니다.

예를 들어, "어떤 잡지가 처음 시작되었는지, Arthur's™ 또는 First for Women?" 쿼리가 주어지면 에이전트 검색은 이를 "Athur's™가 언제 설립되었나요?"와 같은 별도의 하위 쿼리로 나눕니다. 및 "First for 우먼이 설립된 시기"는 각각에 대한 결과를 검색하고 결합된 결과가 충분한지 평가합니다.

에이전트 검색 작동 방식

AgenticRetrieveStream API에 요청을 보내면 다음 프로세스가 수행됩니다.

사전 조건

에이전트 검색을 사용하려면 먼저 다음이 있어야 합니다.

에이전트 검색으로 지식 기반 쿼리

에이전트 검색을 사용하려면 AgenticRetrieveStream 요청을 보냅니다. 응답은 검색 결과 및 추적 이벤트를 포함하는 스트림입니다.

다음 표에서는 키 요청 필드를 설명합니다.

전체 요청 및 응답 구문은 API 참조AgenticRetrieveStream의 섹션을 참조하세요.

에이전트 검색 응답

AgenticRetrieveStream 응답은 다음 이벤트 유형을 포함하는 스트림입니다.

에이전트 검색과 함께 AgentCore 메모리 사용

Amazon Bedrock AgentCore 메모리 리소스에 대한 에이전트 검색 액세스 권한을 부여할 수 있습니다. 메모리 액세스를 사용하면 검색을 통해 이전 세션을 계속하고 에이전트가 이전 세션에서 학습한 내용을 활용할 수 있습니다. 계정에 상태인 메모리 리소스memoryId의를 memoryConfiguration 필드에 제공합니다ACTIVE.

메모리는 선택 사항입니다. 만 memoryConfiguration 설정하는 memoryId는 유효하지 않습니다. 를 제공할 때 다음 두 가지 방법 중 하나 이상에서 메모리 리소스를 사용해야 memoryConfiguration합니다.

자리 표시자가 이미 확인된 상태에서 메모리 전략에 구성된 그대로 네임스페이스를 제공합니다. 예를 들어 전략이 네임스페이스를 정의하는 경우 템플릿 대신 확인된 값을 /strategy/{memoryStrategyId}/actor/{actorId}제공합니다. 네임스페이스, 전략 및 메모리 레코드에 대한 자세한 내용은 Amazon Bedrock AgentCore 개발자 안내서의 메모리 용어를 참조하세요.

sessionBinding이 설정되면 persistenceMode를 사용하여 현재 교환이 세션에 다시 기록되는지 여부를 제어합니다.

다음 예시에서는 이전 세션을 복원하고, 에이전트에게 해당 액터의 장기 메모리에 대한 액세스 권한을 부여하고, 교환을 세션으로 다시 유지합니다.

{
    "messages": [
        {
            "content": {
                "text": "What did we decide about the migration timeline?"
            },
            "role": "user"
        }
    ],
    "retrievers": [
        {
            "configuration": {
                "knowledgeBase": {
                    "knowledgeBaseId": "KB12345678"
                }
            }
        }
    ],
    "agenticRetrieveConfiguration": {
        "foundationModelType": "MANAGED",
        "rerankingModelType": "MANAGED"
    },
    "memoryConfiguration": {
        "memoryId": "projectAssistantMemory-1a2b3c4d5e",
        "sessionBinding": {
            "actorId": "user-123",
            "sessionId": "session-456"
        },
        "retrievalConfigs": [
            {
                "namespace": "/strategy/summarization-1a2b3c4d5e/actor/user-123"
            }
        ],
        "persistenceMode": "DEFAULT"
    }
}

응답 스트림은 메모리 활동을 보고합니다. 복원은 세션 기록 로드 추적 이벤트로 표시됩니다. 장기 메모리가 반환하는 레코드는 소스 유형이 인 검색 추적 이벤트BedrockAgentCoreMemory, 검색된 단계에 표시됩니다.

검색 자체가 나타나는 방식은 언제 나타나는지에 따라 달라집니다. 파운데이션 모델이 메모리를 검색하도록 선택하면(일반적으로 지속적인 세션에서) 검색이 추적 계획 이벤트에 대한 memoryRetrieve 작업으로 나타납니다. 새 세션에서 에이전트는 투기 검색 중에 첫 번째 계획 단계 전에 장기 메모리를 대신 검색할 수 있습니다.이 경우 아무 memoryRetrieve 작업도 내보내지 않습니다. 자세한 내용은 에이전트 검색 응답 단원을 참조하십시오.

에이전트 검색에 필요한 권한

AgenticRetrieveStream API를 사용하려면 호출 IAM 자격 증명에 다음 권한이 있어야 합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock:AgenticRetrieveStream",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:GetDocumentContent"
            ],
            "Resource": "arn:aws:bedrock:region:account-id:knowledge-base/*"
        },
        {
            "Effect": "Allow",
            "Action": "bedrock:InvokeModelWithResponseStream",
            "Resource": "*"
        }
    ]
}

에이전트 검색과 함께 가드레일을 사용하는 경우 다음 권한을 추가합니다.

{
    "Effect": "Allow",
    "Action": [
        "bedrock:GetGuardrail",
        "bedrock:ApplyGuardrail"
    ],
    "Resource": "*"
}

에이전트 검색과 함께 AgentCore 메모리 리소스를 사용하는 경우 다음 권한을 추가합니다.

{
    "Effect": "Allow",
    "Action": [
        "bedrock-agentcore:GetMemory",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords",
        "bedrock-agentcore:CreateEvent"
    ],
    "Resource": "arn:aws:bedrock-agentcore:region:account-id:memory/memory-id"
}

bedrock-agentcore:ListEvents는를 설정한 경우에만 필요합니다sessionBinding. bedrock-agentcore:RetrieveMemoryRecords는를 설정한 경우에만 필요합니다retrievalConfigs. bedrock-agentcore:CreateEvent는 persistenceMode가 인 경우에만 필요합니다DEFAULT.

메모리 리소스가 고객 관리형 키로 암호화된 경우 해당 키에 대해 다음 권한을 추가합니다.

{
    "Effect": "Allow",
    "Action": "kms:Decrypt",
    "Resource": "arn:aws:kms:region:account-id:key/key-id"
}

고려 사항

에이전트 검색을 사용할 때는 다음 사항에 유의하세요.