O AgentLoop Memory Store (MemoryStore) armazena fatos, preferências e contexto de negócios que os agentes de IA podem reutilizar em diferentes sessões. Você pode gravar conversas por meio da API ou obter entradas continuamente a partir de rastros de agentes ou de um Dataset. O Memory Store extrai memórias de longo prazo com base em estratégias, e o aplicativo recupera informações relevantes ao processar uma nova pergunta. Por exemplo, um usuário diz a um assistente de estilo de vida: "Gosto de pratos leves e levemente picantes" e, mais tarde, afirma: "Estou reduzindo o consumo de açúcar recentemente". O Memory Store mantém essas preferências atualizadas. Antes de recomendar um jantar, o aplicativo recupera as memórias relevantes do usuário e fornece os resultados ao agente junto com a pergunta atual.
Quais problemas o Memory Store resolve
|
Cenário |
Memórias que podem ser armazenadas |
Como são utilizadas |
|
Assistente pessoal |
Interesses, hábitos, estilo de comunicação e preferências de longo prazo |
Recupere o contexto relevante após o início de uma nova sessão para reduzir perguntas repetidas |
|
Atendimento ao cliente |
Histórico de uso do product, solicitações de service e preferências de comunicação fornecidas pelos usuários |
Complemente o contexto do usuário para o problema atual |
|
Assistente de negócios corporativos |
O status e relacionamentos de clientes, projetos ou objetos de negócios |
Com o tempo, atualize as informações existentes com base em interações posteriores para servir de referência na próxima tarefa |
|
Utilização de dados históricos |
Fatos reutilizáveis em rastros coletados e conjuntos de dados curados |
Filtre as entradas e extraia memórias continuamente sem precisar chamar a API de gravação para cada registro |
As memórias se acumulam à medida que as interações de negócios continuam. Durante a recuperação, as informações relevantes são selecionadas com base no escopo de negócios, como o usuário, o aplicativo ou o agente. Para eventos que precisam ser rastreados, armazene-os no modo de adição. Já para preferências e status de negócios que mudam ao longo do tempo, mantenha-os no modo de atualização por mesclagem.
Conceitos principais
|
Conceito |
Descrição |
|
Memory Store |
Recurso criado e gerenciado em um espaço de agente. Contém uma source de dados, uma estratégia de extração, uma estratégia de armazenamento e memórias de longo prazo. |
|
source de dados |
A source de entrada para extração de memória, incluindo gravação manual, rastros de agentes e Dataset. |
|
Memória de longo prazo |
Conteúdo extraído das entradas ou gravado diretamente para recuperação posterior, como "O usuário prefere comida leve". |
|
Estratégia de extração |
Determina em quais fatos focar, como categorizá-los e qual conteúdo excluir. |
|
Estratégia de armazenamento |
Determina se novas memórias serão adicionadas, ou se as memórias existentes serão atualizadas, mescladas ou excluídas com base nas já existentes. |
|
Escopo de negócios (scope) |
Associa memórias usando o ID do usuário, ID do agente, ID do aplicativo e ID de execução. Durante a recuperação, todas as condições especificadas limitam o escopo em conjunto. |
|
Versão da estratégia |
Registro de versão gerado quando as configurações de estratégia, como extração e armazenamento, são salvas. Utilizado para rastrear alterações de configuração. |
|
Recall |
Recupera memórias relevantes com base na pergunta atual e no escopo de negócios, e as retorna para o aplicativo. |
Para começar, selecione uma source de dados
|
source de dados |
Cenário aplicável |
O que preparar |
|
Gravação manual |
Para gravar, envie mensagens ativamente após o término de uma conversa. |
A API de gravação, uma chave de API do Memory Store e identificadores de usuário de negócios estáveis |
|
Rastro de agente |
Os dados de tempo de execução do agente já foram ingeridos no AgentLoop e você deseja reutilizar os rastros montados. |
Rastros de agentes no espaço de agente atual e condições de filtro, como o nome do service e o nome do agente |
|
Dataset |
As informações de negócios foram organizadas em entradas estruturadas por meio do processamento de dados. |
Um dataset no mesmo espaço de agente que atenda aos requisitos de campo do |
Ao criar um Memory Store, selecione uma source de dados para ele. O tipo de source de dados não pode ser alterado após a criação do Memory Store. Para um Memory Store que utiliza uma source de Dataset, o dataset vinculado também não pode ser substituído. Para usar uma source diferente, crie um novo Memory Store.
Da entrada ao uso no aplicativo
Receba as entradas: O aplicativo envia conversas, ou o Memory Store obtém registros dos rastros configurados ou do Dataset.
Extraia fatos: As informações a serem mantidas são extraídas com base na extração de fatos, no perfil de usuário consumidor, no gêmeo digital corporativo ou em uma instrução personalizada.
Mantenha memórias de longo prazo: Os resultados são armazenados com base na estratégia de adição de eventos ou atualização por mesclagem, e informações como revisões, sources e estratégias são retidas.
Recupere memórias relevantes: O aplicativo ou o console recupera memórias usando a pergunta atual e o escopo de negócios.
Monte o contexto do agente: O aplicativo fornece memórias úteis ao agente junto com a pergunta atual e as conversas recentes.
Inspecione e ajuste: Verifique os resultados usando a pré-visualização de amostra, edição de memória, detalhes de auditoria e estatísticas e, em seguida, ajuste as estratégias.
Após o recebimento das entradas, a extração e as gravações na memória de longo prazo são processadas de forma assíncrona. O aplicativo deve confirmar separadamente que as entradas foram recebidas, que as memórias de longo prazo podem ser recuperadas e que o conteúdo retornado foi adicionado à solicitação do agente. A pré-visualização de amostra serve para verificar o efeito das estratégias e não grava memórias formais.
Recursos do console
|
Entrada |
O que é possível fazer |
|
Criar Memory Store |
Configure um novo Memory Store na ordem "source de dados → Filtro / Schema → Estratégia → Pré-visualize e confirme" |
|
Visão geral |
Na visão geral, visualize as informações básicas, a source de dados, o progresso de consumo e o erro mais recente. Pause ou retome o consumo para sources de rastros ou Dataset. |
|
Recuperação de Memória de Longo Prazo |
Recupere memórias por pergunta e escopo de negócios, visualize o conteúdo, as revisões e as sources das memórias, e edite ou exclua memórias |
|
Estratégia |
Configure regras de extração e armazenamento, escopos e opções de auditoria, execute pré-visualizações de amostra e visualize o histórico de versões da estratégia |
|
Gravar Eventos |
Para auditoria, visualize eventos de entrada para um Memory Store que possui logs de eventos de gravação |
|
Detalhes de Auditoria |
Para detalhes, visualize eventos relacionados à extração, armazenamento e recall, e rastreie o que um recall retornou |
|
Estatísticas |
Para métricas, visualize métricas como a contagem de recall, taxa de recall não vazio, latência, funil de extração e consultas com zero resultados |
|
Chave de API e Integração |
Para acessar, crie credenciais de acesso e obtenha exemplos de integração da API HTTP e do SDK Python para a região atual |
Considerações de uso
Mantenha os identificadores consistentes: Use os mesmos identificadores de negócios para gravações e recuperações. Se você adicionar múltiplas condições de ID, as memórias deverão atender a todas essas condições. Para consultas entre sessões, não use incorretamente um ID de execução que pertença a apenas uma execução.
Para manter fatos, escolha como os fatos são mantidos: A adição de eventos é adequada para manter o histórico de um processo, enquanto a atualização por mesclagem é ideal para manter informações que mudam. Antes que você modifique uma estratégia, use amostras representativas para verificar os resultados da extração e as ações a serem executadas.
Proteja as revisões manuais: Para proteger, ative a proteção de edição manual para que a extração automática mantenha o conteúdo original ao encontrar conteúdo revisado manualmente, registrando a alteração como pendente de revisão.
Avalie o efeito real: As pontuações de recuperação, a taxa de recall não vazio e o número de resultados retornados refletem o comportamento de recuperação. O aplicativo também deve determinar se as informações retornadas são úteis e se o agente as utiliza corretamente.
Comece a usar
Para a primeira integração, leia Use a memory store. Para ajustar o escopo de extração, o método de armazenamento ou o período de retenção, consulte Configure memory extraction and storage strategies. Para rastrear resultados e solucionar problemas, consulte View memory audits and statistics.