Guida Utente Clev

Primo accesso

Clev è un'applicazione web: non richiede installazioni ed è raggiungibile da qualsiasi browser aggiornato.

1. Apri app.getclev.com dal browser.
2. Accedi con l'email e la password del tuo account aziendale. Se la tua organizzazione lo consente, puoi anche usare l'accesso rapido con Google.
3. Se è il tuo primo accesso, avrai ricevuto un invito via email dall'amministratore del tuo account Clev: seguilo per impostare la password.
4. Dopo l'accesso arrivi sulla Home, con l'elenco dei progetti a cui hai accesso.

Dashboard progetti

La Home è organizzata in due sezioni, richiamabili dal menu a sinistra: Progetti, dove vivono le tue commesse, e Azienda, dove si gestiscono i membri del team e la libreria condivisa (vedi capitolo 08).

Pensa a un progetto come a una commessa

Ogni progetto in Clev è un contenitore isolato: ha i propri documenti, i propri modelli IFC e le proprie automazioni. Conviene aprire un nuovo progetto per ogni commessa reale, così l'AI ragiona solo sui dati pertinenti e il team collabora senza sovrapposizioni.

Trovare e aprire un progetto

• Usa il campo Cerca progetti… per filtrare per nome.
• Il menu Tutti gli utenti filtra i progetti per chi li ha creati.
• Ogni scheda progetto mostra un'anteprima 3D (generata automaticamente al primo modello caricato), il peso totale dei file, la data dell'ultima modifica e l'autore.
• Sotto ogni scheda trovi tre azioni rapide: Apri progetto, l'icona persone per gestire chi vi ha accesso e l'icona cestino per eliminarlo.
• Aggiorna ricarica l'elenco se un collega ha appena creato o modificato un progetto.

Creare un nuovo progetto

Il riquadro + Nuovo progetto, disponibile anche dalla sezione Azienda, apre la creazione guidata: assegna un nome alla commessa e scegli quali colleghi devono potervi accedere. Potrai caricare documenti in qualsiasi formato di uso comune (IFC, PDF, DWG, CSV, Excel, immagini e altro) non appena il progetto è pronto.

Struttura di un progetto

Aprendo un progetto entri nella sua area di lavoro: in alto trovi il nome della commessa e quattro moduli, ciascuno pensato per un tipo di lavoro diverso.

Nell'intestazione del progetto trovi anche l'icona del Cestino, da cui recuperare documenti o check eliminati per errore, e in alto a destra il menu del tuo account.

Modulo Assistente

Il modulo dove carichi la documentazione di progetto e parli con Clev per analizzarla, sintetizzarla o farne generare di nuova.

Caricare i documenti

• Trascina i file nell'area dedicata oppure usa sfoglia. Sono accettati PDF, DWG, CSV, TXT, Excel, immagini e altri formati documentali.
• I filtri All / Uploaded / Generated distinguono i file che hai caricato tu da quelli generati da Clev; puoi passare dalla vista List a quella Grid.
• Organizza i file in sottocartelle con New Folder.

Cosa entra nel contesto della chat

Ogni documento ha una casella di spunta: il contatore in alto (x/y selezionati per Clev) indica quanti sono attivi. Solo i documenti selezionati vengono letti dall'AI — è così che decidi cosa Clev può vedere in ogni conversazione.

Cosa puoi chiedere a Clev

• Analisi e reportistica: estrarre informazioni, sintetizzare capitolati e generare nuovi documenti professionali in Word, PDF, Excel o Markdown a partire dai tuoi dati.
• File IDS: formalizzare requisiti di consegna informativa creando Information Delivery Specification per validare i modelli IFC secondo gli standard openBIM.
• Analisi economica: confrontare i documenti di progetto con dati esterni, ad esempio prezzari regionali, per stime e verifiche dei costi.
• Supporto normativo: indicazioni su codici di costruzione, norme tecniche, contratti e best practice di settore.

La scheda Cronologia, accanto a Chat, conserva le conversazioni precedenti. Durante una risposta lunga puoi sempre interromperla con il pulsante Stop.

Modulo IFC Viewer

Il visualizzatore 3D dei modelli IFC: qui carichi, esplori e interroghi la geometria dell'edificio.

Caricare un modello

Nel pannello Modelli a destra, usa Carica per aggiungere un file .ifc. Sono supportati gli schemi IFC2X3, IFC4 e IFC4X3. Puoi tenere più modelli nello stesso progetto e scegliere quali visualizzare tramite la casella accanto al nome.

Navigare nella vista 3D

Esplorare e misurare

• Alberi elementi: la struttura spaziale del modello (sito, edificio, piani, elementi) con il conteggio degli oggetti in ciascun nodo. Clicca un elemento nell'albero o direttamente nella vista 3D per aprirne gli attributi e i Property Set (Pset) nel pannello laterale.
• Misura, Volumi e Lunghezze, nella barra in alto: strumenti rapidi per verifiche dimensionali e pre-computi senza uscire dal viewer.

Anche qui è disponibile una chat dedicata: puoi fare domande sul modello caricato e ricevere risposte contestualizzate sui dati IFC. Ad esempio, chiedendo "Per ciascuna classe IFC, mi puoi controllare i Pset presenti?" Clev restituisce direttamente una tabella con ogni classe (IfcWall, IfcBeam, IfcFooting…) e i relativi Property Set individuati nel modello, senza dover scorrere l'albero elemento per elemento.

Modulo Revit Assistant

Genera ed esegue automazioni scritte in C# direttamente dentro Revit, senza plugin di terze parti o programmazione visuale.

