View a markdown version of this page

Memoria - Base amazónica AgentCore
Cómo funciona la memoriaMemoria gestionadaAgregue la memoria existente (BYO)Desactiva la memoriaPer-user alcance de la memoria con ID de actorLong-term recuperación de memoriaTruncamiento del contexto

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.

Memoria

Cuando la memoria está habilitada, el arnés conserva el estado de conversación en AgentCore la memoria. En las siguientes invocaciones con el mismo identificador de sesión, el agente carga el historial almacenado antes de razonar.

Cómo funciona la memoria

  • Short-term la memoria captura los eventos sin procesar (mensajes, llamadas a herramientas) dentro de una sesión. Esto es lo que le da al agente continuidad a lo largo de los turnos.

  • Long-term la memoria extrae conocimientos duraderos mediante estrategias configurables (semánticas, de resumen, de preferencias del usuario , episódicas o personalizadas) y los hace recuperables mediante una búsqueda semántica en sesiones posteriores.

  • El identificador de actor identifica la entidad que interactúa con el agente (un usuario, otro agente o un sistema). Los eventos de memoria están delimitados por ActorID + SessionID, por lo que cada actor tiene una memoria aislada. Long-term retrieval usa actorID como variable de plantilla en las rutas de los espacios de nombres (por ejemplo) y se asigna a las estrategias de memoria configuradas. /summary/{actorId}/{sessionId}/

Memoria gestionada

Cuando creas un arnés directamente con la API de servicio y omites la configuración de la memoria, el servicio aprovisiona la memoria gestionada. La AgentCore CLI usa un valor predeterminado diferente: los nuevos arneses de la CLI tienen la memoria deshabilitada, a menos que seleccione una memoria administrada o un recurso de memoria existente.

Cargos de memoria

No hay ningún cargo adicional por el arnés en sí. La memoria gestionada incurre en cargos de AgentCore memoria estándar por eventos a corto plazo, registros de memoria almacenados a largo plazo y solicitudes de recuperación. Para evitar que se cargue la memoria de forma persistente, desactive la memoria al crear el arnés. Para obtener más información, consulte Comprenda los costos del arnés los AgentCore precios de Amazon Bedrock.

Para personalizar la memoria gestionada en el momento de la creación:

ejemplo
AWS CLI/boto3
aws bedrock-agentcore-control create-harness \
  --harness-name "MyHarness" \
  --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole" \
  --memory '{"managedMemoryConfiguration": {"strategies": ["SEMANTIC", "SUMMARIZATION", "USER_PREFERENCE"], "eventExpiryDuration": 60}}'

Para actualizar las estrategias de un arnés existente:

aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --memory '{"optionalValue": {"managedMemoryConfiguration": {"strategies": ["SEMANTIC", "SUMMARIZATION", "USER_PREFERENCE", "EPISODIC"]}}}'
AgentCore CLI

Crea un proyecto vacío y, a continuación, añade un arnés con memoria gestionada:

agentcore create --project-name MyHarnessProject --no-agent
cd MyHarnessProject
agentcore add harness \
  --name myagent \
  --memory-mode managed \
  --memory-strategies SEMANTIC,SUMMARIZATION \
  --memory-event-expiry-days 30
agentcore deploy

La memoria está deshabilitada de forma predeterminada. Para crear el arnés sin memoria, ejecute el siguiente comando en lugar del anterioragentcore add harness:

agentcore add harness --name myagent --no-memory
Interactive

Ejecute agentcore en un directorio de proyecto, seleccione agregar y, a continuación, elija Harness. El asistente incluye un paso de memoria.

  1. En el paso Memoria, seleccione Sin memoria persistente o Activado para crear memoria persistente para el arnés.

    Paso de memoria: No hay memoria persistente o está habilitada

  2. Cuando la memoria está habilitada, aparece una opción de ajuste de memoria adicional en la configuración avanzada. Actívala con la barra espaciadora y pulsa Entrar para recuperar la afinación.

    Configuración avanzada: opción de ajuste de memoria

  3. Si lo desea, puede configurar el recuento de mensajes, los K más altos de recuperación y la puntuación de relevancia (cada uno se puede omitir).

    Ajuste de memoria: recuento de mensajes, K más alto, puntuación de relevancia

Confirme el asistente y, a continuación, ejecútelo agentcore deploy para solicitarlo.

La memoria gestionada está totalmente gestionada por el arnés:

  • La configuración de la estrategia se controla de forma exhaustivaUpdateHarness. Aún puede consultar read/write los eventos y los registros directamente a través de las API de memoria.

  • La memoria gestionada no se puede eliminar directamente a través de las API de memoria. Para convertir la memoria gestionada en un recurso de AgentCore memoria normal, puede desasociarla del arnés de dos maneras:

    • UpdateHarnessUtilícelo para cambiar a BYO (agentCoreMemoryConfiguration) o deshabilitarlo.

    • deleteManagedMemory=falseEn su lugar, transfiera la eliminación para desvincularla: DeleteHarness elimina en cascada la memoria gestionada de forma predeterminada.

