Asistente de IA

El asistente de IA de Aptli acelera el descubrimiento de datos en sus activos y datos operacionales. Haga una pregunta en lenguaje simple — "mostrar los recorridos de cable cerca de la subestación" o "¿qué sitios están por debajo del stock mínimo?" — y el sistema busca en sus entidades del mapa, órdenes de trabajo y base de datos antes de llamar al proveedor de IA. También puede dibujar un área de lazo en el mapa para consultar todo lo que hay dentro de ella, y la IA ayuda a mapear encabezados de columnas al importar archivos CSV o XLSX.

Barra de Herramientas de IA

La barra de herramientas de IA es la forma principal de hacer preguntas sobre sus datos. Aparece en la barra de navegación superior (escritorio) y es accesible desde la página del mapa en dispositivos móviles.

Abrir la Barra de Herramientas

• Atajo de teclado: Enter (cuando no hay ningún campo de entrada activo) abre el campo de entrada de IA de inmediato
• Clic: toque el ícono de IA en la barra de herramientas
• Página del mapa: disponible como campo de entrada persistente en la parte superior de la barra lateral del mapa

Cómo Funciona — Búsqueda por Niveles

Cuando envía una consulta, el sistema prueba tres niveles en secuencia, deteniéndose tan pronto como tiene una respuesta confiable:

1. Local  → Busca entidades ya cargadas en el mapa (instantáneo, sin llamada al servidor)
           → Devuelve puntos, líneas, polígonos coincidentes por nombre / valor de propiedad
           ↓ ¿Sin coincidencia?
2. Servidor → Consulta la base de datos en busca de entidades, órdenes de trabajo, informes, usuarios
           → Búsqueda de texto completo + filtro estructurado
           ↓ ¿Aún sin coincidencia, o la consulta es una oración?
3. IA     → Envía la consulta al proveedor de IA configurado
           → El proveedor interpreta la pregunta y devuelve datos estructurados

La detección de oraciones determina si una consulta debe saltar directamente al nivel 3. Consultas como "mostrar todos los recorridos de cable cerca de la subestación" se detectan como lenguaje natural y se envían directamente a la IA; consultas cortas como "cable 42" pasan primero por los niveles local y servidor.

Qué Puede Preguntar

• Búsquedas de entidades: "Poste A-123", "todos los sitios inactivos", "líneas con capacidad > 100"
• Estado del trabajo: "órdenes de trabajo abiertas asignadas a Sara", "informes enviados esta semana"
• Consultas de ubicación: "entidades cerca de Calle Principal y 5ta Avenida"
• Agregación: "¿cuántas tareas están vencidas en la Zona B?"
• Propiedades: "recursos donde la unidad de medida es metros"

Límite de Tasa

Cada usuario está sujeto a un límite de consultas de IA por hora (predeterminado: 20, configurable por el administrador en Configuración de IA). Las búsquedas locales y del servidor no cuentan contra este límite — solo las llamadas de IA del nivel 3. La barra de herramientas muestra la cuota restante cuando se acerca al límite.

Configuración del Proveedor y Modelo

Los administradores configuran el proveedor y el modelo de IA en Admin → Configuración → IA. Contacte a su administrador si las respuestas de IA no están disponibles o parecen degradadas.

Modo Lazo de IA

El lazo de IA es una herramienta del mapa que le permite dibujar un área a mano alzada y consultar a la IA sobre todo lo que hay dentro de ella.

Activar el Modo Lazo

1. Abra el mapa
2. Seleccione Lazo de IA en el selector de modo (el ícono de polígono naranja en la barra de herramientas del mapa)
3. El cursor cambia a una mira

Dibujar un Área de Consulta

1. Haga clic (o toque) para colocar el primer punto
2. Continúe haciendo clic para trazar el área de interés
3. Haga doble clic (o toque el punto de inicio) para cerrar el polígono
4. Aparece un polígono naranja en el mapa; el panel de consulta de IA se abre automáticamente

La Consulta

El lazo recopila:

• Todas las entidades de Aptli (puntos, líneas, polígonos) dentro del área dibujada
• Contexto de OSM / Overpass para la misma área (nombres de calles, uso del suelo, tipos de infraestructura)

Este contexto combinado se envía a la IA junto con su pregunta. Puede preguntar:

