Gestion de la mémoire de l'agent

La fonctionnalité Memory for Agents est en version préliminaire pour Amazon Bedrock et est sujette à modification.

Après avoir activé la mémoire pour votre agent, vous pouvez afficher les sessions stockées dans la mémoire ou supprimer toutes les sessions de la mémoire.

Afficher les sessions de mémoire

L'agent stocke la mémoire pour chaque session en fonction de l'identifiant de mémoire unique (memoryId) fourni à chaque utilisateur lorsque vous appelez l'agent. La prochaine fois que vous invoquerez l'agent avec le même agentmemoryId, la totalité de la mémoire sera chargée dans la session. Une fois la session terminée, l'agent génère une version résumée de la session et enregistre le résumé de session.

Note

Plusieurs minutes peuvent s'écouler après la fin de votre session pour que les résumés de session apparaissent dans la console ou dans la réponse de l'API.

Pour savoir comment consulter les résumés des sessions, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console

Pour consulter les résumés des sessions,

1. Connectez-vous à l' AWS Management Console aide d'un rôle IAM avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse https://console.aws.amazon.com/bedrock/.

2. Sélectionnez Agents dans le volet de navigation de gauche. Choisissez ensuite un agent dans la section Agents.

3. Dans la fenêtre de test, cliquez sur l'icône d'extension, puis sur l'onglet Mémoire.

   Si vous êtes sur la page Agent Builder, dans la section Mémoire, choisissez Afficher la mémoire.

4. Vous pouvez également consulter les sessions de mémoire lorsque vous testez votre agent. Pour afficher les sessions stockées dans la mémoire lorsque vous effectuez un test,

   1. Dans la fenêtre de test, choisissez Afficher la trace, puis sélectionnez l'onglet Mémoire.

      Note

      Si vous consultez des sessions de mémoire lorsque vous testez votre agent, vous ne pouvez consulter le résumé des sessions qu'une fois la dernière session terminée. Si vous essayez d'afficher des sessions de mémoire alors que la session en cours est en cours, vous serez informé que le résumé des sessions est en cours de génération et que la génération des sessions prendra du temps. Vous pouvez forcer la fin de la session en cours en choisissant l'icône en forme de balai.

API

Pour consulter les sessions de mémoire de votre agent, envoyez une GetAgentMemorydemande (voir le lien pour les formats de demande et de réponse et les détails des champs) à l'aide d'un point de terminaison créé par Agents for Amazon Bedrock.

Les champs suivants sont obligatoires :

Champ	Description abrégée
agentId	L'identifiant de l'agent
agentAliasId	L'identifiant de l'alias de l'agent
ID de mémoire	Identifiant de la mémoire contenant les résumés de session
Type de mémoire	Type de mémoire. Valeur valide : SESSION_SUMMARY

Note

Si vous consultez des sessions de mémoire lorsque vous testez votre agent, vous ne pouvez consulter le résumé des sessions qu'une fois la dernière session terminée. Si vous essayez d'afficher des sessions de mémoire alors que la session en cours est en cours, vous serez informé que le résumé des sessions est en cours de génération et que la génération des sessions prendra du temps. Vous pouvez forcer la fin de la session en cours en envoyant une InvokeAgentdemande et en spécifiant Y le endSession champ.

Supprimer les résumés de session de l'alias

Pour savoir comment supprimer les résumés des sessions, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console

Pour supprimer les résumés de session,

1. Connectez-vous à l' AWS Management Console aide d'un rôle IAM avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse https://console.aws.amazon.com/bedrock/.

2. Sélectionnez Agents dans le volet de navigation de gauche. Choisissez ensuite un agent dans la section Agents.

3. Choisissez Modifier dans Agent Builder

4. Dans la section Mémoire, choisissez Afficher la mémoire, puis sélectionnez l'onglet Mémoire.

5. Pour choisir les résumés de session que vous souhaitez supprimer,

   1. Dans la section Rechercher des sessions de mémoire, sélectionnez le filtre que vous souhaitez utiliser pour rechercher les résumés de sessions que vous souhaitez supprimer.

   2. Spécifiez les critères de filtrage.

6. Choisissez Supprimer la mémoire des alias, puis Supprimer.

API

Pour supprimer les résumés de session, envoyez une DeleteAgentMemorydemande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison Agents for Amazon Bedrock au moment de la création.

Les champs suivants sont obligatoires :

Champ	Description abrégée
agentId	L'identifiant de l'agent.
agentAliasId	Identifiant de l'alias de l'agent.

Le champ suivant est facultatif.

Champ	Description abrégée
ID de mémoire	Identifiant de la mémoire contenant les résumés de session

Désactiver la mémoire pour votre agent Amazon Bedrock

Vous pouvez désactiver la mémoire de votre agent à tout moment. Vous ne pouvez pas accéder aux sessions mémoire une fois que vous avez désactivé la mémoire pour votre agent.

Note

Si vous activez la mémoire pour l'agent et que vous ne spécifiez pas à quel memoryId moment vous l'appelez, l'agent ne stockera pas ce tour spécifique dans la mémoire.

Pour savoir comment désactiver la mémoire, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console

Pour désactiver la mémoire de votre agent,

1. Connectez-vous à l' AWS Management Console aide d'un rôle IAM avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse https://console.aws.amazon.com/bedrock/.

2. Sélectionnez Agents dans le volet de navigation de gauche. Choisissez ensuite un agent dans la section Agents.

3. Choisissez Modifier dans Agent Builder

4. Dans la section Mémoire, choisissez Désactiver.

API

Pour désactiver la mémoire, envoyez une UpdateAgentdemande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison Agents for Amazon Bedrock au moment de la création. Envoyez la demande sans préciser la memoryConfiguration structure. Cela dissociera la mémoire de l'agent.