Estrategias disponibles

Strategy (Estrategia) Description (Descripción)

SEMANTIC

Extrae el conocimiento fáctico de las conversaciones, que se puede recuperar mediante una búsqueda semántica.

SUMMARIZATION

Crea resúmenes continuos de las conversaciones, desglosados por actor y sesión.

USER_PREFERENCE

Captura las preferencias y ajustes del usuario expresados durante las conversaciones.

EPISODIC

Registra eventos y experiencias importantes como episodios discretos.

Agregue la memoria existente (BYO)

Si necesita una configuración avanzada que vaya más allá de la que ofrece la memoria gestionada (plantillas de espacio de nombres personalizadas, cifrado de KMS o memoria compartida en varios arneses), adjunte una instancia de AgentCore memoria existente en su lugar.

ejemplo
AWS CLI/boto3

Crea una instancia de memoria:

aws bedrock-agentcore-control create-memory \
  --name "MyMemory" \
  --event-expiry-duration 30 \
  --description "Memory for my harness"

Colócalo en el arnés:

aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --memory '{"optionalValue": {"agentCoreMemoryConfiguration": {"arn": "arn:aws:bedrock-agentcore:us-west-2:123456789012:memory/MyMemory-abc123"}}}'
AgentCore CLI
agentcore create --project-name MyHarnessProject --no-agent
cd MyHarnessProject
agentcore add harness --name myagent \
  --memory-arn "arn:aws:bedrock-agentcore:us-west-2:123456789012:memory/MyMemory-abc123"
agentcore deploy

Desactiva la memoria

Para deshabilitar la memoria por completo:

aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --memory '{"optionalValue": {"disabled": {}}}'

Per-user alcance de la memoria con ID de actor

Pase actorId en el momento de la invocación para asignar la memoria a un usuario específico. Cada actor obtiene una memoria aislada a corto y largo plazo:

response = client.invoke_harness(
    harnessArn=HARNESS_ARN,
    runtimeSessionId=SESSION_ID,
    actorId="user-123",
    messages=[{"role": "user", "content": [{"text": "What do you remember about my preferences?"}]}],
)

Long-term recuperación de memoria

Cuando un arnés tiene estrategias de memoria activas (gestionadas o BYO), la recuperación se realiza automáticamente: el arnés obtiene una configuración de recuperación a partir de las estrategias activas de la instancia de memoria. En cada invocación, el agente consulta los recuerdos relevantes a largo plazo y los inyecta en el contexto de la conversación antes de razonar.

Comportamiento predeterminado:

  • La recuperación se configura automáticamente con los parámetros predeterminados (topK=10,relevanceScore=0.2) para el espacio de nombres de cada estrategia activa.

  • No se necesita ninguna configuración manual para la memoria gestionada o BYO.

Anule los valores predeterminados: si proporciona explícitamente una retrievalConfig en la configuración de memoria BYO, sus valores tienen prioridad y no se produce ninguna derivación automática. Esto le permite personalizar los espacios de nombres que se consultan, ajustar topK o relevanceScore deshabilitar la recuperación para estrategias específicas.

aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --memory '{"optionalValue": {"agentCoreMemoryConfiguration": {"arn": "arn:aws:bedrock-agentcore:us-west-2:123456789012:memory/MyMemory-abc123", "retrievalConfig": {"/facts/{actorId}/": {"topK": 5, "relevanceScore": 0.5, "strategyId": "FactExtractor-abc123"}}}}}'
importante

Si actualizas las estrategias de tu instancia de memoria BYO (agregar o eliminar) después de conectarla a un arnés, llama UpdateHarness para actualizar la configuración de recuperación. En el caso de la memoria gestionada, la estrategia cambia mediante la UpdateHarness actualización automática de la configuración.

Truncamiento del contexto

Cuando el historial de conversaciones supera la ventana de contexto del modelo, el arnés aplica una estrategia de truncamiento. Configure esto en el arnés o anule por invocación.

  • sliding_window(predeterminado): conserva los N mensajes más recientes. Simple y predecible.

  • summarization- comprime los mensajes antiguos en un resumen, preservando más contexto en menos fichas.

  • none- sin truncamiento. Úselo solo si administra usted mismo el tamaño del contexto.

aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --truncation '{"strategy": "sliding_window", "slidingWindowConfig": {"numMessages": 30}}'

Más información: AgentCore memoria, creación de un almacén de memoria, estrategias de memoria a largo plazo.

Temas relacionados