Volver al índice

ConsultasAI - Consultas con Inteligencia Artificial

Versión 1.0 - Realiza consultas en lenguaje natural sobre tu base de datos

Descripción General

ConsultasAI permite realizar consultas en lenguaje natural que se transforman automáticamente en consultas SQL seguras (solo SELECT) sobre la base de datos de ContERP. Utiliza inteligencia artificial para entender tus preguntas y generar las respuestas que necesitas.

Requisitos

  • PHP 8.0 o superior con extensión cURL habilitada
  • Clave de API de OpenAI (endpoint de Chat Completions)
  • ContERP Core 2025 o superior
  • Conexión a internet para acceder a la API de OpenAI

Configuración

Antes de usar ConsultasAI, debes configurar tu clave de API:

  1. Ve a Ajustes → ConsultasAI
  2. Completa los siguientes campos:
    • apichatgpt: Tu clave de API de OpenAI
    • version: Modelo a utilizar (ej. gpt-4o-mini, gpt-4)
    • prompt: Instrucciones del sistema para generar SQL. Incluye referencias a tablas de ContERP
  3. Guarda la configuración
Importante: Mantén tu clave de API segura y no la compartas públicamente.

Uso del Módulo

  1. Abre el controlador ConsultasAI desde el menú Informes/Reports
  2. Escribe una pregunta en lenguaje natural en el campo de consulta
  3. Ejemplos de preguntas:
    • "Ventas totales por mes en 2024"
    • "Top 10 clientes con más facturas"
    • "Productos con stock bajo"
    • "Facturas pendientes de pago"
  4. Haz clic en Consultar
  5. Se generará un SELECT que se ejecutará automáticamente
  6. Los resultados se mostrarán en formato tabular
  7. Puedes alternar la visualización para ver la consulta SQL generada

Seguridad

ConsultasAI implementa múltiples medidas de seguridad:

  • Solo se ejecutan sentencias que comiencen por SELECT
  • Se bloquean palabras peligrosas: UPDATE, DELETE, INSERT, DROP, ALTER, TRUNCATE
  • No se permiten múltiples sentencias separadas por punto y coma (;)
  • Validación exhaustiva antes de ejecutar cualquier consulta
Seguro: Todas las consultas son validadas antes de ejecutarse, garantizando la integridad de tus datos.

Ejemplos de Consultas

Consultas de Ventas

  • "¿Cuánto se vendió el mes pasado?"
  • "Ventas por cliente en el último trimestre"
  • "Facturas emitidas hoy"

Consultas de Inventario

  • "Productos con menos de 10 unidades en stock"
  • "Productos más vendidos este año"
  • "Valor total del inventario"

Consultas Financieras

  • "Total de recibos pendientes"
  • "Gastos del mes actual"
  • "Balance de cuentas por cobrar"

Solución de Problemas

Error: API no configurada

Si ves un mensaje indicando que la API no está configurada:

  1. Verifica que hayas ingresado tu clave de API en Ajustes
  2. Confirma que la clave sea válida y tenga créditos disponibles
  3. Revisa tu conexión a internet

Error: Consulta no válida

Si la consulta no se ejecuta:

  1. Reformula tu pregunta de manera más clara
  2. Verifica que estés preguntando sobre datos que existen en ContERP
  3. Revisa la consulta SQL generada para identificar el problema

Soporte

Si encuentras errores de despliegue:

  • Limpia y redepliega plugins desde AdminPlugins
  • Revisa el log del sistema para más detalles
  • Contacta con el equipo de soporte técnico