View a markdown version of this page

Créez un AgentCore souvenir - Amazon Bedrock AgentCore

Créez un AgentCore souvenir

Vous pouvez créer une AgentCore mémoire à l'aide de la AgentCore CLI, de la AWS console ou 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 chiffrement, l'horodatage d'expiration pour les é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 garantir qu'elle répond aux besoins de votre application :

Rétention des événements : choisissez la durée de conservation des événements bruts (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 enregistrés conservent leur date d'expiration initiale 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 traite 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 souvenirs significatifs à long terme à l'aide de stratégies intégrées ou intégrées à des remplacements. 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 de la 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 --name my-agent --no-agent
cd my-agent

    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 Memory :

  2. Entrez le nom de la mémoire :

    Assistant mémoire : entrez le nom

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

    Assistant 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 les 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 une mémoire AgentCore

  2. Ouvrez la console Amazon Bedrock AgentCore.

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

  4. Choisissez Créer une mémoire.

  5. Dans Nom de la mémoire, entrez le nom de la AgentCore mémoire.

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

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

    1. Dans 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, sélectionnez ou entrez l'ARN d'une clé AWS KMS existante. Vous pouvez également choisir Create an 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 une mémoire pour créer la AgentCore mémoire.

Rubriques