Guía operativa

Cómo usar Glosa

Glosa se opera desde una sola aplicación de escritorio: Glosa Desktop. Doble clic, selecciona el Agente IA, arrastra el expediente, procesa. La UI es el default y cubre el 100% de la operación diaria. Quien quiera profundizar tiene también un modo Terminal Glosa interactivo y el bloque “Equivalente CLI” debajo de cada vista — ver modo interactivo y CLI. Esta guía cubre instalación, operación diaria, los 13 Agentes IA y el mantenimiento del producto.

Qué es Glosa Desktop

Aplicación de escritorio empaquetada como Glosa.exe (standalone) que expone los 13 Agentes IA de Glosa con interfaz visual integrada. Procesa expedientes completos de comercio exterior — factura, Bill of Lading, packing list, certificados de origen, fichas técnicas, y también fotos y videos de la mercancía que el operador captura como evidencia material — y entrega expedientes probatorios firmados criptográficamente, navegando el corpus LIGIE 2026 y los 14 TLCs vigentes.

Materialidad nativa — los datos fiscales de tu cliente final (importador) nunca salen de la computadora del operador. Solo se sube telemetría agregada anónima al panel de tu agencia para métricas operativas sin exponer información sensible (ADR-0004).

Auditabilidad — cada expediente generado lleva hash SHA-256 sobre los documentos de entrada + audit trail criptográfico. Defendible ante visita SAT años después del despacho.

Pre-requisitos (una sola vez)

Lo que necesitas tener listo antes de la sesión de onboarding:

#	Requisito	Detalle
1	Computadora Windows	Windows 10 u 11, mínimo 8 GB RAM (16 ideal), 20 GB libres de disco
2	Suscripción a Claude Max	$100 USD/mes, contratada directamente con Anthropic en claude.com
3	Internet estable	Mínimo 10 Mbps. Glosa procesa localmente pero la IA cloud necesita conexión.
4	Permisos de administrador	Necesarios para la instalación inicial. Antivirus configurado para permitir instaladores firmados.

Instalación guiada (~30 minutos)

La instalación es una sesión 1-a-1 con tu contacto de Glosa, de aproximadamente 30 minutos. Te dejamos el equipo del operador listo: Glosa Desktop instalado, licencia activa, primer expediente demo procesado end-to-end. No tienes que hacer nada técnico — solo apartar el bloque de tiempo y tener la computadora a la mano.

Cómo se realiza la instalación

Glosa cuenta con un script de instalación automatizado (glosa-installer.ps1) que detecta qué componentes ya tienes en tu equipo e instala únicamente los faltantes. Durante la sesión guiada lo ejecutamos contigo, validamos cada paso, activamos tu licencia con el token que recibiste por email, y corremos un diagnóstico final (glosa doctor) que verifica que todo quedó funcional.

Quedan registrados un log de instalación en %LOCALAPPDATA%\Glosa\install.log y un acceso directo a Glosa en tu escritorio.

Componentes que el script instala (motor invisible debajo de la UI — el operador nunca interactúa con ellos directamente):

Python 3.11+ runtime (necesario para el plugin Glosa)
Claude Code (de Anthropic, conecta al motor IA)
Plugin Glosa con los 13 Agentes IA y el corpus normativo
Glosa Desktop (la UI de doble clic — el único componente visible)
Acceso directo en el escritorio
Licencia activa vinculada a tu agencia

Una vez terminada la sesión inicial, el operador solo abre Glosa.exe y opera. Los demás componentes se mantienen en segundo plano y se actualizan vía banner cuando Glosa publica nuevas versiones.

Cómo se usa el día a día (4 pasos)

Doble clic en Glosa.exe desde el escritorio o el menú Inicio. La aplicación abre con el logo Glosa visible en el header.
Selecciona el Agente IA del dropdown principal (Paso 1 de la UI). Los 13 agentes están agrupados por categoría: procesamiento de documentos, validaciones, expediente y auditoría, cotización y rectificación.
Provee el input (Paso 2). El control cambia según el Agente IA seleccionado:
- Folder picker para skills que procesan expedientes completos (procesar-facturas, armar-expediente, auditoria-forense).
- File picker para skills con un solo documento específico, con filtros por extensión (validar-coo, auditar-pedimento, procesar-bl, etc.).
- Text widget para skills exploratorias (cotizar-importacion, abrir-expediente-manual, validar-rrna).
Click en Ejecutar(Paso 3). El texto del botón cambia según el agente seleccionado ("Procesar expediente", "Validar CoO", "Cotizar"...). El progreso se muestra en vivo en la ventana. Cuando termina, los resultados quedan en Documents\Glosa\Resultados\ (configurable).

¿Por qué solo doble clic?

