Ingeniería de Roles IA y Agentes Autónomos

1. ¿Qué es un Rol?

Un Rol es un perfil profesional especializado que le dice a la IA quién es cuando te responde. Es como asignarle un cargo: Abogado, Contador, Médico, Economista, etc. Cada rol trae instrucciones internas sobre qué sabe, cómo analiza y qué fuentes prioriza.

2. ¿Para qué sirve?

Para que la IA enfoque sus respuestas según la disciplina que necesitas. En lugar de darte una respuesta genérica, el rol hace que:

Use terminología técnica correcta
Priorice las normas y fuentes relevantes
Estructure la respuesta profesionalmente
Aplique marcos de análisis propios

3. ¿Qué impacto tiene?

La diferencia entre un rol bien configurado y uno genérico es como preguntar en la calle vs. consultar a un especialista:

Rol genérico: Respuestas superficiales, sin estructura, sin fuentes.
Rol bien definido: Respuestas precisas, con normas citadas y análisis profesional.

El Rol es el factor #1 de calidad.

Master Engineering

Anatomía del Rol Perfecto

Para que la IA alcance su máximo potencial analítico, Maximus define cada agente bajo un "Blueprint" de precisión quirúrgica. Estos son los campos que debe configurar y un ejemplo real de éxito.

Los Atributos Críticos

1. Perfil e Identidad

Nombre y Descripción: Quién es y qué hace.
Especialización: Áreas técnicas de dominio.
Dominios y Keywords: Contextos y vocabulario técnico.

2. Razonamiento y Formato

Instrucciones Principales: El "Qué hacer".
Marco de Análisis y Estándares: El "Cómo pensar".
Estructura y Ejemplos: El "Cómo responder".

3. Evidencia y Control

Fuentes Externas: Bases de datos y normas.
Limitaciones y Prohibiciones: Lo que NO puede hacer.
Disclaimers Profesionales: Notas de responsabilidad.

Master Example: Abogado Tributarista

NOMBRE DEL ROL

Abogado Tributarista DIAN Senior

DESCRIPCIÓN

Especialista en derecho tributario con 25 años de experiencia ante la DIAN y altas cortes.

MARCO DE ANÁLISIS

1. Clasificación Jurídica (Sustantivo vs Procesal)
2. Investigación Normativa (Estatuto Tributario)
3. Análisis de Riesgos (Sanciones e intereses)
4. Estrategia Legal y Plan de Acción

PROTOCOLO RAG (INSTRUCCIONES)

Verificar vigencia de normas y reformas recientes.
Consultar jurisprudencia de unificación y sentencias.
Evaluar probabilidad de éxito: BAJA / MEDIA / ALTA.
Identificar términos y plazos procesales fatales.

DISCLAIMERS & LÍMITES

"No constituye asesoría formal. Los términos procesales son perentorios..."

Configurado a través de custom_roles.json en Maximus v4.0

Consejo de Oro: El Rol es el factor #1 que determina la calidad. Un rol bien definido convierte a una IA genérica en un Especialista Senior capaz de citar normas, prever riesgos y estructurar defensas técnicas de alto impacto.

Diagnóstico Global de Arquitectura

Identificamos los puntos clave para elevar el sistema de un nivel conceptual (8.2/10) a un potencial real de excelencia (9.7/10).

Protocolos de Grounding

La falta de un "RAG Thinking Protocol" puede llevar a respuestas superficiales. Implementamos validación paso a paso de cada coincidencia documental.

Modo de Incertidumbre

Protocolos específicos para gestionar vacíos normativos o contradicciones en los documentos, vital en contextos legales y tributarios.

RAG Thinking Protocol

El motor de razonamiento que asegura fundamentación total en su información.

1. Identificar

Extraer conceptos clave y normas raíz de la consulta del usuario.

2. Consultar

Formular consultas semánticas precisas contra la base de datos RAG local.

3. Validar

Verificar coincidencias documentales y validar la vigencia de la norma encontrada.

4. Extraer

Recuperar fragmentos textuales exactos para sustentar el análisis posterior.

5. Fundamentar

Construir la respuesta mediante Grounding explícito en las fuentes recuperadas.

6. Analizar

Emitir el juicio profesional final fundamentado rigurosamente en la evidencia documental extraída.

Interfaz de Configuración Avanzada

Explore el panel de control donde se gestiona toda la inteligencia de sus agentes.

Listado de Roles

Ayuda Integrada

Control de 5 Dimensiones

Cada agente es personalizado a través de capas que definen desde su identidad hasta su protocolo de salida de datos.

D1: Identidad

Nombre y especialidad profesional.

D2: Cognición

Temperatura y límites de razonamiento.

D3: Prompt Maestro

Instrucciones críticas de comportamiento.

D4: Dominio

Inyección de conocimiento experto.

D5: Salida

Protocolos de reporte y citación.

12 Roles Especializados — v4.0.0

Agentes profesionales con inteligencia de recuperación adaptativa. Cada rol calibra automáticamente la profundidad de búsqueda, la temperatura del modelo y el método de procesamiento.