• "¿Qué infraestructura cruza este bloque?"
• "Resume las órdenes de trabajo que cubren esta área"
• "¿Hay alguna entidad sin una zona de mantenimiento asignada?"
• "¿Qué sitios dentro de este polígono están por debajo del stock mínimo?"

Editar el Polígono

El polígono de lazo naranja permanece editable después de la primera consulta:

• Arrastre vértices para redimensionar
• Haga clic en un borde para agregar un nuevo vértice
• Vuelva a enviar la consulta para actualizar los resultados con la nueva forma

Limpiar el Lazo

Haga clic en el botón Limpiar Lazo (×) o cambie a cualquier otro modo del mapa. El polígono naranja se elimina.

Contexto de IA en Esquemas

En la página de esquemas, un creador de contexto de IA dedicado resume el diagrama abierto y lo envía a la IA para su análisis.

Qué Hace

La IA construye un resumen estructurado del diagrama que incluye:

• Tipos y cantidades de nodos (cuántos transformadores, divisores, puntos de extremo)
• Tipos de bordes y conexiones (qué nodos se conectan con cuáles)
• Anotaciones de capacidad y carga (si están presentes en las propiedades del esquema)
• Nodos huérfanos (nodos sin conexiones)

Este resumen estructurado se envía como contexto junto con su consulta, de modo que puede preguntar:

• "¿Qué segmento tiene la carga más alta?"
• "Encuentra nodos sin conexiones aguas abajo"
• "¿Qué pasaría si el Nodo 7 falla?"
• "Resume el camino desde el extremo inicial hasta el punto de extremo E-42"

Acceder al Contexto de IA en Esquemas

1. Abra un esquema desde la página de esquemas o desde el panel de relaciones de una entidad
2. El campo de entrada de IA aparece en la barra de herramientas del esquema (parte superior derecha de la vista del diagrama)
3. Escriba su pregunta y presione Enter

Mapeo de Columnas por IA (Importación CSV / XLSX)

Cuando importa un archivo CSV o XLSX usando el panel de Transferencia de Datos (o el flujo de trabajo de importación masiva), la IA ayuda a mapear los encabezados de columnas de su archivo con el esquema de campos de Aptli.

Cómo Funciona el Mapeo de Columnas

Después de cargar un archivo:

1. Aptli lee la primera fila (encabezados) del archivo
2. Para cada encabezado, la IA sugiere el campo de Aptli que mejor coincide (nombre, latitud, longitud, recurso, sitio, estado, etc.)
3. Las columnas coincidentes aparecen pre-completadas en la tabla de mapeo
4. Las columnas sin coincidencia se señalan para asignación manual u omisión

Revisar y Confirmar

La tabla de mapeo muestra:

• Columna del archivo — el nombre original del encabezado
• Campo mapeado — el campo sugerido por Aptli
• Valores de muestra — las primeras 3 filas de datos de esa columna

Puede:

• Aceptar la sugerencia (hacer clic en la marca de verificación)
• Cambiar el mapeo (lista desplegable)
• Omitir la columna (desactivar el interruptor)
• Marcarla como propiedad personalizada (se almacena en el objeto properties)

Aplicar la Importación

Una vez confirmado el mapeo, haga clic en Aplicar. El sistema:

1. Procesa cada fila según el mapeo confirmado
2. Crea o actualiza registros en el modelo de destino (entidades, recursos, elementos de stock, etc.)
3. Reporta el recuento de filas creadas / actualizadas / omitidas / fallidas

Tipos de Archivo Admitidos

Para formatos específicos de GIS (GDB, SHP, GeoPackage, DXF, DGN), consulte Importaciones de Archivos GIS — esos siguen un proceso diferente.

Consejos y Limitaciones

Las consultas de IA requieren acceso a la red. Las llamadas de IA del nivel 3 van a un proveedor externo. Las búsquedas local (nivel 1) y del servidor (nivel 2) funcionan sin conexión.

La IA no modifica datos. Todos los resultados de la IA son de solo lectura. Guardar, crear o eliminar registros siempre requiere una acción explícita del usuario.

Ventana de contexto. Los esquemas o conjuntos de entidades muy grandes pueden resumirse antes de enviarse a la IA. Si los resultados parecen incompletos, intente reducir el área del lazo o sea más específico en su consulta.

Interrupciones del proveedor. Si el proveedor de IA configurado no está disponible, las búsquedas del nivel 3 fallan de forma controlada con un mensaje de error. Los niveles 1 y 2 siguen funcionando.