1. ¿Qué es TRAMA?
TRAMA es un plugin para Autodesk Navisworks Manage que integra un asistente de inteligencia artificial (Claude de Anthropic) directamente en el flujo de coordinación BIM. El asistente conoce el modelo federado activo en tiempo real y actúa sobre él sin salir de Navisworks.
| Capacidad | Descripción |
|---|---|
| Analizar choques | Lee todos los tests de Clash Detective, cuenta, filtra y prioriza |
| Clusterizar por zona | Agrupa choques por proximidad espacial y par de disciplinas |
| Navegar el modelo | Hace zoom y selecciona elementos en la vista 3D automáticamente |
| Exportar BCF 2.1 | Genera archivos BCF listos para Revit, BIM 360 o Solibri |
| Generar reportes | Produce PDFs y Excel semanales con KPIs, tablas y clusters |
| Validar naming | Audita nombres de archivo contra la convención ISO 19650-2 |
| Gestionar estados | Actualiza estados: nuevo, activo, revisado, aprobado, resuelto |
| Crear Selection Sets | Organiza zonas de coordinación como Selection Sets navegables |
| Guardar viewpoints | Registra vistas de interés bajo la carpeta TRAMA |
2. Instalación y primer uso
Requisitos del sistema
| Requisito | Detalle |
|---|---|
| Navisworks Manage | 2026 (compatible con 2024) |
| Sistema operativo | Windows 10 / 11 (64-bit) |
| Internet | Requerida para la API de Anthropic |
| API Key | Cuenta en console.anthropic.com |
Configurar la API Key
TRAMA lee la clave desde la variable de entorno de Windows:
Panel de Control → Sistema → Variables de entorno → Variables de usuario → Nueva. Reinicia Navisworks después.
Abrir el panel
Add-Ins → TRAMA. El panel aparece como ventana acoplable (dock panel).
3. Interfaz de usuario
El panel TRAMA se integra como dock panel nativo de Navisworks. Puede colocarse en cualquier posición de la interfaz.
| Elemento | Descripción |
|---|---|
| ● cyan | Conectado — API key válida y Navisworks activo |
| ● blanco | Sin conexión o API key no configurada |
| Chat thread | Historial con soporte Markdown completo (tablas, negritas, código) |
| Input bar | Textbox expansible. Enter envía, Shift+Enter nueva línea |
| Indicador de carga | Tres puntos animados mientras TRAMA procesa |
4. Capacidades y comandos
4.1 Consultar choques — query_clashes
Consulta el estado actual de todos los choques del modelo federado. TRAMA la llama automáticamente cuando preguntas sobre choques.
| Parámetro | Default | Descripción |
|---|---|---|
test_name | (todos) | Nombre del test a consultar |
status | new | new · active · reviewed · approved · resolved · any |
limit | 50 | Máximo de choques (máx 100) |
4.2 Análisis de clusters — query_clusters
Reduce cientos de choques individuales a zonas de coordinación accionables. Algoritmo single-linkage por proximidad y par de disciplinas. Radio default: 2.0 m.
4.3 Inspeccionar elementos — get_element
Recupera todas las propiedades de un elemento: categoría IFC, propiedades Revit, sistema, nivel, archivo origen.
4.4 Navegar en modelo — focus_on_elements
Hace zoom en Navisworks a los elementos especificados y los selecciona. TRAMA la llama automáticamente al mencionar elementos en su respuesta. No requiere ningún comando explícito del usuario.
4.5 Exportar BCF 2.1 — export_bcf
Genera un archivo BCF 2.1 compatible con Revit, BIM 360, ACC y Solibri. Cada issue incluye título, prioridad, viewpoint de cámara y los dos elementos involucrados.
| Severidad NW | Prioridad BCF |
|---|---|
| Crítica (> 0 mm penetración) | Critical |
| Alta (< 20 mm) | Major |
| Media (< 100 mm) | Normal |
| Baja (contacto) | Minor |
4.6 Reporte semanal — generate_report
Produce el reporte de coordinación en PDF y/o Excel con KPIs, tabla por test, top clusters y resumen ejecutivo.
| Parámetro | Default | Descripción |
|---|---|---|
output_dir | Escritorio | Carpeta de salida |
prepared_by | TRAMA | Nombre del coordinador |
executive_summary | — | Texto del resumen ejecutivo |
format | both | pdf · excel · both |
4.7 Validar naming ISO 19650 — validate_naming
Audita nombres de archivo BIM contra ISO 19650-2. Detecta campos faltantes, disciplinas desconocidas y formatos de revisión incorrectos.
4.8 Actualizar estados — update_clash_status
Cambia el estado de choques en Clash Detective. Puede actualizar una lista por GUID o hacer un cambio masivo filtrando por estado actual.
| Estado | Significado ISO 19650 |
|---|---|
| new | Choque detectado, sin revisar |
| active | En proceso de resolución |
| reviewed | Revisado por el coordinador |
| approved | Aprobado para continuar |
| resolved | Resuelto en el modelo |
4.9 Organizar por zonas — apply_clash_groups
Crea Selection Sets en Navisworks agrupando los elementos de cada cluster. Cada set se nombra con disciplinas, severidad y cantidad de choques.
4.10 Guardar viewpoints — save_viewpoint
Guarda la vista actual en el panel Saved Viewpoints bajo la carpeta TRAMA. Si se proporcionan GUIDs, navega primero y luego guarda.
5. Flujos de trabajo típicos
Flujo A — Reunión de coordinación semanal
Flujo B — Auditoría ISO 19650 pre-entrega
6. Ejemplos de salidas y reportes
Reporte semanal — vista PDF
Validación ISO 19650 — resultado completo
Clusters de coordinación — vista completa
7. Referencia rápida de comandos
| Lo que quieres | Cómo pedirlo a TRAMA |
|---|---|
| Ver total de choques | "¿Cuántos choques hay?" |
| Filtrar por estado | "Choques nuevos del Test 1" |
| Priorizar zonas | "Agrupa por zona" / "Clusters críticos" |
| Inspeccionar elemento | "Detalles del elemento GUID:xxxx" |
| Navegar al choque | "Muéstrame el choque CLH-001" |
| Exportar BCF | "Exporta el BCF" |
| Reporte semanal | "Genera el reporte semanal" / "Dame el PDF" |
| Auditar naming | "Valida los nombres de archivo del modelo" |
| Cambiar estados | "Marca como revisados todos los choques de Test 1" |
| Organizar por zonas | "Agrupa los choques en Selection Sets" |
| Guardar vista | "Guarda este viewpoint como…" |
| Atajo | Acción |
|---|---|
Enter | Enviar mensaje |
Shift + Enter | Nueva línea en el mensaje |