Abogado DIAN

Modelo estrella. Tabla de plazos procesales automática y evaluación de probabilidad de éxito ante la DIAN.

Recuperación: 1.6× K · Temp: 0.0 · MapReduce: preferido

RAÍZ: Estatuto Tributario / Jurisprudencia CE

Legal Experto

Contratos complejos, sucesiones y análisis jurídico profundo. Mayor amplitud de recuperación del sistema.

Recuperación: 1.8× K · Temp: 0.0 · MapReduce: preferido

RAÍZ: Jerarquía normativa colombiana

Abogado Especializado

Método FIRAC estructurado. Análisis bajo jerarquía normativa colombiana con marcos de referencia explícitos.

Recuperación: 1.4× K · Temp: default

RAÍZ: FIRAC / Código Civil

Contador Público

NIIF y Estatuto Tributario. Cálculos paso a paso con evaluación de contingencia fiscal documentada.

Recuperación: 1.3× K · Temp: 0.0

RAÍZ: ET / Decretos Reglamentarios / NIIF

Análisis Financiero

Tablas de pago, balances y estados financieros. Motor de tablas automático para cruce de cifras.

Recuperación: 1.6× K · Temp: 0.0

RAÍZ: NIIF / Análisis cuantitativo

Auditor Documental

Auditoría completa con clasificación de hallazgos CRÍTICO / ALTO / MEDIO / BAJO. Máxima amplitud de recuperación.

Recuperación: 2.0× K · Temp: 0.0 · MapReduce: preferido

RAÍZ: Estándares de auditoría interna

Forense Documental

Compara versiones, detecta contradicciones y construye cronologías con evidencia. El rol de mayor K del sistema.

Recuperación: 2.2× K · Temp: 0.0 · MapReduce: preferido

RAÍZ: Análisis forense / Contradicciones

Consulta Estricta

Búsqueda literal con ubicación exacta de página. Timeline híbrido, extracción de variables/valores. Sin creatividad del modelo.

Modo: búsqueda regex + fallback RAG semántico

RAÍZ: Regex / Pure RAG / Timeline

Universal Inteligente

Rol recomendado por defecto. Equilibrio óptimo entre profundidad y velocidad para consultas generales.

Recuperación: 1.0× K · Temp: default

RAÍZ: Razonamiento general

RAG 2.0 — Novedad Mayo 2026

Inteligencia Adaptativa de Roles

Cada rol ya no es solo un prompt. A partir de RAG 2.0, cada especialista IA tiene su propia capa de inteligencia de recuperación: sabe cuántos documentos necesita, a qué temperatura razona mejor y si debe analizar el expediente completo.

K Adaptativo por Rol

Cada rol multiplica el K base de recuperación según su necesidad de contexto. Un Forense necesita 2.2× más fragmentos que un rol general (2.2× K vs 1.0× K). Más contexto = mayor precisión en análisis complejos.

Temperatura de Precisión

Los roles legales, financieros y técnicos operan a temperatura 0.0: respuestas completamente deterministas, sin variabilidad creativa. Es la configuración validada en Run #18 para alcanzar 0.0% de alucinación.

MapReduce Inteligente

Roles de auditoría, forense y legal activan automáticamente el procesamiento MapReduce: cada documento se analiza en paralelo y los resultados se sintetizan. Así ningún folio del proyecto queda sin revisar.

Novedad F5A — Afinidad Proyecto↔Rol

El rol recuerda tu proyecto

Cuando cambias de un proyecto legal a uno contable, el sistema restaura automáticamente el rol que usaste la última vez en cada expediente. No tienes que reconfigurar nada.

Persistencia automática: El rol queda vinculado al proyecto en base de datos.
Restauración al abrir: Al seleccionar el proyecto, el especialista IA se activa sin intervención.
Indicador visual 💾: El sidebar confirma "Vinculado a: [nombre del proyecto]".

# F5A: Afinidad Proyecto↔Rol

proyecto: "Demanda DIAN 2024"

rol_guardado: "ABOGADO TRIBUTARISTA"

k_multiplier: 1.6×

temperatura: 0.0

mapreduce: preferido

💾 _VINCULADO_A_PROYECTO_

Protocolo Universal de Razonamiento Controlado

Implementamos una jerarquía de decisión técnica para asegurar que cada consulta sea procesada por el agente correcto siguiendo pasos auditables.

Clasificación automática del dominio y tipo de consulta.

Inyección de Protocolo de Incertidumbre ante vacíos de datos.

Validación de vigencia normativa (Colombia-First).

# MAXIMUS RAZONAMIENTO v4.1

1. CLASSIFY: [Jurídico_Tributario]

2. GROUNDING: Fetch(Internal_RAG)

3. VIGENCIA: Check(ET_Colombia_2026)

4. THINK: Chain_of_Thought_Enabled

5. RISK: Audit(Incertidumbre_Mode)

6. OUTPUT: Citations(Explicit)

_STATUS: READY_