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.

Utiliser des sessions isolées pour les agents

Amazon Bedrock AgentCore Runtime vous permet d'isoler chaque session utilisateur et de réutiliser en toute sécurité le contexte entre plusieurs appels au cours d'une session utilisateur. L'isolation des sessions est essentielle pour les charges de travail des agents d'IA en raison de leurs caractéristiques opérationnelles uniques :

Comprendre le contexte éphémère

Par défaut, le calcul (microVM) associé à une session est éphémère. Toutes les données stockées en mémoire ou écrites sur disque ne sont conservées que pendant le cycle de vie du calcul. Cela inclut l'historique des conversations, les préférences de l'utilisateur, les résultats de calcul intermédiaires et toute autre information d'état conservée par votre agent.

Pour conserver les données du système de fichiers d'un stop/resume cycle de session à l'autre, configurez le stockage de session, un répertoire persistant qui survit à la fin du calcul. Consultez la section Configurations du système de fichiers pour AgentCore Runtime.

Pour les données structurées qui doivent être conservées au-delà de la durée de vie de la session (telles que l'historique des conversations des utilisateurs, les préférences apprises ou les informations importantes), utilisez AgentCore Memory. Ce service fournit un stockage persistant spécialement conçu pour les charges de travail des agents, avec des capacités de mémoire à court et à long terme.

Conversations étendues et flux de travail en plusieurs étapes

Contrairement aux fonctions sans serveur traditionnelles qui se terminent après chaque requête, elles prennent AgentCore en charge des sessions isolées soutenues par des calculs éphémères. Les sessions durent jusqu'à 8 heures pour chaque cycle de vie sur les micromachines virtuelles, ou jusqu'à 14 jours sur les instances. Grâce à ces sessions, vous pouvez créer des flux de travail agentiques en plusieurs étapes, en effectuant plusieurs appels vers le même environnement, chaque appel s'appuyant sur le contexte des interactions précédentes. Vous pouvez utiliser les deux InvokeAgentRuntime pour le raisonnement des agents et InvokeAgentRuntimeCommand pour l'exécution déterministe de commandes shell au cours de la même session.

AgentCore Cycle de vie des sessions d'exécution

Création de session

Une nouvelle session est créée lors du premier appel avec un runtime unique SessionId fourni par votre application. AgentCore Runtime fournit un environnement d'exécution dédié (microVM) pour chaque session. Le contexte est préservé entre les appels à la même session. Les deux InvokeAgentRuntime InvokeAgentRuntimeCommand fonctionnent sur la même session : une commande voit le même conteneur, le même système de fichiers et le même environnement que l'agent.

États de session

L'état de la session est déterminé par le cycle de vie du calcul et peut être l'un des suivants :

Comment utiliser les sessions

Pour utiliser les sessions de manière efficace :

Exemple : utilisation de sessions pour une conversation

# First message in a conversation

response1 = agent_core_client.InvokeAgentRuntime(
   agentRuntimeArn=agent_arn,
   runtimeSessionId="user-123456-conversation-12345678", # or uuid.uuid4()
   payload=json.dumps({"prompt": "Tell me about AWS"}).encode()
)

# Follow-up message in the same conversation reuses the runtimeSessionId.

response2 = agent_core_client.InvokeAgentRuntime(
   agentRuntimeArn=agent_arn,
   runtimeSessionId="user-123456-conversation-12345678", # or uuid.uuid4()
   payload=json.dumps({"prompt": "How does it compare to other cloud providers"}).encode()
)

En utilisant le même environnement d'exécution SessionId pour les appels associés, vous vous assurez que le contexte est maintenu tout au long de la conversation, ce qui permet à votre agent de fournir des réponses cohérentes qui s'appuient sur les interactions précédentes.

En-têtes de session par protocole

Lorsque vous invoquez des agents, incluez l'en-tête de session approprié pour garantir que les demandes sont acheminées vers la même microVM. L'en-tête dépend du protocole configuré par votre agent :

Adhérence de la microVM  : Amazon Bedrock AgentCore utilise l'en-tête de session pour acheminer les demandes vers la même instance de microVM. Les clients doivent capturer l'ID de session renvoyé dans la réponse et l'inclure dans toutes les demandes suivantes afin de garantir l'affinité de session. Sans identifiant de session cohérent, chaque demande peut être acheminée vers une nouvelle microVM, ce qui peut entraîner une latence supplémentaire en raison des démarrages à froid.

Pour les spécificités du protocole MCP, y compris les modes sans état et avec état, voir Gestion des sessions MCP et adhérence des microVM.