Todos os produtos
Search
Central de documentação

AgentLoop:Configure as estratégias de extração e armazenamento de memórias

Última atualização: Oct 14, 2026

A estratégia de extração define quais fatos são mantidos a partir das entradas, enquanto a estratégia de armazenamento determina como esses fatos são preservados como memórias de longo prazo. Você pode definir as estratégias no assistente de criação ou acessar a guia Strategy de um repositório de memórias existente para ajustar a configuração, visualizar amostras e consultar o histórico de versões.

Configure a estratégia de extração

Selecione uma predefinição de extração

Predefinição

Cenário

Recomendação

Extração de fatos

Fatos objetivos e preferências em conversas gerais

Comece com esta predefinição para a validação inicial.

Perfil de usuário consumidor

Hábitos pessoais, preferências e contexto de longo prazo

Use IDs de usuário estáveis para evitar a mistura de informações de usuários diferentes.

Gêmeo digital corporativo

Clientes corporativos, status do negócio e relacionamentos

Defina os objetos de negócio e as informações a serem mantidas.

Instrução personalizada

Regras de extração específicas de domínio ou de negócio

Uma instrução personalizada é obrigatória. Especifique o escopo de extração e as exclusões.

Por exemplo, um assistente de estilo de vida pode usar a seguinte instrução personalizada:

[
  {
    "sourceId": "preview-001",
    "scope": {"userId": "user-001"},
    "messages": [{"role": "user", "content": "I like light, mildly spicy home-style dishes"}]
  }
]

Uma instrução personalizada pode conter até 8.000 caracteres. A instrução descreve os objetivos de extração e não pode substituir a identidade do negócio, as permissões de acesso ou as configurações de escopo.

Categorias, regras de exclusão e modelo

  • Categorias: Especifique categorias como preference e profile conforme necessário. Se a lista de categorias não estiver vazia, apenas os fatos cujas categorias estejam na lista serão mantidos, e os resultados sem categoria também serão filtrados. Recomendamos usar a pré-visualização para verificar se as categorias atendem às suas expectativas.

  • Regras de exclusão: Descreva o conteúdo que você não deseja extrair, como códigos de verificação temporários. O aplicativo ainda deve executar a filtragem de dados necessária antes que as entradas sejam processadas. Não dependa apenas das instruções do modelo para proteger informações confidenciais.

  • Modelo de extração: Use uma opção de modelo fornecida no console. O modelo atual é o qwen3.8-flash.

Configure a estratégia de armazenamento

Adição de eventos

Cada fato extraído é adicionado como uma nova memória, o que é ideal para manter o histórico de eventos. Após ativar a Deduplication, os resultados duplicados que possuem o mesmo escopo de negócio, source e chave de fato são ignorados. Descrições semelhantes de sources diferentes ainda podem ser armazenadas separadamente.

Por exemplo, as solicitações feitas pelo mesmo cliente durante duas sessões de atendimento podem ser mantidas separadamente para rastreamento posterior.

Atualização por mesclagem

O sistema primeiro pesquisa memórias existentes no mesmo escopo de negócio e, em seguida, determina quais ações executar com base na entrada. Este modo é adequado para manter informações em constante mudança, como preferências de usuário e o status do cliente.

Item de configuração

Descrição

Chave de mesclagem

A Semantic similarity pesquisa por similaridade de conteúdo. O factKey pesquisa pela chave do fato. O factKey + semantic combina ambos os métodos.

Limiar de similaridade

Valores válidos: 0 a 1. Valor padrão: 0.4. Este limiar é usado para encontrar memórias existentes relacionadas. Não é o limiar de pontuação para os resultados retornados pela recuperação do aplicativo.

Ações permitidas

Selecione as ações que podem ser executadas automaticamente: ADD, UPDATE, MERGE e DELETE. Mantenha pelo menos uma ação.

O factKey identifica um tipo de fato, como as preferências alimentares de um usuário específico. A tabela a seguir descreve as ações.

Ação

Descrição

ADD

Adiciona uma memória.

UPDATE

Atualiza uma memória existente.

