View a markdown version of this page

Crea un AgentCore recuerdo - Amazon Bedrock AgentCore

Crea un AgentCore recuerdo

Puede crear una AgentCore memoria con la AgentCore CLI, la AWS consola o la operación del CreateMemory AWS SDK. Al crear una memoria, puede configurar parámetros como el nombre, la descripción, los ajustes 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, tenga en cuenta los siguientes factores para garantizar que cumpla con las necesidades de la aplicación:

Retención de eventos: elija cuánto tiempo se retienen los eventos sin procesar (hasta 365 días) para la 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 caducidad original y no se pueden extender, y 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 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 KMS gestionada por el cliente AWS .

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

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

ejemplo
AgentCore CLI

  1. Los comandos de memoria AgentCore CLI deben ejecutarse dentro de un proyecto agentcore existente. Si aún no tiene uno, cree primero un proyecto:

    agentcore create --name my-agent --no-agent
cd my-agent

    Cree 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: selecciona la duración de caducidad del evento

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

    Asistente de memoria: selecciona 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, elija Memoria.

  4. Selecciona Crear memoria.

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

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

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

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

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

      1. En la clave KMS, selecciona 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. Selecciona Crear memoria para crear la AgentCore memoria.

Temas