20 Memória do Agente

A memória do agente é a parte de um sistema de agente de IA que permite ao agente reter e reutilizar informações em turnos, tarefas ou sessões.

Ao contrário da janela de contexto do modelo, que é temporária e limitada ao prompt atual, a memória pode persistir fatos, preferências, decisões anteriores, saídas de ferramentas, planos intermediários ou observações sobre o ambiente.

Memória do Agente no Oracle AI Data Platform

A AI Data Platform fornece memória de curto prazo limitada à duração de uma sessão. Você pode configurar o que pode ser mantido na memória na guia Contexto do seu agente.

Configuração de Memória de Agente Único

A configuração de memória de um único sistema de agente pode ser encontrada na guia Contexto do nó do agente.

Configuração da Memória	Descrição
Ativar Memória do Agente	Esta configuração ativa a memória do agente. Quando desativado, o agente é essencialmente um sistema sem monitoramento de estado. Cada turno é tratado de forma independente, e nenhuma pergunta de acompanhamento pode ser feita. Recomendamos que a memória esteja ativada.
Limitar histórico de conversas	Quando essa seleção for desativada, as curvas anteriores preencherão a memória até que o modelo fique sem contexto e um erro seja retornado. Se forem esperadas sessões curtas, não há problema em desativar essa configuração. No entanto, para a maioria dos casos de uso, a Oracle recomenda limitar o histórico de conversas.
Configuração de truncamento	Se você optar por limitar o histórico da conversa, poderá decidir truncar o histórico: Mantendo apenas as últimas N mensagens (usuário + agente) Definição de um orçamento geral de token (primeiro a entrar, primeiro a sair) Ou ambos, o que vier primeiro aciona o truncamento da memória do agente
Limites Máximos de Mensagens	Se você optar por manter as últimas N mensagens, poderá definir um valor N.
Orçamento de token	Como alternativa, você pode definir um orçamento geral de token. Os primeiros tokens são eliminados para manter os mais recentes na memória.

Configuração da Memória do Sistema de Vários Agentes (Padrão do Supervisor)

A memória de um sistema de vários agentes é configurada na guia Contexto do agente do supervisor.

A memória de um sistema de vários agentes é imposta e não pode ser desativada, e as opções de truncamento de memória exibidas no nó do agente do supervisor só são aplicadas à memória do agente do supervisor. Cada política de truncamento de memória do agente do executor pode ser configurada na guia Contexto do nó do executor com base na política de isolamento de estado selecionada para todo o sistema.

A configuração de memória do sistema de vários agentes também permite selecionar a política de compartilhamento de memória dos agentes executores. Três opções são possíveis: Stateless, Private e Shared. Observe que a política é aplicada a todos os agentes executores.

Isolamento de Estado para Agentes Executores	Descrição
Sem Monitoramento de Estado	Cada agente executor vê apenas a tarefa atribuída pelo supervisor. Não há história entre as chamadas. Nenhuma solicitação de acompanhamento pode ser feita ao agente supervisor pelo agente executor. Se stateless for selecionado, a memória de cada agente executor será desativada.
Privado	Cada agente executor vê apenas suas próprias interações passadas. Não é possível ver outros agentes executores ou a conversa original do usuário com o agente supervisor. Se privado for selecionado, você poderá configurar a política de truncamento de memória separadamente para cada agente executor em cada guia de Memória de Contexto do nó do agente.
Compartilhado	Os agentes executores podem ver o histórico completo de conversas entre agentes e usuários. Todos os agentes trabalham em um contexto compartilhado. Se a opção compartilhado for selecionada, você poderá configurar a política de truncamento de memória separadamente para cada agente executor em cada guia Contexto do nó do agente.

Memória Armazenada em Agentes

À medida que seu agente é implantado e atende a mais usuários, torna-se importante monitorar o volume de capacidade do banco de dados usado para armazenar dados de sessão para seu agente. Você pode ver e modificar as definições de memória armazenada do seu agente na guia Memória Armazenada. Você pode clicar em Editar para modificar as definições de memória de longo prazo e retenção de sessão.

Definição	Descrição
Status da conexão	Status de conexão com o Oracle Autonomous AI Lakehouse em que todos os dados da sessão são armazenados.
Capacidade do ADB usada	Capacidade total do banco de dados usada em todas as sessões deste agente.
Sessões	Número total de Sessões para este agente. Inclui sessões de teste (Playground) e de implantação.
Computação AI	Nome da computação AI que hospeda o agente. Se o agente for implantado, essa será a computação de IA que hospeda a implantação. Caso contrário, essa é a computação de IA que hospeda o Playground.

Memória de Longo Prazo

Você configura seus agentes para que os usuários interajam com o mesmo agente por meio de várias sessões. O usuário pode compartilhar informações importantes, como preferências, e o agente também pode aprender com padrões comuns adotados em várias sessões, como ferramentas usadas. A capacidade de acessar memórias extraídas em várias sessões é ativada por meio da memória de longo prazo.

Você pode configurar a memória de longo prazo na guia Memória Armazenada do seu agente.