MERGE

Mescla memórias relacionadas.

DELETE

Processa memórias antigas que não são mais válidas com base em novos fatos. O tratamento real de armazenamento está sujeito ao status do registro e às auditorias.

Por exemplo, se uma nova entrada mudar de "gosta de bebidas doces" para "agora prefere bebidas sem açúcar", o sistema poderá propor uma atualização ou adição. A ação real depende do escopo, do conteúdo existente, da estratégia e do resultado da extração. Use amostras para observar as ações propostas antes de decidir quais alterações automáticas permitir.

Proteção contra edição manual e período de retenção

A Manual edit protection vem ativada por padrão. Se a extração automática precisar modificar uma memória revisada manualmente, o sistema manterá o conteúdo atual e registrará a alteração como pendente de revisão. O status de revisão da memória e as auditorias relacionadas podem ajudar você a determinar por que o novo conteúdo não sobrescreveu diretamente o conteúdo antigo.

O Expiration days deve ser um número inteiro não negativo. O valor 0 indica que as memórias nunca expiram. Um valor positivo define o período de retenção para as memórias gravadas posteriormente. Não presuma que a alteração dessa configuração limpará retroativamente todos os registros históricos.

Configure o escopo de negócio e a auditoria

Item de configuração

Descrição

Escopo obrigatório para recall

Selecione userId, agentId, appId e runId. Uma solicitação deve conter pelo menos uma das dimensões selecionadas. Se este parâmetro for deixado vazio, nenhum requisito adicional será aplicado.

Dias de retenção de auditoria

Valores válidos: 1 a 180. Valor padrão: 30.

Modo de registro de log de consulta

O Log Original Text armazena o texto da consulta. O Log HMAC Only armazena o resumo da consulta, e a página de auditoria não exibe o texto original da consulta.

Registrar candidatos descartados

Registra candidatos que não são retornados no final, conforme necessário, para ajudar a analisar o estágio em que a filtragem ocorre.

As condições do escopo de negócio restringem os objetos a serem consultados, e as chaves de API são usadas para autenticação de acesso. O aplicativo deve determinar os IDs que podem ser consultados a partir de um contexto de negócio confiável. Se uma consulta fornecer vários IDs, todos eles deverão corresponder.

Para obter informações sobre como usar as configurações de auditoria, consulte {{XREF_0}}.

Verifique as estratégias com amostras

  1. Na etapa Preview and Confirm do assistente de criação ou em Strategy > Sample Preview de um repositório existente, cole uma ou mais amostras. É possível colar até 20 amostras.

  2. Clique em Run Preview.

  3. Verifique os Extracted Facts, a Storage Action e o Skip Reason de cada amostra. Preste atenção especial à precisão dos fatos, se as categorias mantêm as informações necessárias e se ocorrem atualizações ou exclusões inesperadas.

A amostra a seguir pode ser colada na caixa de entrada da pré-visualização. A pré-visualização usa o campo aninhado scope para representar o escopo de negócio. Para obter informações sobre o formato de campo plano das sources de Dataset, consulte {{XREF_1}}.

[
  {
    "sourceId": "preview-001",
    "scope": {"userId": "user-001"},
    "messages": [{"role": "user", "content": "I like light, mildly spicy home-style dishes"}]
  }
]

Para sources de rastreamento ou Dataset, você pode deixar as amostras vazias, e o sistema amostrará dados da source de dados configurada. Para sources de gravação manual, é necessário colar amostras. A pré-visualização usa a configuração no formulário atual e não exige que você a salve primeiro. A pré-visualização não grava memórias formais nem gera registros de auditoria para extração e armazenamento formais.

Salve a estratégia e visualize as versões

Após verificar o resultado da pré-visualização, clique em Save Strategy. Depois que a estratégia for salva, verifique informações como o resumo da estratégia e o horário de criação da versão atual no Version History.

O botão Reset na página descarta as alterações não salvas no formulário e restaura a configuração salva atual. O histórico de versões é usado para visualizar os registros existentes. Salvar uma estratégia não reextrai automaticamente todos os dados históricos.