Asistente IA de NexGestión y ForgeNEX Module Lab¶
Este documento define los dos usos de la IA que conviven alrededor de NexGestión. No deben confundirse: uno ayuda a utilizar el CRM y el otro ayuda a desarrollar módulos.
1. Ayuda funcional dentro del CRM¶
El CRM puede abrir un chatbot de ayuda conectado con ForgeNEX Module Lab. Su objetivo es resolver dudas prácticas de uso, en lenguaje claro y sin exigir conocimientos técnicos.
Qué puede explicar¶
- cómo crear, editar o localizar un cliente, prospecto, tarea o evento;
- cómo preparar un presupuesto, consultar una factura o gestionar un ticket;
- dónde encontrar una vista o una configuración del CRM;
- cómo utilizar el portal del cliente, la base de conocimiento y las notificaciones;
- qué pasos seguir en una operación habitual de un módulo cuando existe una guía funcional publicada.
Cómo hacer una buena pregunta¶
Indica la acción que quieres realizar y, si la conoces, la pantalla en la que estás. Por ejemplo:
- «¿Cómo doy de alta un cliente empresa?»
- «¿Dónde veo las tareas vencidas de esta semana?»
- «Quiero enviar un presupuesto y después convertirlo en factura».
El asistente debe responder con pasos numerados, nombres visibles en el CRM y la ruta de navegación cuando esté documentada.
Límites de esta ayuda¶
- explica el uso, pero no ejecuta cambios en los datos del CRM desde este chatbot;
- no inventa botones, rutas, permisos ni funciones que no estén documentados;
- no sustituye al administrador, al partner ni al soporte cuando hay un error, una incidencia de datos o una decisión fiscal;
- no es un asistente de programación: las preguntas técnicas deben dirigirse al chat de desarrollo de Labs.
No se deben introducir contraseñas, API keys, tokens ni datos personales que no sean necesarios para formular la consulta.
2. Asistente de desarrollo en Module Lab¶
ForgeNEX Module Lab es el espacio independiente para crear, editar y depurar módulos del CRM. Su chat de desarrollo sí puede hablar de código, manifiestos, vistas, acciones, assets, pruebas y contratos de módulos.
El asistente de Labs debe:
- trabajar dentro del workspace privado del usuario o tenant;
- leer primero la documentación de entrenamiento del laboratorio;
- reutilizar contratos y capacidades existentes del CRM;
- detenerse cuando falte un contrato documentado, en lugar de inventarlo;
- mantener la documentación local del módulo cuando cambie su comportamiento.
Labs no es una alternativa para consultar datos operativos del CRM ni para modificar directamente el core. La publicación de un módulo hacia un tenant es un paso separado y requiere los permisos correspondientes.
3. Diferencia con la capa agéntica¶
La ayuda funcional de este documento es conversacional y de sólo lectura. La capa agéntica del CRM está pensada para integraciones y agentes con scopes explícitos. Una IA externa puede consultar o ejecutar operaciones mediante la API agéntica sólo cuando su perfil tenga los permisos necesarios y, para las acciones sensibles, una confirmación explícita.
Por tanto:
| Necesidad | Superficie correcta |
|---|---|
| Aprender a usar una pantalla del CRM | Chat de ayuda funcional |
| Crear o depurar un módulo | Chat de desarrollo de Labs |
| Automatizar operaciones sobre datos | API REST o capa agéntica con scopes |
| Publicar conocimiento para clientes | Base de conocimiento del CRM |
4. Documentación y actualización¶
La fuente maestra de estas guías está en docs/nexgestion-docs/. Antes de
publicar una respuesta, la IA debe priorizar la documentación publicada y
reconocer cuándo una guía no cubre la pregunta.
Cuando cambie una pantalla, un nombre de menú, un procedimiento o un permiso:
- actualiza el manual funcional afectado;
- actualiza este documento si cambia la separación entre CRM, Labs y API;
- ejecuta el sincronizador de documentación de Module Lab antes de construir la imagen;
- prueba una pregunta representativa del flujo modificado.