Dalla richiesta in chat allo script eseguito

Il percorso tipico parte da una richiesta scritta in linguaggio naturale, ad esempio "Seguendo le logiche del Master Information Delivery Plan, controlliamo che gli elementi del modello abbiano i parametri e che questi siano anche compilati correttamente. Riporta i risultati per ciascun parametro…". Clev traduce la richiesta in uno script C# pronto all'uso, consultabile per intero aprendo Show C# Code. Quando lo script è pronto compare il riquadro Ready to execute in Revit? con due pulsanti: Save, per conservarlo senza eseguirlo subito, e Run in Revit, per lanciarlo immediatamente sul modello aperto.

Tre scorciatoie per partire più in fretta

• Brief guidato in chat: premi Inizia e rispondi a cinque domande semplici; Clev trasforma le risposte in una richiesta di automazione precisa, pronta da trasformare in script.
• Suggerimenti rapidi: automazioni comuni proposte come scorciatoie, ad esempio Compila parametri stanze, Tag automatici in pianta, Controllo qualità modello, Esporta abaco locali in Excel, Pulisci parametri vuoti.
• Standard tools: automazioni pronte all'uso come Quote Room e Tag Elements, da lanciare con un clic senza passare dalla chat.

Riutilizzare le automazioni

Ogni script salvato con Save compare in My Automations, con il nome che gli hai dato, l'autore e la data. Da lì è ricercabile, organizzabile in cartelle ed eseguibile di nuovo su altri modelli senza riscriverlo da capo.

Modulo Control

Controlli di conformità deterministici: confronti puntuali fra il modello e requisiti espliciti, non stime dell'AI.

Le famiglie di check disponibili

Creare ed eseguire un controllo IFC

1. 01Da Control, premi + Nuovo check e scegli un template, ad esempio Controlli IFC. Seleziona il modello su cui lavorare o caricane uno con Carica IFC. Se il modello è già aperto in IFC Viewer, le regole su Pset, coordinate e clash riusano i dati già in memoria; altrimenti vengono caricati automaticamente al primo test.
2. 02Dai un nome al check (rinominabile in ogni momento dall'icona a matita) e premi Mostra check per aprire l'editor delle regole.
3. 03Nel riquadro Aggiungi controllo, scegli una regola dal menu e premi Inserisci controllo. Ripeti per ogni regola che vuoi includere; usa l'icona cestino su un blocco per rimuoverla.
4. 04Configura i valori attesi di ciascuna regola attiva (vedi tabella sotto). Le modifiche si salvano automaticamente.
5. 05Premi Avvia test sul modello selezionato, oppure Esegui dalla lista dei check. A fine elaborazione compare la notifica di completamento.
6. 06In Risultati e storico test scegli la versione (v1, v2…) dal menu e leggi la tabella Regola / Atteso / Ricevuto / Stato, con i totali Pass, Fail e Warn.
7. 07Scarica il report con Scarica report (PDF con esito di ogni regola e riepilogo) oppure, per i controlli di collisione, l'export Excel clash.

Le regole disponibili

Ogni regola richiama, dove pertinente, lo standard di riferimento del settore.

Leggere l'esito

PASS la regola è rispettata · FAIL la regola non è rispettata: basta una sola regola in fail perché l'intero check risulti fallito · WARN esito parziale, ad esempio per un campionamento o un limite di coppie di clash raggiunto.

Azienda

La sezione dove si gestisce il team e le risorse condivise fra tutti i progetti.

Membri

L'elenco mostra ogni persona con la propria email, il ruolo (Admin o Membro) e la data di ingresso nel team, oltre al totale dei posti assegnati rispetto al piano attivo (es. 7/10). Il pulsante Invita membro aggiunge un nuovo collega; un amministratore può cambiare il ruolo di chiunque dal menu a tendina nella colonna Ruolo o rimuoverlo con la X a fine riga.

Libreria

Una libreria documentale condivisa a livello aziendale, separata dai documenti dei singoli progetti: utile per standard, tavole tipo, cataloghi e riferimenti che più commesse devono poter richiamare. Si organizza in cartelle con Nuova cartella e ha un proprio Cestino per gli elementi rimossi.

Impostazioni

Raggiungibili dal tuo avatar in alto a destra, in qualsiasi punto dell'app.

Flussi di lavoro consigliati

Quattro percorsi end-to-end che ricorrono più spesso nel lavoro quotidiano con Clev.

Domande frequenti e note utili

Perché Clev non tiene conto di un documento che ho caricato?

Controlla che sia selezionato nel modulo Assistente: solo i documenti con la spunta attiva entrano nel contesto delle risposte dell'AI.

Ho caricato un IFC ma non lo trovo in Assistente

È corretto: i modelli IFC si gestiscono esclusivamente dal modulo IFC Viewer, non da Assistente.

Perché un check risulta FAILED anche se molte regole sono in PASS?

Basta una sola regola in fail perché l'intero check sia marcato come fallito: consulta la tabella dei risultati per individuare quale.

Revit Assistant non esegue l'automazione

Verifica che Revit sia aperto, che il plugin Clev risulti Connesso (indicatore in alto a destra) e che il modello corretto sia aperto in Revit prima di premere Esegui.

Quanto è affidabile il clash detection di Control?

Usa euristiche sui dati IFC disponibili nel viewer: ottimo come prima verifica rapida, ma per collisioni geometriche esatte su geometrie complesse resta utile un motore di clash mesh-based dedicato.

Dove trovo altro materiale di supporto?

Dal menu laterale della Home sono raggiungibili il Knowledge Hub e la Documentazione, con approfondimenti aggiuntivi.