View a markdown version of this page

Crea un AgentCore recuerdo - Base amazónica AgentCore

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.

Crea un AgentCore recuerdo

Puede crear una AgentCore memoria con la AgentCore CLI, la AWS consola o con la operación del CreateMemory AWS SDK. Al crear una memoria, puede configurar opciones como el nombre, la descripción, la configuración de cifrado, la fecha de caducidad de los eventos sin procesar y las estrategias de memoria si desea extraer memoria a largo plazo.

Al crear una AgentCore memoria, ten en cuenta los siguientes factores para garantizar que cumpla con las necesidades de tu aplicación:

Retención de eventos: elija durante cuánto tiempo se conservarán los eventos sin procesar (hasta 365 días) para guardarlos en memoria a corto plazo.

nota

eventExpiryDurationse aplica por evento en el momento de la escritura. Su actualización solo afecta a los eventos creados después del cambio. Los eventos almacenados anteriormente mantienen su fecha de caducidad original y no se pueden extender, ni los eventos caducados no se pueden recuperar.

Requisitos de seguridad: si su aplicación gestiona información confidencial, considere la posibilidad de utilizar una clave de AWS KMS gestionada por el cliente para el cifrado. El servicio sigue cifrando los datos mediante una clave gestionada por el servicio, aunque no proporciones una clave de KMS gestionada por el cliente AWS .

Estrategias de memoria: defina cómo se procesan los eventos para convertirlos en memorias significativas a largo plazo mediante estrategias integradas o integradas con anulaciones. Si no define ninguna estrategia, solo se almacena la memoria a corto plazo que contiene eventos sin procesar. Para obtener más información, consulte Uso de la memoria a largo plazo.

Convenciones de nomenclatura: utilice nombres claros y descriptivos que ayuden a identificar el propósito de cada AgentCore memoria, especialmente si la aplicación usa varios almacenes.

ejemplo
AgentCore CLI

  1. Los comandos de memoria de la AgentCore CLI se deben ejecutar dentro de un proyecto de agentcore existente. Si aún no tienes uno, primero crea un proyecto:

    agentcore create --project-name MemoryProject --no-agent
cd MemoryProject

    Crea una memoria básica (solo a corto plazo):

    agentcore add memory --name my_agent_memory
agentcore deploy

    Cree memoria con estrategias a largo plazo:

    agentcore add memory --name ShoppingSupportAgentMemory \
  --strategies SUMMARIZATION,USER_PREFERENCE
agentcore deploy

    Compruebe el estado de la memoria:

    agentcore status
Interactive

  1. Ejecute agentcore para abrir la TUI, luego seleccione agregar y elija Memoria:

  2. Introduzca el nombre de la memoria:

    Asistente de memoria: introduzca el nombre

  3. Seleccione la duración de caducidad del evento:

    Asistente de memoria: seleccione la duración de caducidad del evento

  4. Elija estrategias de memoria para la extracción de memoria a largo plazo:

    Asistente de memoria: seleccione estrategias de memoria

  5. Revise la configuración y pulse Entrar para confirmar:

    Asistente de memoria: revise la configuración
AWS SDK

  1. Para obtener más información, consulte SDK de AWS.

    import boto3
import time

# Initialize the Boto3 clients for control plane and data plane operations
control_client = boto3.client('bedrock-agentcore-control')
data_client = boto3.client('bedrock-agentcore')

print("Creating a new memory resource...")

# Create the memory resource with defined strategies
response = control_client.create_memory(
    name="ShoppingSupportAgentMemory",
    description="Memory for a customer support agent.",
    memoryStrategies=[
        {
            'summaryMemoryStrategy': {
                'name': 'SessionSummarizer',
                'namespaceTemplates': ['/summaries/{actorId}/{sessionId}/']
            }
        },
        {
            'userPreferenceMemoryStrategy': {
                'name': 'UserPreferenceExtractor',
                'namespaceTemplates': ['/users/{actorId}/preferences/']
            }
        }
    ]
)

memory_id = response['memory']['id']
print(f"Memory resource created with ID: {memory_id}")

# Poll the memory status until it becomes ACTIVE
while True:
    mem_status_response = control_client.get_memory(memoryId=memory_id)
    status = mem_status_response.get('memory', {}).get('status')
    if status == 'ACTIVE':
        print("Memory resource is now ACTIVE.")
        break
    elif status == 'FAILED':
        raise Exception("Memory resource creation FAILED.")
    print("Waiting for memory to become active...")
    time.sleep(10)
Console

  1. ====== Para crear una memoria AgentCore

  2. Abra la consola de Amazon Bedrock AgentCore.

  3. En el panel de navegación izquierdo, selecciona Memoria.

  4. Selecciona Crear memoria.

  5. En Nombre de la memoria, introduzca un nombre para la AgentCore memoria.

  6. (Opcional) En caso de caducidad de la Short-term memoria (evento sin procesar), defina la duración (días) durante la cual la AgentCore memoria almacenará los eventos.

  7. (Opcional) En Configuraciones adicionales, defina lo siguiente:

    1. Para la descripción de la memoria, introduzca una descripción para la AgentCore memoria.

    2. Si desea usar su propia clave de AWS KMS para cifrar los datos, haga lo siguiente:

      1. En la clave KMS, elija Personalizar la configuración de cifrado (avanzada).

      2. En Elegir una clave de AWS KMS, elija o introduzca el ARN de una clave de AWS KMS existente. También puede elegir Crear un AWS KMS para crear una nueva clave de AWS KMS.

  8. (Opcional) Para las estrategias de extracción de Long-term memoria, elija una o más estrategias de memoria. Para obtener más información:

  9. Seleccione Crear memoria para crear la AgentCore memoria.

Temas