Retenção de Dados da Sessão

Os dados da sessão no Oracle AI Data Platform se referem a todas as mensagens trocadas entre um agente e um usuário durante uma sessão.

Observação:

A Oracle recomenda que você crie cópias de armazenamento frio dos dados da sessão armazenados no banco de dados do Oracle Autonomous AI Lakehouse para manter registros completos de todas as mensagens trocadas entre usuários e agentes para dar suporte a auditorias, descoberta legal e litígios.

As sessões podem durar horas, dias ou até semanas, levando a um grande número de mensagens trocadas e retidas pelos dados da sessão. Todos os dados da sessão da AI Data Platform são armazenados no Autonomous AI Lakehouse provisionado para sua instância para ativar recursos de IA. Para obter mais informações, consulte Gerenciamento de recursos de IA.

Por padrão, a AI Data Platform não limita o volume de dados de sessão armazenados para cada sessão no Autonomous AI Lakehouse provisionado. Como resultado, os dados das sessões podem crescer rapidamente em cenários em que os agentes estão em uso regular para muitos usuários em várias sessões. Para gerenciar isso, a Oracle recomenda configurar limites para a quantidade de dados de sessão retidos.

Quando você cria um agente pela primeira vez, pode configurar suas definições de retenção de sessão. Consulte Criar um Agente. Se o agente já tiver sido criado e você quiser reconfigurar suas definições de retenção de sessão, poderá fazer isso na guia Memória de Sessão.

Definição	Descrição
Retenção de sessão	Ative Aplicar política de retenção para configurar como e quando os dados da sessão são removidos quando os limites especificados são atingidos.
Limite de retenção	Selecione o método para gerenciar limites de dados da sessão: Período de retenção define um intervalo de tempo em dias para o qual os dados da sessão são retidos. Quando os dados da sessão atingem a expiração, eles são excluídos do seu Autonomous AI Lakehouse. Limite de tamanho de sessão define um limite em MB para o volume de dados de sessão retidos. Quando esse limite é atingido, os dados mais antigos são excluídos primeiro. Limite de contagem de threads define um limite para o número de threads, ou seja, combinações de mensagens do usuário e respostas do agente, que são retidas nos dados da sessão. Quando o limite é atingido, os threads mais antigos são excluídos primeiro.

Consolidação Automática

O resumo automático pode ser ativado independentemente da retenção da sessão. Os resumos automáticos são aplicados aos dados de conversação injetados na janela de Contexto do modelo. Esta opção resume mensagens mais antigas que excedem 80% do tamanho do contexto do modelo selecionado.

Esta é uma boa opção para ativar se você quiser persistir os dados de sessões longas no banco de dados e, ao mesmo tempo, impedir que essas sessões longas ultrapassem a janela de contexto do agente.

Observação:

Os resumos são gerados por um LLM para manter um contexto importante antes de as mensagens de origem mais antigas serem excluídas. Algumas palavras exatas, etapas intermediárias ou detalhes de menor prioridade podem não ser preservados.

Ativar Memória de Longo Prazo para um Agente

Você pode ativar a memória de longo prazo para agentes para que possa interagir com o mesmo agente em várias sessões.

1. Navegue até o seu agente.
2. Clique na guia Memória Armazenada.
3. Selecione Ativar memória de longo prazo.
4. Selecione o modelo e a região a serem usados para suportar a memória de longo prazo do agente.
5. Opcional: Você pode permitir que a memória do agente seja compartilhada entre sessões. Se desativado, seu agente é limitado apenas às memórias extraídas dentro da mesma sessão. Se essa opção estiver ativada, o agente terá acesso a memórias extraídas em todas as sessões iniciadas pelo mesmo usuário.

Exibir Definições de Retenção de Dados da Sessão do Agente

Você pode exibir a configuração atual das definições de retenção de dados da sessão para seus agentes na guia Memória Armazenada.

1. Navegue até o seu agente.
2. Clique na guia Memória Armazenada.

Modificar Definições de Retenção de Dados da Sessão do Agente

Você pode ativar, desativar e modificar definições de retenção de dados de sessão para seus agentes.

1. Navegue até o seu agente.
2. Clique na guia Memória Armazenada.
3. Clique emEditar.
4. Selecione Aplicar política de retenção para ativar ou cancelar a seleção para desativá-la.
5. Configure o Limite de retenção:
   • Para Período de retenção, forneça o número de dias em que os dados da sessão são retidos antes de serem excluídos do seu Oracle Autonomous AI Lakehouse.
   • Para Limite de tamanho de sessão, forneça o limite máximo de armazenamento em MB para dados de sessão retidos. Quando esse limite é atingido, as mensagens de sessão mais antigas são excluídas.
   • Para Limite de contagem de threads, forneça um limite para o número de threads (combinações de mensagens do usuário e respostas do agente) retidos. Quando esse limite é atingido, os threads de sessão mais antigos são excluídos.
6. Selecione Resumo automático para reter resumos de informações importantes da sessão.
7. Clique em Salvar alterações.