View a markdown version of this page

Personnalisez une stratégie intégrée ou créez votre propre stratégie - Amazon Bedrock AgentCore

Personnalisez une stratégie intégrée ou créez votre propre stratégie

Pour les cas d'utilisation avancés ou spécifiques à un domaine, vous pouvez créer une stratégie intégrée avec des dérogations afin de contrôler avec précision le processus de mémoire à long terme. Built-in Les stratégies de remplacement vous permettent de modifier le comportement par défaut des stratégies intégrées en fournissant vos propres instructions et en sélectionnant un modèle de base spécifique pour les étapes d'extraction et de consolidation.

Quand utiliser une stratégie intégrée avec des dérogations

Choisissez une stratégie intégrée avec des remplacements lorsque vous devez adapter la logique de mémoire à vos besoins spécifiques. Cas d’utilisation courants :

  • Domain-specific extraction : limiter la stratégie à n'extraire que certains types d'informations. Par exemple, saisir les préférences alimentaires et diététiques d'un utilisateur tout en ignorant ses préférences vestimentaires.

  • Contrôle de la granularité : réglage du niveau de détail de la mémoire extraite. Par exemple, demander à la stratégie récapitulative de n'enregistrer que les points clés de haut niveau plutôt qu'un récit détaillé.

  • Sélection du modèle : utilisation d'un modèle de base spécifique mieux adapté à votre domaine ou à votre tâche, tel qu'un modèle affiné pour un texte financier ou juridique.

Comment personnaliser une stratégie

Pour remplacer une stratégie intégrée par une configuration personnalisée, vous devez spécifier la configuration lorsque vous utilisez l'CreateMemoryopération ou l'UpdateMemoryopération. Vous pouvez annuler ce qui suit :

Le tableau suivant indique les étapes que vous pouvez ignorer pour chaque stratégie de mémoire :

Stratégie Étapes que vous pouvez annuler

Sémantique

Consolidation d'extraction

Résumé

Consolidation

Préférence de l'utilisateur

Consolidation d'extraction

Épisodique

Extraction, consolidation, réflexion

Note

Vous pouvez également remplacer par une stratégie autogérée. Pour plus d'informations, consultez la section Self-managed Stratégie.

Comment personnaliser une stratégie

Par exemple, vous pouvez modifier l'instruction d'extraction pour la stratégie de mémoire sémantique afin d'ajouter de nouvelles instructions lors de sa personnalisation.

Built-in instructions de stratégie de mémoire sémantique

Voici les instructions intégrées pour la stratégie de mémoire sémantique :

You are a long-term memory extraction agent supporting a lifelong learning system. Your task is to identify and extract meaningful information about the users from a given list of messages. Analyze the conversation and extract structured information about the user according to the schema below. Only include details that are explicitly stated or can be logically inferred from the conversation. - Extract information ONLY from the user messages. You should use assistant messages only as supporting context. - If the conversation contains no relevant or noteworthy information, return an empty list. - Do NOT extract anything from prior conversation history, even if provided. Use it solely for context. - Do NOT incorporate external knowledge. - Avoid duplicate extractions. IMPORTANT: Maintain the original language of the user's conversation. If the user communicates in a specific language, extract and format the extracted information in that same language.

Vous pouvez ajouter une nouvelle règle à ces instructions, par exemple :

- Focus exclusively on extracting facts related to travel and booking preferences.

ou modifiez une règle existante telle que :

IMPORTANT: Always extract memories in English irrespective of the original language of the user's conversation.

Bonnes pratiques en matière de personnalisation

  • Tirez parti des instructions existantes : nous vous recommandons vivement d'utiliser les instructions de stratégies intégrées comme point de départ. La structure de base et les instructions sont essentielles au fonctionnement de la mémoire. Vous devez ajouter vos instructions spécifiques aux tâches aux instructions existantes plutôt que d'en écrire de nouvelles à partir de zéro.

  • Fournissez des instructions claires : le contenu de appendToPrompt remplace les instructions par défaut dans l'invite du système. Assurez-vous que vos instructions sont logiques et complètes, car des instructions vides ou mal rédigées peuvent entraîner des résultats indésirables.

Considérations importantes

Pour garantir la fiabilité du pipeline de mémoire, veuillez respecter les consignes suivantes :

  • Ne modifiez pas les schémas dans les instructions : vous devez uniquement ajouter ou modifier les instructions qui indiquent comment les mémoires sont extraites ou consolidées. N'essayez pas de modifier les définitions de conversation ou de schéma de mémoire dans l'invite elle-même, car cela peut provoquer des échecs inattendus.

  • Ne renommez pas les opérations de consolidation : lorsque vous personnalisez une invite de consolidation, ne modifiez pas le nom des opérations (par exemple,AddMemory,UpdateMemory). La modification de ces noms entraînera l'échec du pipeline de mémoire à long terme.

  • Le schéma de sortie n'est pas modifiable : les stratégies intégrées aux remplacements ne vous permettent pas de modifier le schéma de sortie final de la mémoire extraite ou consolidée. Le schéma de sortie qui sera ajouté à l'invite du système pour la stratégie intégrée avec remplacements sera identique aux stratégies intégrées. Pour plus d'informations sur les schémas de sortie, consultez les rubriques suivantes :

Pour un contrôle total sur le processus de mémoire de bout en bout, y compris le schéma de sortie, voir Self-managed stratégie.

Rôle d'exécution

Lorsque vous utilisez des stratégies de remplacement intégrées, vous devez également fournir une memoryExecutionRoleArn dans l'CreateMemoryAPI. Bedrock Amazon Bedrock AgentCore assumera ce rôle en appelant les modèles de socle de votre AWS compte à des fins d'extraction et de consolidation.

Note

Lorsque vous utilisez des stratégies de remplacement intégrées, l'utilisation du LLM pour l'extraction et la consolidation sera facturée séparément à votre AWS compte, et des frais supplémentaires peuvent s'appliquer.