Gerenciamento de índices de contextualização

Context Grounding index monitoring on the Agents page, covering query and ingestion metrics, per-index details, and the automated index health score.

A guia Contextualização de índices permite que você monitore o status e a integridade de seus índices e rastreie o progresso da ingestão no nível do tenant.

A seção Monitoramento de índices fornece insights gráficos sobre as seguintes métricas:

• Consultas: rastreia o número de consultas realizadas em seus índices durante um intervalo de tempo selecionado.
• Trabalhos de índice: exibe o número de trabalhos de ingestão concluídos. Se nenhum trabalho tiver sido executado no período selecionado, um gráfico de espaço reservado será exibido.

A tabela Índices lista todos os índices disponíveis em seu tenant. Para obter informações mais detalhadas sobre índices, selecione um índice da tabela. A visualização individual fornece as seguintes informações:

• Nome do índice, pasta e dados de origem
• Status de integridade, indicando se um índice está Saudável ou Degradado
• Tamanho do armazenamento, status da ingestão, Última sincronização e Última consulta

Selecione um índice na tabela para abrir sua página de detalhes. A Visualização de Detalhes do Índice fornece:

• Consultas durante o intervalo selecionado.
• Um gráfico de integridade mostrando a pontuação geral de integridade e os dois critérios de componentes.
• Histórico de ingestão, listagem de execuções de sincronização concluídas, com falha, ignoradas ou excluídas.

Use esta visualização para investigar índices degradados, revisar a confiabilidade da ingestão ou marcar quando um índice foi consultado pela última vez.

Pontuação de integridade do índice

A integridade do índice ajuda você a monitorar a condição de seus índices de contextualização e identificar aqueles que podem precisar de manutenção ou limpeza. Ele fornece uma pontuação automatizada e objetiva mostrando o quão bem cada índice é executado e com que frequência ele é usado.

Cada Índice recebe uma pontuação de integridade com base em dois critérios:

• Confiabilidade da ingestão – Quão bem os documentos foram processados durante a execução de ingestão mais recente.
• Utilização – Quão recentemente o índice foi consultado.

A pontuação combinada ajuda você a determinar se um índice está saudável e está entregando valor (pontuação geral acima de 75%), ou degradado (pontuação geral de 75% ou abaixo). A pontuação é atualizada automaticamente após cada ingestão ou consulta bem-sucedida.

A integridade do índice é recalculada a cada 15 minutos para todos os tenants e aplica-se apenas a índices com trabalhos de ingestão concluídos. Os novos índices têm um período de carência de 24 horas após a criação antes que a pontuação de integridade comece.

A tabela a seguir descreve como cada critério de Índice é calculado e ponderado para determinar a pontuação geral de integridade do Índice.

Critério	Métrica	Fórmula	Observações
Confiabilidade da ingestão	Taxa de sucesso da última ingestão.	100 × (1 - failed_docs / total_docs)	Documentos ignorados e excluídos não são considerados.Se nenhuma ingestão for concluída dentro de 24 horas, a pontuação = 0.
Utilização	Dias desde a última consulta (Máx. 90 dias)	100 × (1 - days_since_last_query / 90)	Após 24 horas sem nenhuma consulta, a pontuação é 0.
Saúde geral	Média de ambas as métricas	(Confiabilidade da ingestão + utilização)	Calculado apenas se ambas as pontuações de componentes existirem.

Você pode revisar o status de integridade em dois locais:

• A lista de índices de contextualização – A coluna mostra um indicador colorido (verde para Saudável, vermelho para Degradado).Passar o mouse sobre ele exibe detalhes para cada Dimension (Confiabilidade da ingestão e Utilização).
• A visualização de detalhes do índice – O gráfico de Saúde dedicado exibe a pontuação geral e as métricas de componentes.Você também pode rastrear o histórico de ingestão e investigar problemas quando a confiabilidade é baixa.