diff --git a/agentes/260118_agente_curador_hashtags.md b/agentes/260118_agente_curador_hashtags.md new file mode 100644 index 0000000..5309f89 --- /dev/null +++ b/agentes/260118_agente_curador_hashtags.md @@ -0,0 +1,64 @@ +# Agente Curador de Hashtags + +## Propósito +Asistir en la migración de hashtags legacy (texto) a referencias mrf (hashes) en la base de datos TZZR. + +## Contexto del problema +- 15 tablas con campo `hashtags` contienen texto legible: `["payment", "cable", "invoice"]` +- Deberían contener hashes mrf referenciando la tabla `hst` +- 228 tags únicos, 2,747 usos totales +- Muchos tags son ambiguos (ej: "cable" → 6 hst posibles) + +## Función del agente + +### Input +- Tag de texto legacy (ej: "cable") +- Contexto del registro (tabla origen, campos relacionados) +- Lista de hst candidatos que coinciden parcialmente + +### Proceso +1. Analizar el contexto del registro donde aparece el tag +2. Consultar tabla `hst` buscando coincidencias por: + - `alias` + - `name_es` + - `name_en` +3. Rankear candidatos por relevancia contextual +4. Si confianza > umbral → proponer mapeo automático +5. Si confianza < umbral → marcar para revisión humana + +### Output +- `mrf` recomendado +- Score de confianza (0-1) +- Justificación +- Flag: `auto_approved` | `needs_review` + +## Tabla de trabajo + +```sql +CREATE TABLE tzzr_system.legacy_tag_mapping ( + id SERIAL PRIMARY KEY, + tag_texto VARCHAR(128) NOT NULL, + tabla_origen VARCHAR(64), + contexto JSONB, + mrf_propuesto VARCHAR(64) REFERENCES tzzr_core_hst.hst(mrf), + confianza DECIMAL(3,2), + justificacion TEXT, + estado VARCHAR(20) DEFAULT 'pendiente', -- pendiente, aprobado, rechazado, revision + revisado_por VARCHAR(64), + created_at TIMESTAMP DEFAULT NOW(), + updated_at TIMESTAMP DEFAULT NOW() +); +``` + +## Métricas de éxito +- % de tags mapeados automáticamente (objetivo: >60%) +- % de mapeos auto-aprobados correctos (objetivo: >95%) +- Tiempo promedio de curación por tag + +## Dependencias +- Acceso lectura a tablas con hashtags +- Acceso lectura a `tzzr_core_hst.hst` +- Acceso escritura a `legacy_tag_mapping` + +## Estado +Diseño inicial - pendiente implementación