View a markdown version of this page

Créez un AgentCore souvenir - Base rocheuse de l'Amazonie AgentCore

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez un AgentCore souvenir

Vous pouvez créer une AgentCore mémoire à l'aide de l' AgentCore interface de ligne de commande, de la AWS console ou de l'opération du CreateMemory AWS SDK. Lorsque vous créez une mémoire, vous pouvez configurer des paramètres tels que le nom, la description, les paramètres de cryptage, l'horodatage d'expiration des événements bruts et les stratégies de mémoire si vous souhaitez extraire de la mémoire à long terme.

Lorsque vous créez une AgentCore mémoire, tenez compte des facteurs suivants pour qu'elle réponde aux besoins de votre application :

Conservation des événements  : choisissez la durée pendant laquelle les événements bruts sont conservés (jusqu'à 365 jours) pour la mémoire à court terme.

Note

eventExpiryDurationest appliqué par événement au moment de l'écriture. Sa mise à jour n'affecte que les événements créés après la modification. Les événements précédemment stockés conservent leur date d'expiration d'origine et ne peuvent pas être prolongés, et les événements expirés ne peuvent pas être récupérés.

Exigences de sécurité  : si votre application gère des informations sensibles, pensez à utiliser une clé AWS KMS gérée par le client pour le chiffrement. Le service chiffre toujours les données à l'aide d'une clé gérée par le service, même si vous ne fournissez pas de clé KMS gérée par le client AWS .

Stratégies de mémoire — Définissez comment les événements sont transformés en mémoires à long terme significatives à l'aide de stratégies intégrées ou intégrées avec dérogations. Si vous ne définissez aucune stratégie, seule la mémoire à court terme contenant des événements bruts est stockée. Pour plus d'informations, voir Utiliser la mémoire à long terme.

Conventions de dénomination  : utilisez des noms clairs et descriptifs qui permettent d'identifier l'objectif de chaque AgentCore mémoire, en particulier si votre application utilise plusieurs magasins.

Exemple
AgentCore CLI

  1. Les commandes de mémoire AgentCore CLI doivent être exécutées dans un projet agentcore existant. Si vous n'en avez pas encore, créez d'abord un projet :

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

    Créez une mémoire de base (à court terme uniquement) :

    agentcore add memory --name my_agent_memory
agentcore deploy

    Créez de la mémoire grâce à des stratégies à long terme :

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

    Vérifiez l'état de la mémoire :

    agentcore status
Interactive

  1. Exécutez agentcore pour ouvrir le TUI, puis sélectionnez Ajouter et choisissez Mémoire  :

  2. Entrez le nom de la mémoire :

    Assistant de mémoire : entrez le nom

  3. Sélectionnez la durée d'expiration de l'événement :

    Assistant de mémoire : sélectionnez la durée d'expiration de l'événement

  4. Choisissez des stratégies de mémoire pour l'extraction de la mémoire à long terme :

    Assistant de mémoire : sélectionnez des stratégies de mémoire

  5. Vérifiez la configuration et appuyez sur Entrée pour confirmer :

    Assistant de mémoire : révision de la configuration
AWS SDK

  1. Pour plus d'informations, consultez la section 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. ====== Pour créer un souvenir AgentCore

  2. Ouvrez la console Amazon Bedrock AgentCore.

  3. Dans le volet de navigation de gauche, choisissez Memory.

  4. Choisissez Créer de la mémoire.

  5. Pour Nom de la mémoire, entrez un nom pour la AgentCore mémoire.

  6. (Facultatif) Pour l'expiration de la Short-term mémoire (événement brut), définissez la durée (en jours) pendant laquelle la AgentCore mémoire stockera les événements.

  7. (Facultatif) Dans Configurations supplémentaires, définissez les paramètres suivants :

    1. Pour Description de la mémoire, entrez une description de la AgentCore mémoire.

    2. Si vous souhaitez utiliser votre propre clé AWS KMS pour chiffrer vos données, procédez comme suit :

      1. Dans la clé KMS, choisissez Personnaliser les paramètres de chiffrement (avancés).

      2. Dans Choisir une clé AWS KMS, choisissez ou entrez l'ARN d'une clé AWS KMS existante. Vous pouvez également choisir Créer un AWS KMS pour créer une nouvelle clé AWS KMS.

  8. (Facultatif) Pour les stratégies d'extraction de Long-term mémoire, choisissez une ou plusieurs stratégies de mémoire. Pour plus d’informations, consultez:

  9. Choisissez Créer de la mémoire pour créer la AgentCore mémoire.

Rubriques