Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilización de la recuperación agéntica para consultar una base de conocimiento

La recuperación por agencia utiliza un modelo básico para descomponer de forma inteligente las consultas complejas en subconsultas, recuperar de forma iterativa la información relevante de las bases de conocimiento y evaluar si los resultados recuperados son suficientes para responder a la consulta original. Este enfoque mejora la precisión de la recuperación de preguntas complejas de varios pasos que tal vez no se aborden en su totalidad con una sola pasada de recuperación.

Por ejemplo, ante la pregunta «¿Qué revista se creó primero, Arthur's Magazine o First for Women?» , agentic retrieval divide esta información en subconsultas independientes, como «¿Cuándo se fundó Arthur's Magazine?» y «¿Cuándo se fundó First for Women?» , recupera los resultados de cada uno y evalúa si los resultados combinados son suficientes.

Cómo funciona la recuperación por agencia

Cuando envías una solicitud a la AgenticRetrieveStream API, se produce el siguiente proceso:

Requisitos previos

Antes de poder utilizar la recuperación por agentes, debe disponer de lo siguiente:

Consulte una base de conocimientos con acceso a través de una agencia

Para usar la recuperación por agencia, envía una solicitud. AgenticRetrieveStream La respuesta es un flujo que incluye los resultados de la recuperación y los eventos de rastreo.

En la siguiente tabla se describen los campos de solicitud de claves:

Para ver la sintaxis completa de las solicitudes y respuestas, consulta la referencia AgenticRetrieveStream de la API.

Respuesta de recuperación agencial

La AgenticRetrieveStream respuesta es una secuencia que contiene los siguientes tipos de eventos:

Utilice la AgentCore memoria con la recuperación por agencia

Puede conceder a una agencia acceso de recuperación a un recurso de Amazon Bedrock Memory. AgentCore Con el acceso a la memoria, la recuperación puede continuar con una sesión anterior y aprovechar lo que el agente ha aprendido en las sesiones anteriores. Introduzca en el memoryConfiguration campo la información memoryId de un recurso de memoria de su cuenta que se encuentre en ese ACTIVE estado.

La memoria es opcional. Un memoryConfiguration valor que solo establece un no memoryId es válido. Cuando lo suministrememoryConfiguration, debe usar el recurso de memoria al menos de una de las dos maneras siguientes:

Proporcione los espacios de nombres exactamente como están configurados en la estrategia de memoria, con los marcadores de posición ya resueltos. Por ejemplo, si la estrategia define el espacio de nombres/strategy/{memoryStrategyId}/actor/{actorId}, introduzca el valor resuelto en lugar de la plantilla. Para obtener más información sobre los espacios de nombres, las estrategias y los registros de memoria, consulte la terminología de la memoria en la guía para desarrolladores de Amazon Bedrock AgentCore .

Cuando sessionBinding esté configurado, persistenceMode utilícelo para controlar si el intercambio actual se devuelve a la sesión:

En el siguiente ejemplo, se restaura una sesión anterior, se otorga al agente acceso a la memoria a largo plazo de ese actor y se mantiene el intercambio hasta la sesión:

{
    "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"
    }
}

El flujo de respuestas informa sobre la actividad de la memoria. La restauración aparece como un evento de rastreo de carga del historial de la sesión. Los registros que devuelve la memoria a largo plazo aparecen en el evento de rastreo de recuperación con el tipo de origen deBedrockAgentCoreMemory, independientemente del paso que los haya recuperado.

La forma en que aparezca la recuperación en sí depende del momento en que se produzca. Cuando el modelo básico decide buscar en la memoria (lo habitual en una sesión continua), la recuperación aparece como una memoryRetrieve acción en el evento de rastreo de Planning. En una sesión nueva, el agente puede, en cambio, recuperar la memoria a largo plazo durante la recuperación especulativa, antes del primer paso de planificación, en cuyo caso no emite ninguna acción. memoryRetrieve Para obtener más información, consulte Respuesta de recuperación agencial.

Permisos necesarios para la recuperación por parte de la agencia

Para usar la AgenticRetrieveStream API, la identidad de IAM que realiza la llamada debe tener los siguientes permisos:

{
    "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": "*"
        }
    ]
}

Si utilizas barreras de protección con la recuperación mediante una agencia, agrega los siguientes permisos:

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

Si usas un recurso de AgentCore memoria con recuperación por agentes, agrega los siguientes permisos:

{
    "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:ListEventssolo es obligatorio cuando lo configuras. sessionBinding bedrock-agentcore:RetrieveMemoryRecordssolo es obligatorio cuando se configuraretrievalConfigs. bedrock-agentcore:CreateEventsolo se requiere cuando persistenceMode esDEFAULT.

Si el recurso de memoria está cifrado con una clave gestionada por el cliente, añada el siguiente permiso a esa clave:

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

Consideraciones

Tenga en cuenta lo siguiente cuando utilice la recuperación por agencia: