Manual de Usuario — TRAMA | Asistente BIM IA para Navisworks

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

📌 Nota

TRAMA no modifica geometría ni parámetros de Revit. Los grupos en Clash Detective no son editables vía API de Navisworks — se usan Selection Sets como alternativa equivalente.

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:

Variable: ANTHROPIC_API_KEY Valor: sk-ant-xxxxxxxxxxxxxxxxxxxxxxx

Para configurarla: Panel de Control → Sistema → Variables de entorno → Variables de usuario → Nueva. Reinicia Navisworks después.

Abrir el panel TRAMA

Abre Navisworks Manage 2026
Ve a la pestaña Add-Ins en la cinta
Haz clic en TRAMA
El panel aparece como ventana acoplable (dock panel)

3. Interfaz de usuario

┌─────────────────────────────────────────────────────────────┐ │ ■ TRAMA Coordinación BIM · IA ● │ ← Header ├─────────────────────────────────────────────────────────────┤ │ │ │ Abre un modelo en Navisworks para comenzar. │ │ "¿Cuántos choques hay en el modelo?" │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ exporta el BCF del Test 1 (Usuario) │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ ✅ BCF generado: 13 205 issues (TRAMA) │ │ Archivo: Desktop\Test_1_20260424.bcf │ │ │ ├─────────────────────────────────────────────────────────────┤ │ ┌──────────────────────────────┐ [▶ Enviar] │ │ │ Pregunta sobre el modelo... │ │ │ └──────────────────────────────┘ │ │ Enter para enviar · Shift+Enter nueva línea │ └─────────────────────────────────────────────────────────────┘

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 de todos los choques del modelo federado. TRAMA llama esta herramienta automáticamente cuando preguntas sobre choques.

¿Cuántos choques hay en el modelo? Dame un resumen de todos los tests de Clash Detective ¿Cuántos choques críticos hay en Test 1? Muéstrame los choques con estado "nuevo"

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 a retornar (máx 100)

4.2 Clusters espaciales — `query_clusters`

Reduce cientos de choques individuales a zonas de coordinación accionables. Algoritmo single-linkage por proximidad y par de disciplinas.

Agrupa los choques por zona ¿Cuáles son las zonas más críticas? Muéstrame clusters del Test 1 con radio 3 metros

💡 Consejo

Radio 1 m = más clusters pequeños (mayor granularidad). Radio 5 m = menos clusters más grandes (útil para presentaciones ejecutivas).

4.3 Inspeccionar elementos — `get_element`

Recupera todas las propiedades de un elemento: categoría IFC, propiedades Revit, sistema, nivel, archivo origen.

¿Qué es el elemento con GUID {guid}? Dame los detalles del elemento 1 del choque CLH-001

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.

Muéstrame ese elemento en el modelo Enfoca los elementos del choque CLH-001 Navega al cluster CLU-0012

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 elementos involucrados.

Exporta el BCF del Test 1 Genera el BCF de todos los choques críticos Exporta BCF y asígnalo a juan@empresa.com

Parámetro	Default	Descripción
`test_name`	(todos)	Test a exportar
`status`	new	Filtrar por estado
`output_path`	Escritorio	Ruta de salida del archivo .bcf
`assigned_to`	—	Email del responsable de los issues

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.

Genera el reporte semanal Dame el reporte en PDF preparado por "María García" Crea el reporte con este resumen: "Semana con alta actividad en pisos 3 y 4..."

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.

Formato: EDIF01_LRB_ARC_PRY_M3D_0001_C01{Proyecto}_{Origen}_{Disciplina}_{Fase}_{Tipo}_{Número}_{Revisión}

Campo	Pos.	Valores válidos
Proyecto	1	2-8 alfanumérico mayúsculas
Origen	2	2-8 alfanumérico mayúsculas
Disciplina	3	ARC · STR · MEP · MEC · ELE · PLO · CIV · FAC · INT
Tipo	5	M3D · M2D · DRW · SCH · SPE · CAL · REP · COO · FED
Revisión	7	Letra + 2 dígitos: A01, C03, P01…

4.8 Actualizar estados — `update_clash_status`

Cambia el estado de choques en Clash Detective. Puede actualizar una lista específica por GUID o hacer un cambio masivo.

Marca todos los choques del Test 1 como revisados Cambia los choques CLH-001, CLH-002 y CLH-003 a "activo"

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 espacial.

Agrupa los choques del Test 1 Organiza las zonas de coordinación en Selection Sets Crea los grupos con radio de 3 metros

📌 Nota

El API de Navisworks marca ClashResult como de solo lectura post-ejecución. Los Selection Sets ofrecen la misma navegación y están completamente disponibles.

4.10 Guardar viewpoints — `save_viewpoint`

Guarda la vista actual en el panel Saved Viewpoints bajo la carpeta TRAMA.

Guarda esta vista como "Nodo conflicto MEP-STR Nivel 3" Navega al choque CLH-001 y guarda el viewpoint

5. Flujos de trabajo típicos

Flujo A — Reunión de coordinación semanal

"¿Cuántos choques hay en el modelo?"

TRAMA consulta todos los tests y da el resumen por disciplina

"Muéstrame las zonas más críticas"

TRAMA clusteriza y lista las top 10 zonas prioritarias

"Enfoca el cluster CLU-0012"

NW hace zoom a los 124 elementos del cluster automáticamente

"Dame detalles del ducto de ese choque"

TRAMA inspecciona el elemento y muestra propiedades Revit + IFC

"Genera el reporte semanal preparado por María García"

TRAMA produce PDF + Excel listos para la reunión

"Exporta el BCF de todos los críticos y asígnalo a juan@empresa.com"

BCF generado en Escritorio, listo para BIM 360

Flujo B — Auditoría ISO 19650 pre-entrega

"Valida los nombres de archivo del modelo activo"

TRAMA verifica todos los archivos del modelo federado

"¿Qué archivos no cumplen?"

Lista los que tienen errores con descripción específica por campo

"Re-valida solo estos: [lista de archivos corregidos]"

Validación selectiva de los archivos corregidos

"Genera el reporte de conformidad para el CDE"

Reporte con % de cumplimiento y detalle completo

6. Ejemplos de salidas y reportes

Reporte semanal — vista PDF

Reporte de Coordinación BIM · Semana 17 / 2026

EDIF01 — Torre Corporativa

Preparado por: María García · BIM Coordinator · 24 de abril de 2026

13 205

Total Choques

1 847

Nuevos

632

Resueltos

4 821

Críticos

Test	Total	Crítico	Alto	Medio	Bajo
MEP vs Estructura	6 102	2 341	2 890	756	115
ARC vs MEP	4 218	1 580	1 742	782	114
STR vs Civil	1 987	620	890	412	65
MEP vs MEP	898	280	380	238	—

Resumen Ejecutivo

La semana 17 registra un incremento del 14% en choques nuevos concentrados en pisos 3 y 4 del sector B. El cluster CLU-0012 (MEP vs Estructura) representa la zona de mayor riesgo con 124 choques críticos. Se recomienda priorizar ductos de suministro de aire en el corredor norte del nivel 3 antes de la reunión del jueves.

Validación ISO 19650 — ejemplo de respuesta

Validación ISO 19650-2 — Modelo Federado

12 archivos analizados · 9 válidos (75%) · 3 con errores

✅

EDIF01_LRB_STR_PRY_M3D_0001_C02.nwc

Conforme con ISO 19650-2

❌

EDIF01_lrb_mec_pry_m3d_001.nwc

ERROR: campos en minúsculas (campo 2: "lrb") · ERROR: número muy corto (campo 6: "001")

❌

Torre-MEP-v3-FINAL.nwc

ERROR: formato no reconocido como ISO 19650 (usar guiones bajos _, no guiones -)

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

8. Preguntas frecuentes

¿Por qué TRAMA no puede crear grupos en Clash Detective?

El API de Navisworks Manage marca los ClashResult como de solo lectura una vez ejecutado el test. No es posible reasignarlos a grupos programáticamente. Los Selection Sets ofrecen la misma funcionalidad de navegación.

¿Los datos del modelo salen de Navisworks?

Solo se envían metadatos textuales a la API de Anthropic: nombres, GUIDs, coordenadas, propiedades de nivel y sistema. Nunca se envía geometría, archivos NWC/NWD ni información de suscripción de Autodesk.

¿Cuánto historial de conversación recuerda TRAMA?

Los últimos ~10 mensajes (~5 turnos de ida y vuelta). Si la conversación es muy larga, los mensajes más antiguos se descartan preservando la integridad del contexto.

¿Puedo usar TRAMA sin internet?

No. TRAMA requiere conexión a internet para la API de Anthropic. Las lecturas del modelo son locales, pero el procesamiento de IA requiere la API.

El BCF no importa en Revit. ¿Qué hago?

Verifica que el archivo tenga extensión .bcf. En Revit: pestaña Manage → Coordination → BCF Import. Versión mínima: Revit 2022. Para BIM 360, sube el .bcf desde la vista de Issues.

¿Cómo cambio el radio de clustering?

Pídele a TRAMA directamente: "Agrupa con radio de 5 metros" o "Usa un radio de 1.5 m para mayor granularidad".

Manual de Usuario — TRAMA

1. ¿Qué es TRAMA?

2. Instalación y primer uso

Requisitos del sistema

Configurar la API Key

Abrir el panel TRAMA

3. Interfaz de usuario

4. Capacidades y comandos

4.1 Consultar choques — query_clashes

4.2 Clusters espaciales — query_clusters

4.3 Inspeccionar elementos — get_element

4.4 Navegar en modelo — focus_on_elements

4.5 Exportar BCF 2.1 — export_bcf

4.6 Reporte semanal — generate_report

4.7 Validar naming ISO 19650 — validate_naming

4.8 Actualizar estados — update_clash_status

4.9 Organizar por zonas — apply_clash_groups

4.10 Guardar viewpoints — save_viewpoint

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 — ejemplo de respuesta

7. Referencia rápida de comandos

8. Preguntas frecuentes

4.1 Consultar choques — `query_clashes`

4.2 Clusters espaciales — `query_clusters`

4.3 Inspeccionar elementos — `get_element`

4.4 Navegar en modelo — `focus_on_elements`

4.5 Exportar BCF 2.1 — `export_bcf`

4.6 Reporte semanal — `generate_report`

4.7 Validar naming ISO 19650 — `validate_naming`

4.8 Actualizar estados — `update_clash_status`

4.9 Organizar por zonas — `apply_clash_groups`

4.10 Guardar viewpoints — `save_viewpoint`