As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use sessões isoladas para agentes

O Amazon Bedrock AgentCore Runtime permite isolar cada sessão de usuário e reutilizar o contexto com segurança em várias invocações em uma sessão de usuário. O isolamento da sessão é fundamental para as cargas de trabalho dos agentes de IA devido às suas características operacionais exclusivas:

Compreendendo o contexto efêmero

Por padrão, a computação (microVM) associada a uma sessão é efêmera. Todos os dados armazenados na memória ou gravados em disco persistem somente durante o ciclo de vida da computação. Isso inclui histórico de conversas, preferências do usuário, resultados de cálculos intermediários e qualquer outra informação de estado que seu agente mantenha.

Para manter os dados do sistema de arquivos em todos os stop/resume ciclos da sessão, configure o armazenamento da sessão — um diretório persistente que sobrevive ao encerramento da computação. Consulte Configurações do sistema de arquivos para AgentCore Runtime.

Para dados estruturados que precisam ser retidos além da duração da sessão (como histórico de conversas do usuário, preferências aprendidas ou informações importantes), use AgentCore Memória. Esse serviço fornece armazenamento persistente desenvolvido especificamente para cargas de trabalho de agentes, com recursos de memória de curto e longo prazo.

Conversas estendidas e fluxos de trabalho em várias etapas

Ao contrário das funções sem servidor tradicionais que terminam após cada solicitação, AgentCore oferece suporte a sessões isoladas apoiadas por cálculos efêmeros. As sessões duram até 8 horas para cada ciclo de vida em microVMs ou até 14 dias em instâncias. Com essas sessões, você pode criar fluxos de trabalho agentes de várias etapas, fazendo várias chamadas para o mesmo ambiente, com cada invocação baseada no contexto de interações anteriores. Você pode usar tanto InvokeAgentRuntime para raciocínio do agente quanto InvokeAgentRuntimeCommand para execução determinística de comandos shell na mesma sessão.

AgentCore Ciclo de vida da sessão de tempo de execução

Criação de sessão

Uma nova sessão é criada na primeira invocação com um tempo de execução exclusivo SessionId fornecido pelo seu aplicativo. AgentCore O Runtime provisiona um ambiente de execução dedicado (microVM) para cada sessão. O contexto é preservado entre as invocações para a mesma sessão. Ambos InvokeAgentRuntime InvokeAgentRuntimeCommand operam na mesma sessão — um comando vê o mesmo contêiner, sistema de arquivos e ambiente do agente.

Estados da sessão

O estado da sessão é determinado pelo ciclo de vida da computação e pode ser um dos seguintes:

Como usar as sessões

Para usar as sessões de forma eficaz:

Exemplo de uso de sessões para uma conversa

# 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()
)

Ao usar o mesmo tempo de execução SessionId para invocações relacionadas, você garante que o contexto seja mantido em toda a conversa, permitindo que seu agente forneça respostas coerentes baseadas em interações anteriores.

Cabeçalhos de sessão por protocolo

Ao invocar agentes, inclua o cabeçalho de sessão apropriado para garantir que as solicitações sejam roteadas para a mesma microVM. O cabeçalho depende do protocolo configurado pelo seu agente:

Fixação da microVM: o Amazon Bedrock AgentCore usa o cabeçalho da sessão para rotear solicitações para a mesma instância de microVM. Os clientes devem capturar a ID da sessão retornada na resposta e incluí-la em todas as solicitações subsequentes para garantir a afinidade da sessão. Sem um ID de sessão consistente, cada solicitação pode ser roteada para uma nova microVM, o que pode resultar em latência adicional devido às partidas a frio.

Para especificações do protocolo MCP, incluindo modos sem estado e com estado, consulte Gerenciamento de sessão MCP e aderência da microVM.