Funciones de IA y Human in the Loop
Propósito
La plataforma incorpora funciones de IA para ayudar a preparar preguntas, analizar respuestas, redactar contenido arquitectónico, proponer cambios en catálogos y construir informes. Este módulo explica cómo se relacionan esas funciones con las decisiones de las personas.
La expresión Human in the Loop significa que la IA participa en el análisis y la propuesta, pero una persona conserva el control sobre los cambios que modifican el proyecto, las calificaciones y las aprobaciones.
1. El ciclo de colaboración
2. ¿Dónde interviene la IA?
| Función | Dónde se usa | Qué aporta la IA | Qué conserva la persona |
|---|---|---|---|
| Asistente del cuestionario | Configuración del diagnóstico | Sugiere capacidades, preguntas, cobertura y referencias de TOGAF, MRAE y ACMM. | Decide qué preguntas activar y con qué alcance. |
| Análisis del diagnóstico | Resultados y reporte | Analiza respuestas, evidencias y fuentes para explicar hallazgos y recomendaciones. | Revisa las evidencias y el uso del resultado. |
| Agente de la fase | Documentos AS-IS y TO-BE | Analiza secciones, redacta contenido, valida calidad y propone cambios o diagramas. | Acepta, corrige o rechaza cada operación. |
| Asistente de catálogos | Catálogos AS-IS y TO-BE | Extrae filas, detecta relaciones y propone actualizaciones desde documentos. | Revisa la evidencia y decide qué filas o relaciones aplicar. |
| Generación de informe | Informe ejecutivo e informe por capacidad | Fusiona datos del proyecto con el análisis de IA. | Inicia la generación, interpreta el resultado y lo presenta como entregable. |
| Agente de brechas | Análisis de brechas | Conversa sobre el análisis de una fase ADM o de todas, explica la matriz y las brechas y puede generar la propuesta de una fase con /generar. | Decide cada operación de la propuesta y aprueba la fase. |
| Agente de plan de migración | RoadMap | Responde sobre olas, dependencias, costos y cobertura, explica los puntos críticos del tablero y propone cambios de ola, fechas o esfuerzo. | Acepta o rechaza cada operación; las cifras del plan las calcula la aplicación. |
| Resumen ejecutivo del RoadMap | Tablero del RoadMap | Redacta un párrafo para gerencia y de 3 a 5 puntos críticos a partir de los indicadores. | Genera, edita o regenera el resumen; si la IA escribe una cifra que el tablero no tiene, el resumen no se guarda. |
3. ¿Qué información puede utilizar?
Según la función y los permisos, la IA puede trabajar con:
- La pregunta, capacidad, sección o bloque que el usuario está consultando.
- El contenido existente del proyecto.
- Documentos y archivos adjuntos a la conversación.
- Documentos del repositorio del proyecto.
- El corpus oficial disponible, como TOGAF, MRAE y ACMM.
- Respuestas, evidencias y observaciones del diagnóstico.
La persona debe indicar el objetivo y aportar contexto suficiente. Una solicitud específica produce una propuesta más fácil de revisar que una instrucción genérica como “completa todo”.
4. ¿Qué significa revisar una propuesta?
Una propuesta de IA es una sugerencia, no un cambio aplicado. Antes de aceptarla:
- Compruebe que se refiere a la fase, sección o catálogo correcto.
- Revise la evidencia o fuente que la respalda.
- Busque supuestos, datos incompletos o relaciones no demostradas.
- Acepte únicamente las operaciones que correspondan.
- Corrija o rechace lo que no sea aplicable.
- Compruebe el documento o catálogo después de aplicar los cambios.
En el agente de fase las propuestas pueden aparecer como Pendiente, Parcialmente aplicada, Aplicada, Rechazada o Desactualizada. En el asistente de catálogos se pueden revisar operaciones de crear, actualizar o relacionar elementos y decidirlas individualmente.
5. Human in the Loop en cada módulo
5.1 Diagnóstico
La IA puede ayudar al consultor a diseñar el cuestionario y comprender las respuestas, pero no responde por la empresa ni asigna el puntaje final. La empresa aporta respuestas, documentos y observaciones. El consultor revisa esa información, asigna el SCORE 0-5, explica la calificación y decide cuándo generar el informe completo.
Consulte el flujo completo en Diagnóstico de Madurez AE.
5.2 Fases AS-IS y TO-BE
El Agente de la fase puede proponer texto, estructuras, diagramas y validaciones. Nunca aplica un cambio sin que el usuario lo acepte. En TO-BE puede contrastar AS-IS para proponer el estado objetivo; no modifica AS-IS automáticamente.
Consulte los procedimientos en Fases AS-IS y TO-BE.
5.3 Catálogos
El asistente puede extraer filas y relaciones desde documentos. La pantalla de propuesta muestra la evidencia y permite Aceptar, Corregir o Rechazar cada operación. Los datos solo se guardan después de confirmar la decisión.
5.4 Análisis de brechas
El Agente de brechas trabaja con un alcance: una fase ADM (Fase B, Fase C o Fase D) o Todas las fases. Con /generar seguido de la fase pide la propuesta de brechas de esa fase; si la fase no está lista, responde el motivo sin generar nada. Toda propuesta queda pendiente hasta que el consultor decide cada operación.
Consulte el detalle en Análisis de brechas.
5.5 RoadMap
En el RoadMap la IA interviene en dos lugares:
- Resumen ejecutivo: la IA redacta el resumen y los puntos críticos sobre los indicadores que calcula la aplicación. Antes de guardarlo, cada cifra se compara con el tablero; si alguna no está, el resumen se rechaza con Cifras sin respaldo en el tablero y se conserva el anterior. El consultor puede editarlo, y su edición queda marcada como Editado por el consultor.
- Agente de plan de migración: explica el plan y cada punto crítico (con Preguntar al agente) y deja sus sugerencias como propuestas en la pestaña Propuestas, que se aceptan o rechazan por operación. Los comandos como
/olas,/costo,/coberturao/ejecutivoresponden con datos del plan sin consultar a la IA.
Las ediciones hechas en el Gantt siguen el mismo principio: se convierten en una propuesta y no cambian el plan hasta que se aceptan. Consulte el detalle en RoadMap (plan de migración).
5.6 Informes
El informe puede incluir una capa determinística, calculada con los datos ya registrados, y una capa de IA, que busca evidencia y genera explicaciones. La persona inicia la generación, espera el resultado, revisa las recomendaciones y decide cómo usarlo en el entregable.
6. Fuentes, adjuntos y trazabilidad
Cuando el agente ofrece las pestañas Fuentes y adjuntos, revise:
- Qué documentos se usaron como contexto.
- Qué fuentes metodológicas respaldan la explicación.
- Qué archivo se adjuntó a la conversación.
- Si la propuesta cita evidencia del proyecto o una referencia oficial.
Para mejorar la trazabilidad, solicite al agente que separe hechos comprobados, supuestos y recomendaciones. No adjunte credenciales, tokens ni información que no deba formar parte del proyecto.
7. Límites que debe conocer el usuario
- La IA puede equivocarse o interpretar de forma incompleta un documento.
- Una respuesta bien redactada no demuestra por sí sola que un dato sea verdadero.
- Una relación de catálogo debe estar respaldada por evidencia y por las reglas del metamodelo.
- Una propuesta Desactualizada debe regenerarse con el contenido actual.
- Los permisos del usuario siguen aplicándose: la IA no desbloquea fases ni concede acceso.
- La aprobación de una fase, la calificación del diagnóstico y la decisión de publicar un informe siguen siendo responsabilidad de los usuarios autorizados.
8. Lista de comprobación antes de aceptar cambios
- [ ] La propuesta corresponde al proyecto y la fase correctos.
- [ ] La fuente o evidencia es pertinente.
- [ ] No se inventaron datos, responsables, atributos o relaciones.
- [ ] El cambio no elimina información necesaria.
- [ ] El texto usa los términos aprobados por el proyecto.
- [ ] El cambio fue revisado por el consultor o usuario autorizado.
- [ ] Después de aplicar, se verificó la vista previa, el catálogo o el diagrama.
Regla de oro: la IA acelera la exploración y la redacción; la persona mantiene la responsabilidad sobre el contenido que se guarda, se califica, se aprueba y se entrega.