VERSION PRIMARIA – En validacion
Este instructivo define la arquitectura, configuracion y operacion de los agentes inteligentes del Ecosistema IDEA.
Este instructivo define la arquitectura, configuracion y operacion de los agentes inteligentes del Ecosistema IDEA.
Capitulo ERP: 05. Sistemas, TIC e Inteligencia Artificial
Categoria independiente: Modulo de Agentes Inteligentes (IA)
1. Que es el Modulo de Agentes Inteligentes
Es la capa de inteligencia artificial operativa del Ecosistema IDEA. No es un chatbot decorativo ni un asistente generico: son agentes especializados que consultan la base de datos en tiempo real, ejecutan tramites, coordinan entre personas y toman decisiones dentro de los limites autorizados.
Cada agente tiene un proposito especifico, permisos definidos y canales de comunicacion asignados. El motor comun es Google Vertex AI (Gemini) con Function Calling para ejecutar acciones reales sobre Supabase.
Principio fundamental: La IA respeta los mismos permisos del sistema. Un agente que atiende alumnos no puede ver datos de nomina. Un agente de cobranza no puede modificar notas academicas. Todo queda en el log de auditoria.
RELACION CON OTROS MODULOS
Este modulo NO incluye la configuracion de canales (eso es Comunicaciones) ni la gestion de tickets (eso es Soporte al Usuario). Los Agentes IA usan los canales de Comunicaciones y apoyan al Soporte, pero son un modulo independiente con su propio equipo.
Este modulo NO incluye la configuracion de canales (eso es Comunicaciones) ni la gestion de tickets (eso es Soporte al Usuario). Los Agentes IA usan los canales de Comunicaciones y apoyan al Soporte, pero son un modulo independiente con su propio equipo.
2. Catalogo de Agentes
| Agente | Funcion | Canales | Nivel de acceso |
|---|---|---|---|
| Asistente del Usuario | Guia al alumno/cliente en tramites, consultas de cuenta, pagos, cambios de grupo, solicitudes de cursos | Chat interno, WhatsApp | Solo datos del usuario autenticado |
| Coordinador CIA | Asiste en la planificacion academica: busca disponibilidad de instructores, propone horarios, genera cronogramas | Chat interno, Email | Cronogramas, instructores, grupos |
| Agente de Cobranza | Seguimiento automatico de mora: envia recordatorios progresivos, ofrece opciones de pago, escala a humano si es necesario | WhatsApp, SMS, Email | Datos financieros del usuario |
| Agente INAC | Genera reportes, listados y expedientes solicitados por el INAC. Alerta sobre documentos por vencer | Email, Dashboard | Expedientes, certificaciones, historial academico |
| Agente de Soporte | Atiende tickets de soporte nivel 1: responde preguntas frecuentes, crea tickets si no puede resolver, escala a agente humano | Chat interno, WhatsApp | Base de conocimiento, tickets |
| Agente de RRHH | Asiste al personal: consulta de vacaciones, permisos, hojas de tiempo, evaluaciones | Chat interno | Datos del empleado autenticado |
| Agente Comercial | Atiende prospectos: cotiza cursos, responde dudas, agenda visitas, convierte leads en alumnos | WhatsApp, Web chat, Instagram | Catalogo, precios, disponibilidad |
3. Arquitectura Tecnica
| Capa | Tecnologia | Funcion |
|---|---|---|
| Motor de IA | Google Vertex AI (Gemini Pro / Flash) | Comprension de lenguaje natural, razonamiento, generacion de respuestas |
| Function Calling | Vertex AI Agents Framework | La IA invoca funciones reales: consultar_cronograma(), enviar_whatsapp(), crear_registro() |
| Backend | Supabase Edge Functions (Deno/TypeScript) | Funciones serverless que la IA puede invocar. Cada funcion tiene permisos RLS |
| Base de datos | Supabase (PostgreSQL) | Fuente unica de verdad. La IA lee y escribe con los mismos permisos del rol |
| Canales | Tellbid (WhatsApp), SendGrid (Email), Twilio (SMS), Chat interno | La IA se comunica por el canal preferido del usuario |
| Monitoreo | Google Cloud Logging + Dashboard propio | Metricas: conversaciones/dia, satisfaccion, tasa de resolucion, escalamientos |
4. Equipo Responsable
| Rol | Responsabilidad |
|---|---|
| Administrador de IA | Configurar agentes, ajustar prompts, definir limites, gestionar tokens y API keys |
| Entrenador de Agentes | Revisar conversaciones, mejorar respuestas, agregar conocimiento, corregir errores |
| Monitor de Calidad | Auditar interacciones, medir satisfaccion, detectar escalamientos fallidos |
| Desarrollador | Crear nuevas funciones (Function Calling), integrar nuevos canales, mantener Edge Functions |
5. Normas de Operacion
- Transparencia: El usuario siempre sabe que habla con una IA. Nunca se hace pasar por humano.
- Escalamiento: Si la IA no puede resolver en 3 intentos, escala a un agente humano automaticamente.
- Auditoria: Cada conversacion queda registrada en el log con timestamp, usuario, agente, acciones ejecutadas.
- Limites: La IA no puede: eliminar registros, cambiar roles de usuario, aprobar pagos mayores a un monto definido, ni acceder a datos fuera de su ambito.
- Actualizacion: Los prompts y funciones se revisan mensualmente. Cada cambio requiere aprobacion del Administrador de IA.
6. Instructivos de este Modulo
Los siguientes instructivos se desarrollaran dentro de la categoria Modulo de Agentes Inteligentes (IA):
| Instructivo | Contenido | Estado |
|---|---|---|
| Configuracion de Vertex AI | API keys, tokens, modelos, parametros | Por crear |
| Diseno de Prompts por Agente | System prompts, instrucciones, limites, ejemplos | Por crear |
| Catalogo de Funciones (Function Calling) | Todas las funciones disponibles, parametros, permisos | Por crear |
| Protocolo de Escalamiento | Cuando y como la IA transfiere a un humano | Por crear |
| Metricas y Monitoreo | KPIs, dashboard, alertas de rendimiento | Por crear |
| Entrenamiento y Mejora Continua | Proceso de revision, correccion y actualizacion | Por crear |
7. Referencia
Ver: Instructivo Maestro de Usuarios (Seccion IA) | Alertas y Notificaciones | Normas de Roles y Accesos
