> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciando Memórias

> Visualize, aprove, rejeite e exclua memórias de agentes no painel de Gerenciamento de Memória.

## Configurações de Memória

Controla se o agente pode aprender e lembrar das preferências do usuário a partir de conversas.

| Configuração          | Descrição                                                                                                              |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Habilitar Memória** | Permita que este agente aprenda e lembre das preferências do usuário a partir de conversas. **Habilitado por padrão.** |

<Note>
  Quando a memória está desabilitada, nenhuma nova memória será criada. No entanto, memórias aprovadas existentes ainda serão usadas nas conversas.
</Note>

### Estatísticas de Memória

O painel de Configurações de Memória exibe um resumo em tempo real do estado da memória do agente:

| Estatística           | Descrição                                                                   |
| --------------------- | --------------------------------------------------------------------------- |
| **Total de Memórias** | Número total de registros de memória armazenados para este agente.          |
| **Aprovadas**         | Memórias que foram aprovadas e estão sendo usadas ativamente nas respostas. |
| **Pendentes**         | Memórias aguardando aprovação antes de serem usadas.                        |
| **Usuários**          | Número de usuários distintos com memórias armazenadas para este agente.     |

## Painel de Gerenciamento de Memória

O painel de **Gerenciamento de Memória** permite visualizar, aprovar, rejeitar e excluir registros de memória. Use o filtro **Todos os Usuários** para limitar a visualização a um usuário específico ou visualizar todos de uma vez.

### Visualizando Memórias

| Aba           | Descrição                                                                      |
| ------------- | ------------------------------------------------------------------------------ |
| **Aprovadas** | Memórias que estão ativas e injetadas no contexto do agente durante conversas. |
| **Pendentes** | Memórias detectadas nas conversas que aguardam revisão antes do uso.           |

### Aprovando ou Rejeitando Memórias

<Steps>
  <Step title="Vá para a aba Pendentes">
    Navegue até a aba **Memória** e selecione **Pendentes**.
  </Step>

  <Step title="Revise cada sugestão de memória">
    Verifique o conteúdo da memória, a mensagem original que a desencadeou e a pontuação de confiança.
  </Step>

  <Step title="Aprove ou rejeite">
    Clique em **Aprovar** para ativar a memória ou **Rejeitar** para arquivá-la.
  </Step>
</Steps>

### Filtrando Memórias

* **Por Usuário** — Use o menu suspenso **Todos os Usuários** para filtrar memórias de um usuário específico.
* **Por Status** — Alterne entre as abas **Aprovadas** e **Pendentes**.

### Excluindo Memórias

<Steps>
  <Step title="Vá para a aba Aprovadas">
    Navegue até a aba **Memória** e selecione **Aprovadas**.
  </Step>

  <Step title="Encontre a memória">
    Localize o registro de memória que deseja remover.
  </Step>

  <Step title="Exclua">
    Clique no ícone **Excluir** e confirme a exclusão.
  </Step>
</Steps>

## Privacidade e Segurança

### Armazenamento de Dados

* As memórias são armazenadas com segurança e vinculadas a um usuário e agente específicos.
* As memórias são isoladas por usuário — os usuários não podem ver as memórias uns dos outros.

### Controle de Acesso

* Apenas usuários com acesso ao agente podem visualizar memórias.
* Os usuários só podem ver suas próprias memórias.
* Os administradores podem visualizar todas as memórias de seus agentes.

### Retenção de Dados

* Memórias aprovadas persistem até serem manualmente excluídas.
* Memórias rejeitadas são arquivadas.
* Memórias pendentes expiradas são automaticamente removidas.

## Melhores Práticas

### Para Administradores

* **Revise regularmente** — Verifique memórias pendentes periodicamente para manter a qualidade.
* **Controle de qualidade** — Rejeite memórias de baixa qualidade ou irrelevantes.
* **Privacidade do usuário** — Certifique-se de que as memórias armazenadas estejam em conformidade com as políticas de privacidade da sua organização.
* **Monitore o uso** — Rastreie estatísticas de memória para otimizar o comportamento do agente ao longo do tempo.

### Para Usuários

* **Seja explícito** — Declare claramente preferências e informações importantes para que o agente possa detectá-las.
* **Forneça contexto** — Compartilhe informações relevantes ao iniciar novos fluxos de trabalho.
* **Atualize memórias** — Informe o agente quando as preferências mudarem.

### Dicas de Qualidade de Memória

* **Seja específico** — Memórias vagas são menos úteis que memórias precisas.
* **Mantenha a relevância** — Foque em informações que realmente melhorarão interações futuras.
* **Remova memórias desatualizadas** — Exclua memórias que não refletem mais preferências ou fatos atuais.

## Solução de Problemas

<AccordionGroup>
  <Accordion title="Memórias não estão sendo criadas">
    **Causas possíveis:**

    * A memória está desabilitada para o agente.
    * As mensagens são muito curtas (menos de 10 caracteres) ou muito longas (mais de 2.000 caracteres).
    * Nenhuma informação memorável foi detectada na mensagem.
    * A memória é uma duplicata de uma existente.

    **Soluções:**

    * Verifique se a memória está habilitada no painel de Configurações de Memória.
    * Certifique-se de que as mensagens contenham preferências ou fatos claros.
    * Revise as memórias existentes para verificar duplicatas.
  </Accordion>

  <Accordion title="Muitas memórias pendentes">
    **Causas possíveis:**

    * Alto volume de mensagens gerando muitos candidatos.
    * Memórias pendentes não sendo revisadas regularmente.

    **Soluções:**

    * Configure um cronograma regular de revisão para memórias pendentes.
    * Rejeite candidatos de baixa confiança ou irrelevantes para manter a fila gerenciável.
  </Accordion>

  <Accordion title="Memórias não estão sendo usadas nas respostas">
    **Causas possíveis:**

    * As memórias ainda estão com status `pending`.
    * A memória foi rejeitada.
    * A memória não está habilitada para o agente.

    **Soluções:**

    * Aprove as memórias pendentes no painel de Gerenciamento de Memória.
    * Verifique o status da memória na aba **Memória**.
    * Verifique se **Habilitar Memória** está alternado para ativado.
  </Accordion>
</AccordionGroup>