Pular para o conteúdo principal

Gerenciando Memórias

Configurações de Memória​

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

ConfiguraçãoDescrição
Habilitar MemóriaPermita que este agente aprenda e lembre das preferências do usuário a partir de conversas. Habilitado por padrão.
Nota

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

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ísticaDescrição
Total de MemóriasNúmero total de registros de memória armazenados para este agente.
AprovadasMemórias que foram aprovadas e estão sendo usadas ativamente nas respostas.
PendentesMemórias aguardando aprovação antes de serem usadas.
UsuáriosNú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​

AbaDescrição
AprovadasMemórias que estão ativas e injetadas no contexto do agente durante conversas.
PendentesMemórias detectadas nas conversas que aguardam revisão antes do uso.

Aprovando ou Rejeitando Memórias​

  1. Vá para a aba Pendentes

    Navegue até a aba Memória e selecione Pendentes.

  2. 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.

  3. Aprove ou rejeite

    Clique em Aprovar para ativar a memória ou Rejeitar para arquivá-la.

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​

  1. Vá para a aba Aprovadas

    Navegue até a aba Memória e selecione Aprovadas.

  2. Encontre a memória

    Localize o registro de memória que deseja remover.

  3. Exclua

    Clique no ícone Excluir e confirme a exclusão.

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​

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.
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.
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.