Gestionar índices de contextualización

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

La pestaña Índices de contextualización te permite supervisar el estado y salud de tus índices y seguir su progreso de ingestión en el nivel de tenant.

La sección Supervisión del índice proporciona información gráfica sobre las siguientes métricas:

• Consultas: realiza un seguimiento del número de consultas realizadas en tus índices durante un intervalo de tiempo seleccionado.
• Índice: muestra el número de trabajos de incorporación completados.Si no se han ejecutado trabajos en el período seleccionado, se muestra una imagen de marcador de posición.

La tabla Índices enumera todos los índices disponibles en tu tenant. Para obtener información más granular sobre los índices, selecciona un índice de la tabla. . La vista individual proporciona la siguiente información: .

• Nombre del índice, carpeta y origen de datos
• Estado de salud, que indica si un índice está saludable o degradado
• Tamaño de almacenamiento, Estado de ingestión, Última sincronización y Últimas marcas de tiempo consultadas

Selecciona un índice de la tabla para abrir su página de detalles. La vista de detalles del índice proporciona:

• Consultas durante el intervalo seleccionado.
• Un gráfico de salud que muestra la puntuación general de salud y los criterios de los dos componentes.
• El historial de incorporación, el listado se completó, falló, omitió o se eliminaron las ejecuciones de sincronización.

Usa esta vista para investigar índices degradados, revisar la fiabilidad de la incorporación o marcar cuándo se consultó por última vez un índice.

Puntuación de salud del índice

El estado del índice te ayuda a supervisar la condición de tus índices de contextualización e identificar aquellos que pueden necesitar mantenimiento o limpieza. Proporciona una puntuación automatizada y objetiva que muestra el rendimiento de cada índice y con qué frecuencia se utiliza.

Cada índice recibe una puntuación de salud basada en dos criterios:

• Fiabilidad de la incorporación: con qué éxito se procesaron los documentos durante la última ejecución de incorporación.
• Utilización: cómo de recientemente se ha consultado el índice.

La puntuación combinada te ayuda a determinar si un índice está sano y entrega valor (puntuación general por encima del 75 %) o degradado (puntuación general por debajo del 75 %). La puntuación se actualiza automáticamente después de cada ingestión o consulta correcta.

El estado del índice se recalcula cada 15 minutos para todos los inquilinos y solo se aplica a los índices con trabajos de incorporación completados.Los nuevos índices tienen un período de gracia de 24 horas después de su creación antes de que comience la puntuación de estado.

La siguiente tabla describe cómo se calcula y pondera cada criterio de salud para determinar la puntuación general de salud del índice.

Criterio	Métrica	Fórmula	Notas
Fiabilidad de la ingestión	Tasa de éxito de la última ingestión	100 × (1 - failed_docs / total_docs)	Se excluyen los documentos omitidos y eliminados. Si no se completa ninguna ingestión en 24 horas, la puntuación = 0.
Utilización	Días desde la última consulta (máx. 90 días)	100 × (1 - days_since_last_query / 90)	Después de 24 horas sin ninguna consulta, puntuación = 0.
Salud general	Promedio de ambas métricas	(Fiabilidad de la ingestión + uso)	Solo se calcula si existen las puntuaciones de ambos componentes.

Puedes revisar el estado de salud en dos lugares:

• La lista Índices de contextualización: la columna Salud muestra un indicador coloreado (verde para saludable, rojo para degradado). Al pasar el ratón sobre ella, se muestran detalles para cada dimensión (Fiabilidad de ingestión y Utilización).
• La vista de detalles del índice: el gráfico de Salud dedicado muestra la puntuación general y las métricas del componente.También puedes realizar un seguimiento del historial de procesamiento e investigar incidencias cuando la fiabilidad es baja.