View a markdown version of this page

Personnalisez une stratégie intégrée ou créez votre propre stratégie - Base rocheuse de l'Amazonie AgentCore
Quand utiliser une stratégie intégrée avec des dérogationsComment personnaliser une stratégieComment personnaliser une stratégieMeilleures pratiques en matière de personnalisationConsidérations importantesRôle d'exécution

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.

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 remplacements afin d'obtenir un contrôle précis sur le processus de mémoire à long terme. Built-in avec 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 : limitation de la stratégie à l'extraction de certains types d'informations uniquement. Par exemple, saisir les préférences alimentaires et alimentaires d'un utilisateur tout en ignorant ses préférences vestimentaires.

  • Contrôle de la granularité : réglage du niveau de détail dans 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 modifier les paramètres suivants :

  • Les instructions de l'invite système (le schéma de sortie reste toutefois le même). Pour créer une invite personnalisée efficace, vous devez d'abord comprendre les invites par défaut. Pour plus d'informations, consultez la section d'invite du système pour chaque stratégie intégrée.

  • Le modèle Amazon Bedrock avec lequel appeler l'invite. Pour plus d'informations, voir Ajouter ou supprimer l'accès aux modèles de fondation Amazon Bedrock. Pour plus d'informations sur l'obtention d'une capacité Amazon Bedrock suffisante, consultez la section Capacité Amazon Bedrock pour les stratégies intégrées avec dérogations.

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

Stratégie Étapes que vous pouvez ignorer

Sémantique

Consolidation des activités

Résumé

Consolidation

Préférence de l'utilisateur

Consolidation des activités

Épisodique

Réflexion de consolidation de l'extraction
Note

Vous pouvez également passer à une stratégie autogérée. Pour plus d'informations, voir 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.

Meilleures pratiques en matière de personnalisation

  • Tirez parti des instructions existantes : nous vous recommandons vivement d'utiliser les instructions relatives aux stratégies intégrées comme point de départ. La structure de base et les instructions sont essentielles à la fonctionnalité de la mémoire. Vous devriez ajouter des conseils spécifiques à la tâche aux instructions existantes plutôt que d'en écrire de nouvelles entièrement à 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 formées peuvent entraîner des résultats indésirables.

Considérations importantes

Pour préserver la fiabilité du pipeline de mémoire, veuillez respecter les directives suivantes :

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

  • Ne renommez pas les opérations de consolidation : lorsque vous personnalisez une invite de consolidation, ne modifiez pas les noms des opérations (par exempleAddMemory,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 de remplacement intégrées 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 système pour la stratégie intégrée avec dérogations sera identique à celui des 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, consultez la section Self-managed stratégie.

Rôle d'exécution

Lorsque vous utilisez des stratégies intégrées avec des remplacements, vous devez également fournir un memoryExecutionRoleArn dans l'CreateMemoryAPI. Bedrock Amazon Bedrock AgentCore assumera ce rôle pour appeler les modèles de substrats rocheux de votre AWS compte à des fins d'extraction et de consolidation.

Note

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