La UI estructurada hace que el operador no pueda equivocarse con comandos, parámetros o sintaxis. Cada Agente IA tiene su flujo definido, sus restricciones de entrada y su validación. Es la diferencia entre "asistente con guardarraíles" y "chat abierto sin guardarraíles".

La primera vez que abres Glosa

Verás un banner de bienvenida con un tour guiado de 30 segundos que te muestra dónde está cada cosa: la lista de Agentes IA, el modo Terminal Glosa, el bloque “Equivalente CLI” debajo de cada vista, y la sección de guías. Puedes saltarlo y volver a verlo más tarde desde el footer (link 📘 Guías).

¿Quieres profundizar? Guía: modo interactivo y CLI explica cuándo conviene operar desde la UI vs desde el Terminal Glosa, y cómo afecta a tu plan de Claude.

Los 13 Agentes IA disponibles

Cada Agente IA es una skill especializada que reutiliza el mismo corpus normativo navegable (LIGIE 2026, Anexo 22, NOMs, TLCs). Lista en la UI agrupada por categoría:

Procesamiento de documentos

procesar-facturas — lee expediente completo (factura + BL + packing + CoO + RRNA), cruza datos entre documentos, clasifica contra LIGIE, pre-llena el pedimento. Acepta carpetas completas con N expedientes — arrastra los 50 expedientes del cierre de mes y los procesa secuencialmente, con resumen consolidado al final.
procesar-bl — extrae datos del Bill of Lading y los normaliza.
procesar-packing-list — extrae conteo, pesos y dimensiones.
procesar-ficha-tecnica — lee SDS/fichas químicas, identifica precursores y Clase ONU.

Validaciones

validar-certificado-origen — 8 validaciones deterministas por CoO.
validar-carta-porte — verifica CFDI 3.0 con complemento Carta Porte.
validar-rrna — cruza fracción + descripción contra Anexo 2.4.1 y permisos previos.

Expediente y auditoría

armar-expediente — construye expediente probatorio completo desde una carpeta de documentos sueltos.
auditar-pedimento — 14 validaciones deterministas pre-SAAI cruzando los 9 apéndices del Anexo 22.
auditoria-forense — revisión profunda de expediente ya cerrado, cruce con normativa, detección de hallazgos.
abrir-expediente-manual — abre interactivamente un expediente para investigar caso atípico.

Cotización y rectificación

cotizar-importacion — estima fracción + impuestos + aranceles + DTA desde descripción libre del producto. Útil antes de tener factura — exploras la operación con tu cliente, iteras hasta cerrar criterio (fracción, RRNA aplicables, alertas comerciales), y solo cuando se concreta arrancas el flujo de expediente formal.
rectificar-expediente — corrige expediente ya armado preservando audit trail.

En roadmap (2 adicionales): consultar-anam y conciliar-gastos. Aparecerán en la UI con marca "próximamente" hasta que estén operativos.

Mantén Glosa actualizado

Cuando publicamos nuevos Agentes IA o mejoras al corpus normativo, tu Glosa Desktop te avisa con un banner en la parte superior de la ventana. Click en el banner inicia la actualización guiada — el operador no tiene que hacer nada técnico, Glosa se encarga de descargar, validar firma criptográfica del paquete, y reiniciar la UI con los cambios aplicados.

Las actualizaciones no modifican tu trabajo: los expedientes ya generados quedan intactos.
Si una actualización agrega un nuevo Agente IA, aparece automáticamente en el dropdown del Paso 1 al reiniciar.
Si una actualización cambia el corpus normativo (ej. ajuste de fracción LIGIE, nueva NOM, nuevo antidumping UPCI), Glosa lo registra en el changelog visible desde el menú Ayuda.

Si por alguna razón quieres saltar una versión, puedes posponer la actualización desde el banner. La actualización vuelve a sugerirse la siguiente vez que abras Glosa.

Recursos relacionados

📁 Guía: organización de carpetas — cómo estructurar tus expedientes para que Glosa los lea sin fricción.
📄 Guía: documentos por expediente — qué documentos componen el expediente probatorio según el tipo de operación.
⌨️ Guía: modo interactivo y CLI — cuándo usar la UI vs el Terminal Glosa, equivalente CLI en cada vista, e impacto en tu plan de Claude.
📖 Glosario aduanal — definiciones operativas con materialidad probatoria de los términos clave del oficio.
💰 Precios — planes Operador, Agencia y Enterprise.

Esta guía describe el uso de Glosa Desktop al 17 de mayo de 2026 (v2.5.0). La extensión a más Agentes IA y a flujos adicionales (defensa SAT ampliada, batch programable desde la UI) está en roadmap — se priorizará en función del feedback del primer cliente piloto.