Utiliser des sessions isolées pour les agents

Amazon Bedrock AgentCore Runtime vous permet d'isoler chaque session utilisateur et de réutiliser le contexte en toute sécurité lors de plusieurs invocations au cours d'une session utilisateur. L'isolation des sessions est essentielle pour les charges de travail des agents 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 le 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 des calculs intermédiaires et toute autre information d'état conservée par votre agent.

Pour conserver les données du système de fichiers au cours des stop/resume cycles de session, configurez le stockage de session, un répertoire persistant qui survit à l'arrêt du calcul. Voir 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 de l'utilisateur, 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 s'arrêtent après chaque demande, elles prennent AgentCore en charge des sessions isolées soutenues par des calculs éphémères d'une durée maximale de 8 heures par cycle de vie. Cela simplifie la création de flux de travail agentiques en plusieurs étapes, car vous pouvez effectuer plusieurs appels vers le même environnement, chaque appel s'appuyant sur le contexte établi par les interactions précédentes. Vous pouvez les utiliser à la fois InvokeAgentRuntime pour raisonner l'agent et InvokeAgentRuntimeCommand pour exécuter des commandes shell déterministes au cours d'une 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 environnement d'exécution 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 utilise 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 session est déterminé par le cycle de vie de calcul et peut être l'un des suivants :

Comment utiliser les sessions

Pour utiliser efficacement les sessions :

Exemple d'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 invocations associées, 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 appelez des agents, incluez l'en-tête de session approprié pour vous assurer 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 saisir l'identifiant 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, notamment les modes statique et statique, consultez les sections Gestion des sessions MCP et adhérence des micromachines virtuelles.