KQL Builder

Propósito e Intención del usuario: la herramienta traduce objetivos comerciales en expresiones KQL robustas de eDiscovery, habilitando a equipos legales y de IT para crear búsquedas precisas en correos, documentos, chats y almacenamiento de archivos. Enfatiza la repetibilidad, trails auditable y exportabilidad para flujos de trabajo de litigio y cumplimiento. Usuarios previstos: analistas eDiscovery, operaciones legales, responsables de cumplimiento y administradores de IT que requieren construcción de consultas guiada por dominio.
Lógica central y funciones: El sistema utiliza un modelo basado en campos con componentes obligatorios y valores y admite agrupación avanzada mediante paréntesis. Impone validación de sintaxis, precedencia de operadores y exportación estructurada. Funciones opcionales: plantillas reutilizables, historial de versiones, importación/exportación de plantillas y bloques JSON listos para API para integración.
Entradas y salidas: Los usuarios proporcionan alcance de contenido, definiciones de campo, rangos de fechas, indicadores de adjuntos y valores de muestra. La herramienta genera una cadena KQL, un resumen y un indicador de validez de sintaxis, con validación de fecha ISO 8601. Las exportaciones pueden ser consultas independientes o bloques integrados en pipelines empresariales.
Algoritmos y cálculos: Criterios de alto nivel se mapean a tokens KQL (p. ej., contiene, es igual, empieza con, termina con). El motor agrupa expresiones con paréntesis, aplica literales de fecha, escapa caracteres especiales y concatena tokens con lógica AND/OR/NOT para formar la consulta final.
Errores y casos límite: La herramienta reporta nombres de campo no válidos, operadores no soportados, paréntesis desbalanceados, valores vacíos o problemas de análisis de fechas con detalles de error estructurados y sin mensajes de UI. Si fuentes de datos externas no están disponibles, conserva la entrada y señala el problema.
Industria/Región y Localización: Se requieren fechas ISO 8601; las horas son UTC a menos que se indique una zona horaria. Se asume la sintaxis KQL en inglés; la localización se limita a formatos de fecha.
Suposiciones y Exclusiones: Se asume acceso a un índice eDiscovery y mapeo de campos a entidades soportadas. UI, autenticación y renderizado de datos quedan fuera del alcance; solo se genera KQL y metadatos.