View a markdown version of this page

Crea un AgentCore ricordo - Amazon Bedrock AgentCore

Crea un AgentCore ricordo

È possibile creare una AgentCore memoria con la AgentCore CLI, la AWS console o con l'operazione CreateMemory AWS SDK. Quando si crea una memoria, è possibile configurare impostazioni come nome, descrizione, impostazioni di crittografia, timestamp di scadenza per eventi non elaborati e strategie di memoria se si desidera estrarre memoria a lungo termine.

Quando create una AgentCore memoria, considerate i seguenti fattori per assicurarvi che soddisfi le esigenze dell'applicazione:

Conservazione degli eventi: scegliete per quanto tempo vengono conservati gli eventi non elaborati (fino a 365 giorni) per la memoria a breve termine.

Nota

eventExpiryDurationviene applicato per evento in fase di scrittura. L'aggiornamento ha effetto solo sugli eventi creati dopo la modifica. Gli eventi precedentemente memorizzati mantengono la scadenza originale e non possono essere estesi, mentre gli eventi scaduti non possono essere recuperati.

Requisiti di sicurezza: se la tua applicazione gestisce informazioni sensibili, prendi in considerazione l'utilizzo di una chiave AWS KMS gestita dal cliente per la crittografia. Il servizio continua a crittografare i dati utilizzando una chiave gestita dal servizio, anche se non fornisci una chiave KMS gestita dal cliente AWS .

Strategie di memoria: definisci come gli eventi vengono elaborati in memorie significative a lungo termine utilizzando strategie integrate o integrate con override. Se non si definisce alcuna strategia, viene archiviata solo la memoria a breve termine contenente eventi non elaborati. Per ulteriori informazioni, consulta Utilizzare la memoria a lungo termine.

Convenzioni di denominazione: utilizzate nomi chiari e descrittivi che aiutino a identificare lo scopo di ogni AgentCore memoria, specialmente se l'applicazione utilizza più archivi.

Esempio
AgentCore CLI

  1. I comandi di memoria AgentCore CLI devono essere eseguiti all'interno di un progetto agentcore esistente. Se non ne hai ancora uno, crea prima un progetto:

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

    Crea una memoria di base (solo a breve termine):

    agentcore add memory --name my_agent_memory
agentcore deploy

    Crea memoria con strategie a lungo termine:

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

    Controlla lo stato della memoria:

    agentcore status
Interactive

  1. Esegui agentcore per aprire la TUI, quindi seleziona aggiungi e scegli Memoria:

  2. Inserisci il nome della memoria:

    Memory wizard: inserisci il nome

  3. Seleziona la durata di scadenza dell'evento:

    Memory wizard: seleziona la durata di scadenza dell'evento

  4. Scegli le strategie di memoria per l'estrazione della memoria a lungo termine:

    Memory wizard: seleziona le strategie di memoria

  5. Rivedi la configurazione e premi Invio per confermare:

    Memory Wizard: verifica la configurazione
AWS SDK

  1. Per ulteriori informazioni, consulta AWS SDK.

    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. ====== Per creare una memoria AgentCore

  2. Apri la console Amazon Bedrock AgentCore.

  3. Nel riquadro di navigazione a sinistra, scegli Memoria.

  4. Scegli Crea memoria.

  5. Per Nome memoria, inserisci un nome per la AgentCore memoria.

  6. (Facoltativo) Per la scadenza Short-term della memoria (evento non elaborato), imposta la durata (giorni), per la quale la AgentCore memoria memorizzerà gli eventi.

  7. (Facoltativo) In Configurazioni aggiuntive imposta quanto segue:

    1. Per Descrizione della memoria, immettere una descrizione per la AgentCore memoria.

    2. Se desideri utilizzare la tua chiave AWS KMS per crittografare i tuoi dati, procedi come segue:

      1. Nella chiave KMS, scegli Personalizza le impostazioni di crittografia (avanzate).

      2. In Scegli una chiave AWS KMS scegli o inserisci l'ARN di una chiave KMS AWS esistente. In alternativa, scegli Crea un AWS KMS per creare una nuova chiave KMS. AWS

  8. (Facoltativo) Per le strategie di estrazione Long-term della memoria, scegli una o più strategie di memoria. Per ulteriori informazioni:

  9. Scegli Crea memoria per creare la AgentCore memoria.

Argomenti