Caso nenhuma memória seja gerada, o resultado da recuperação não seja o esperado ou você precise entender o uso, utilize as páginas Overview, Audit Details e Statistics do armazenamento de memória para inspecionar os processos de entrada, extração, armazenamento e recuperação.
Verifique se a source de dados é consumida conforme o esperado
Acesse a página de visão geral do armazenamento de memória e verifique o tipo de source, as condições de filtro, o status de consumo, o progresso e o erro mais recente.
Escrita manual: Primeiro, verifique a resposta da API de escrita. Se os logs de eventos de escrita estiverem disponíveis, visualize a entrada em Write Events.
Rastreamento do agente: Verifique se o workspace atual contém rastreamentos que atendem a condições como nome do service, nome do agente, número de etapas e horário de início.
Dataset: Verifique o dataset vinculado, a política de versão e as condições de filtro, e certifique-se de que os campos ainda estejam em conformidade com
MemorySourceV1.
Para sources de rastreamento ou Dataset, use Pause Consumption e Resume Consumption para controlar as leituras subsequentes. Uma página que mostra a criação do armazenamento ou a ausência de erros recentes não prova, por si só, que uma entrada específica gerou uma memória de longo prazo. Continue inspecionando os resultados de extração e armazenamento.
Visualize os detalhes da auditoria
Acesse a aba Audit Details do armazenamento de memória de destino.
Selecione o intervalo de tempo que deseja inspecionar e filtre por Event Type.
Localize eventos relacionados com base na source de entrada, no ID da memória, no ID do evento de recuperação ou na mensagem de erro.
As auditorias ajudam a distinguir as seguintes situações: uma entrada entrou em processamento, a extração não produziu fatos, o armazenamento adicionou ou atualizou uma memória, uma memória foi ignorada ou está com revisão pendente, e uma recuperação foi bem-sucedida, falhou ou retornou um resultado vazio.
Os logs de auditoria chegam de forma assíncrona a partir do processamento de negócios. Se nenhum registro estiver disponível imediatamente após uma operação, verifique o intervalo de tempo e as condições de filtro e consulte novamente mais tarde.
Rastreie uma recuperação
Após obter um ID de evento de recuperação na página Long-term Memory Retrieval, abra o registro de auditoria correspondente. Você também pode abrir os detalhes de uma recuperação em Statistics > Recent Recalls.
Concentre-se nas seguintes informações:
|
Informação |
Propósito |
|
Texto da consulta e escopo do negócio |
Verifique se a consulta tem como alvo o usuário, agente, aplicativo ou execução esperados. |
|
Status, código de erro e latência |
Distinja um resultado vazio normal de uma falha de execução. |
|
Número de resultados, classificações e pontuações |
Confirme quais memórias foram retornadas ao chamador. |
|
Conteúdo e revisão retornados |
Valide qual versão da memória foi retornada. |
|
Estágio de descarte |
Ative os logs relacionados e identifique o estágio em que um candidato foi descartado. |
Defina o log de consulta como Log HMAC Only para ocultar o texto original da consulta. Caso apareça uma mensagem de degradação de auditoria ou truncamento de conteúdo, interprete a integridade do registro conforme indicado. Não assuma que nenhuma recuperação ocorreu apenas porque os detalhes estão ausentes.
Interprete as estatísticas
|
Métrica ou visualização |
Significado e uso |
|
Contagem de recuperações |
O número de eventos de recuperação após a deduplicação. Use em conjunto com o intervalo de tempo para observar o volume de solicitações. |
|
Taxa de recuperações não vazias |
A porcentagem de recuperações bem-sucedidas que retornam pelo menos um resultado. Avalie esta métrica em conjunto com a qualidade do resultado. |
|
Latência P95 |
O percentil 95 da latência de recuperação, utilizado para identificar casos de alta latência. |
|
Contagem média de resultados |
Observe o número de memórias retornadas por cada recuperação. |
|
Contagem de extrações |
O número de linhas de entrada extraídas com sucesso. Este valor não representa o número de memórias de longo prazo que foram efetivamente adicionadas. |
|
Total de memórias |
Visualize o tamanho atual do armazenamento de memória. |
|
Funil de recuperação |
Compare os números de candidatos, candidatos após a filtragem de limiar, candidatos após a reclassificação e os resultados finais. |
|
Funil de extração |
Compare os números de itens coletados, enfileirados, extraídos com sucesso, gravados, ignorados e com revisão pendente. |
|
Memórias mais recuperadas |
Identifique as memórias que são retornadas com mais frequência. |
|
Consultas com resultado zero |
Identifique consultas que retornam repetidamente nenhum resultado e inspecione o escopo, a cobertura de entrada e as políticas. |
|
Recuperações recentes |
Analise em detalhe desde as tendências até as solicitações individuais. |
Selecione o mesmo intervalo de tempo antes de comparar tendências com solicitações individuais. O funil de extração é agregado por armazenamento de memória. Não assuma que o tipo de recuperação, o status da recuperação ou filtros semelhantes também se apliquem aos dados de extração.
A taxa de recuperações não vazias mede se as memórias são retornadas. Para avaliar se as memórias melhoram as respostas do agente, verifique também se o aplicativo usa o conteúdo retornado e avalie os resultados reais da tarefa.
Caminhos comuns de solução de problemas
|
Sintoma |
Ordem de inspeção recomendada |
|
Nenhuma nova memória é gerada |
Disponibilidade de dados na source → Posição inicial e condições de filtro → Resultado da extração → Regras de categoria ou exclusão → Ação de armazenamento |
|
Novas informações não substituem informações antigas |
Uso do modo de anexação de eventos → Condições de mesclagem e ações permitidas → Acionamento da proteção contra edição manual |
|
As memórias existem, mas a consulta não retorna resultados |
Armazenamento e região → Consistência dos IDs de negócios → Filtros adicionais → Texto da consulta e registros relacionados ao limiar |
|
A taxa de recuperações não vazias diminui |
Adição de novo tráfego de negócios ou tipos de consulta → Escopo do negócio e cobertura de memória → Consultas com resultado zero e detalhes de solicitações individuais |
|
Nenhum dado é exibido no relatório |
Intervalo de tempo e filtros → Recursos de log associados ao workspace e permissões de acesso → Chegada dos registros de auditoria |
Para ajustar a extração, o armazenamento ou o log de auditoria, consulte Configure memory extraction and storage strategies.