Guida utente MetriTek

Introduzione

MetriTek è l'applicazione Windows per computi metrici estimativi e preventivazione commerciale (edile e impianti). Fa parte della famiglia TekCad, insieme a QuadriPro (plugin AutoCAD).

Un progetto è un unico file .tkcm: computi, elenchi prezzi, preventivi, libretti, revisioni. Il file .tkpv serve solo a importare/esportare un preventivo.

Primi passi

1. Avvia MetriTek e accedi con l'account TekCad (dashboard di avvio).
2. Se sul PC non c'è già una licenza per quell'account: inserisci la chiave oppure continua con Free.
3. Dalla dashboard: Nuovo progetto, Apri, oppure un recente. Puoi anche trascinare un file .tkcm / .tekq / .tkpv.
4. A sinistra, in Area di lavoro: crea un Computo (e, se serve, un Elenco prezzi o un Preventivo).
5. Importa un prezzario regionale da Strumenti → Archivi prezzari (file .xpwe o catalogo remoto).
6. Compila il computo a mano, dalla Libreria prezzi, oppure con Strumenti → Computo AI.
7. Ctrl+S salva tutto il progetto .tkcm.

Le impostazioni (tema, AI, preventivo, aggiornamenti) sono nella sidebar Strumenti → Impostazioni.

Interfaccia e navigazione

Sidebar (sinistra)

• Area di lavoro — Commessa, poi elenco Computi, Elenchi prezzi, Preventivi (se attivi). I Computi sono un albero (▶/▼, stato ricordato): sotto ogni computo ⛑ Costi sicurezza (dopo il primo clic su ⛑), ↻ Revisioni e libretti; sotto ogni revisione con costi sicurezza: ⛑ e libretti. Clic apre; doppio clic rinomina; tasto destro: duplica, libretto, elenco prezzi, revisione, elimina, espandi/comprimi.
• Strumenti — Stampa progetto, Archivi prezzari, Analisi di prezzo, Capitolato tecnico AI, Impostazioni.
• In alto: azioni rapide di progetto (nuovo / apri / salva / computo / AI). Ctrl+B mostra o nasconde la sidebar.

Libreria prezzi (destra)

Nelle schede Computo (e con computo affiancato): pannello a destra. Apri/chiudi con la striscia ▶/◀, Visualizza → Mostra/Nascondi Libreria prezzi o Ctrl+Alt+B. Stato e larghezza restano salvati.

Schede, tema e log

Ogni computo, elenco, preventivo, libretto o strumento si apre in una scheda in alto: puoi avere più computi nello stesso .tkcm.

Impostazioni → Preferenze: tema Chiaro, Scuro o Automatico (segue Windows), con cambio immediato senza riavvio. Ctrl+L (Visualizza) apre il pannello log di sistema.

File di progetto (.tkcm e .tkpv)

File → Nuovo / Apri / Salva / Salva con nome (Ctrl+N, Ctrl+O, Ctrl+S, Ctrl+Shift+S). Puoi aprire un progetto trascinando il file sulla finestra; i recenti sono sulla dashboard di avvio.

Account e licenza

All'avvio MetriTek verifica la sessione account. Se su questo PC non c'è una licenza attivata: dialog chiave di licenza oppure Continua con Free. La licenza è per dispositivo (chiave + identificativo PC); a scadenza o annullamento di Plus/Pro il software torna Free.

Menu e comandi

File

• Nuovo / Apri / Salva / Salva con nome — Ctrl+N Ctrl+O Ctrl+S Ctrl+Shift+S
• Apri file preventivo (.tkpv)… — importa nel .tkcm corrente
• Importa XPWE nel computo… — Ctrl+Shift+I (aggiungi o sostituisci)
• Importa schema TekCad Quadri (.tekq)… — Ctrl+Shift+Q
• Esporta computo… — Ctrl+Shift+E (PDF, Word, Excel, XPWE)
• Esci — Ctrl+Q

Visualizza e Strumenti

• Visualizza — Nuovo tab Computo, Nuovo elenco prezzi; Mostra/Nascondi Sidebar (Ctrl+B), Libreria prezzi (Ctrl+Alt+B) e log di sistema (Ctrl+L); Affianca un altro computo… / Chiudi pannello affiancato.
• Strumenti — Computo AI (Excel / chat / .tekq, anche Ctrl+Shift+A), Preventivo…, Analisi Congruità AI… (Ctrl+Shift+K), Computo da chat AI… (Ctrl+Shift+B), Suggerisci voci correlate (AI)… (Ctrl+Shift+G), Impostazioni…, Licenza…, Informazioni.
• Aiuto — Guida in linea (F1), Scorciatoie, Verifica aggiornamenti, Informazioni.

Barra azioni in sidebar

Sotto il marchio: Nuovo progetto, Apri, Salva, Nuovo tab Computo, Crea computo con AI (Ctrl+Shift+A), icona Analisi Congruità AI (Ctrl+Shift+K). Sostituiscono una toolbar in alto, per lasciare spazio alla griglia.

Commessa e intestazione

Area di lavoro → Commessa: dati unici del progetto usati in stampe ed export — committente (denominazione, P.IVA/C.F., PEC), oggetto/luogo/offerta (oggetto lavori, comune, data, R.U.P., importo presunto), progettista/studio (ragione sociale, sede, recapiti, P.IVA, CF, albo, logo) e note. Ogni modifica si propaga a tutti i computi; c'è l'opzione di stampa «Stampa dati commessa su pagina separata».

Computo metrico

Griglia computo

La scheda Computo è la tabella delle lavorazioni: ordine, codice, descrizione, U.M., quantità, prezzo, importo. In basso a destra: Totale CME.

Toolbar

• ↩ Annulla / ↪ Ripristina — Ctrl+Z / Ctrl+Y
• Voce — Ins; apre le Proprietà
• Misura — sottomisura sotto la voce
• Duplica / Elimina / Su / Giù — Ctrl+D, Canc
• Struttura — Espandi tutto (a step), Comprimi tutto; modalità Standard / Raggruppa per WBS / Raggruppa per Capitoli
• Riepilogo — quadro importi per capitoli (chiudibile)
• WBS — pannello Organizzazione voci e riepiloghi
• Sicurezza — scheda stima costi della sicurezza (vedi sotto)
• Azzera filtri — rimuove filtri testo / WBS / tag
• Esporta — Ctrl+Shift+E

Barra sotto la toolbar

Cerca codice, descrizione e misure; checkbox Categorie omogenee, Quantità: L × l × h, Tag; filtro Tag: Tutti ▾; combo Descrizione ridotta/estesa; ✕ Azzera filtri; slider zoom della tabella.

Tasto destro (voce): nuova voce sopra/sotto, misurazione, a misura / a corpo, Analisi prezzo…, Proprietà, Tag…, espandi/comprimi, duplica, elimina. Ins su riga vuota o dopo la selezione; trascina le voci dalla Libreria prezzi.

Misurazioni

Sotto ogni articolo puoi aprire le misurazioni (parti × dimensioni → quantità). In griglia le sottomisure si distinguono: fascia verde acqua, testo in corsivo, prefisso «·», badge s, numerazione N.m (es. 3.1).

Seleziona la voce → Misura (o menu contestuale) → compila descrizione, N. parti, lungh., largh., H/peso. La checkbox Quantità: L × l × h mostra le colonne dimensioni. Tasto destro: a misura o a corpo (anche su più voci). A corpo, l'avanzamento vive nel libretto.

Le quantità a zero sono evidenziate (cella in rosso, «!» sul N°); in basso ⚠ N voci q.tà 0 (clic per andare alla successiva). Possono far scattare un avviso in export se il precheck è attivo.

Formule quantità

Su ogni misurazione puoi definire formule su Parti, Lung., Larg., H/peso e Q.tà (non sulla quantità totale della voce). Tasto destro → ƒx Formula quantità…. Operatori + - * / ( ); riferimenti @mis:{uid}:{campo}, @art:{uid}:qty, @sec:{uid}:total. Celle calcolate: prefisso ƒ. In stampa progetto, con misurazioni attive: combo Formule in stampa (solo valori / espressioni / valori + espressioni).

Capitoli e WBS

WBS/Capitoli (pulsante checkable) apre il pannello laterale di struttura con due alberi:

• WBS — nodi di fase (codice, titolo, colore), assegnabili alle voci (proprietà «Fase WBS» / codice WBS).
• Capitoli — SuperCapitolo, Capitolo, SubCapitolo (+ SuperCap. / + Capitolo / + SubCap.), rinomina, elimina, ↑↓, colore.

Con costi della sicurezza attivi, in basso nel pannello WBS compaiono anche Totale lavori, Totale sicurezza e Totale generale.

Menu Struttura nella toolbar: Standard, Raggruppa per WBS, Raggruppa per Capitoli. Il Riepilogo aggrega gli importi; in stampa scegli il livello capitoli. Doppio clic / F2 sul titolo di sezione rinomina solo l'intestazione.

Elenco prezzi

Area di lavoro → ＋ Nuovo elenco prezzi: scheda nel .tkcm. Toolbar: ＋ Aggiungi voce (Ins), Duplica (Ctrl+D), Elimina (Canc), ricerca, Reset filtri.

Combo Sorgente CME — computo principale o snapshot di una revisione (↻); Aggiorna da computo (una riga per tariffa/codice/U.M./prezzo, senza quantità); Sincronizza automaticamente. Sidebar: tasto destro su computo → 📋 Nuovo elenco prezzi; su revisione → da questa revisione.

Libreria prezzi

Pannello a destra: cerca nel prezzario attivo e negli elenchi del progetto. Apri/chiudi con striscia ▶/◀, menu Visualizza o Ctrl+Alt+B.

• Tab Archivio — prezzari .xpwe; filtri Capitolo / Subcapitolo.
• Tab Progetto — elenchi del .tkcm.
• Trascina sulla griglia; doppio clic inserisce subito dopo la voce selezionata (dopo eventuali misurazioni), ereditando a corpo/misura, categorie, capitoli e WBS.

Disponibile anche nelle schede Revisione ↻ e Costi sicurezza ⛑. Un prezzario attivo alla volta. Visualizza → Affianca un altro computo… confronta due elaborati.

Proprietà della voce e tag

Proprietà (doppio clic / tasto destro / Nuova voce): codice, descrizioni, U.M., prezzo, nota, tag, immagine, incrementi %, tipo sicurezza, WBS, capitoli, a misura/corpo. Accanto a Descrizione estesa: pulsante 🪄 → chat AI per bozza testo (rivedi sempre prima di applicare).

Le tag sono etichette di progetto (colore + nome): non sostituiscono WBS o capitoli. Ctrl+C copia testo o selezione TSV; Ctrl+D duplica; tra due computi dialog Copia/Sposta.

Costi della sicurezza nel computo

⛑ Sicurezza nella toolbar apre la scheda dedicata (identità teal) e fa comparire in sidebar ⛑ Costi sicurezza — solo dopo il primo clic. Footer del computo: Totale lavori, Totale sicurezza, Totale generale. Le voci del capitolo sicurezza non compaiono nella griglia CME, solo nella scheda sicurezza.

1. Come calcoli il totale — voci analitiche / solo % / misto / da analisi B2
2. Quota % (se prevista) — percentuale e base
3. Riepilogo + griglia analitica; libreria a destra per trascinare voci nel capitolo sicurezza

Proprietà → Tipo sicurezza: nessuna / fase / generale / speciale (PSC). Importi di sicurezza non soggetti a ribasso d'asta. Elaborati PDF dedicati in arrivo in Stampa progetto.

Prezzari

Archivi prezzari

Strumenti → Archivi prezzari (sidebar): listini regionali .xpwe.

1. Importa prezzario… — guidata (anteprima; sostituisci / aggiorna / nuovo).
2. Indicizzazione: BM25 + TF-IDF (tutti). Plus/Pro: indice semantico se attivo in Impostazioni.
3. Indicizza AI… — rilancia l'embedding sul listino scelto.
4. Chiusura durante l'indice: interruzione sicura, ripresa al riavvio.
5. Attiva un archivio per libreria e matching.

Cartelle (nuova radice, sotto-cartella, sposta, rinomina, elimina, navigazione ◀ Indietro / Tutte le cartelle). Nel catalogo remoto: doppio clic per il download (anche più di uno, l'indice in coda), Segnala prezzario mancante… apre il form web. Se il catalogo online non è raggiungibile, MetriTek usa una lista di fallback.

Computo AI

Wizard Computo AI

Strumenti → Computo AI (Excel / chat / .tekq)… oppure Ctrl+Shift+A. Tre strade:

1. Excel / CSV / PDF — elenco lavorazioni da file.
2. Chat AI — descrivi i lavori; proposte dal prezzario.
3. Schema .tekq — dispositivi da QuadriPro.

Flusso tipico: scegli il prezzario → l'AI/motore abbina → rivedi la tabella di confronto → Inserisci nel computo.

Da Excel, CSV o PDF

Excel consigliato: intestazione in riga 1 con Capitolo / Descrizione / U.M. / Quantità / Note; una riga = una voce; dati tecnici in descrizione (mm², In, IΔn, DN, spessori). Se le colonne sono già chiare, l'estrazione è locale e l'AI interviene sui residui.

PDF: con testo, il layout è riutilizzato dopo le prime pagine; per scansioni/foto serve OCR Gemini (AI con vision).

Riconoscimento guidato (se il PDF sembra un computo già redatto):

• Importa fedele al PDF — l'AI guarda ogni pagina come immagine (vision) e ricostruisce codici, descrizioni, misurazioni (Parti×L×W×H) e prezzi; ricompone le voci spezzate tra pagine; senza abbinamento agli Archivi prezzari.
• Struttura da importare (solo fedele): Capitoli e sottocapitoli (come nel PDF) · Solo capitoli principali · Lista piatta.
• Abbina ai prezzari — uno o più listini dagli Archivi; match in sequenza sulle voci senza codice.

Stesso flusso in Preventivo → Importa computo (PDF). In Free, max 10 voci per operazione su PDF/OCR AI e sulla generazione automatica.

Chat AI del computo

Strumenti → Computo da chat AI… (Ctrl+Shift+B) oppure la tab Chat del wizard. Layout: chat a sinistra, Voci proposte al centro, Cerca nel prezzario a destra.

• Scrivi una lavorazione, anche corta («laterizio forato da 12»).
• Se la ricerca trova subito una sola voce congrua, quella è la proposta (senza passaggio AI).
• Su ogni card: Utile / Non corretto; + per inserire nel computo.
• Quantità in linguaggio naturale: «500 metri» diventa misura. Su un intervento ampio compare Genera computo automatico.

La chat è salvata sul computo nel .tkcm; il prezzario si ricorda in sessione e sul computo. La chat voce-singola è disponibile anche in Free (conta nelle 10 richieste Free sull'AI inclusa).

Da schema QuadriPro (.tekq)

Esporta lo schema unifilare in .tekq da QuadriPro, poi in MetriTek File → Importa schema TekCad Quadri (.tekq)… (Ctrl+Shift+Q), trascina il file, o usa la sorgente .tekq nel wizard. Il matching usa i dati tipizzati dei dispositivi (In, poli, Icn, sezione cavi, …) sul prezzario impianti scelto.

Abbinamento al prezzario

Dopo l'estrazione, MetriTek cerca nel listino (cascata locale +, sui dubbi, AI). Nella tabella di confronto (passo 3) vedi proposta AI vs voce di prezzario, confidenza e provenienza. Abbinamento manuale… apre il dialog di ricerca e la scelta viene ricordata sui computi successivi (stesso prezzario). Puoi inserire solo le voci già abbinate e lasciare le bozze per dopo.

Preventivo

Il Preventivo è distinto dal computo metrico ufficiale: valorizzi l'elenco cliente (o voci tue) con il listino interno. Attivalo in Impostazioni → Preferenze → Modulo Preventivo, poi Area di lavoro → Preventivi o Strumenti → Preventivo….

Flusso a fasi

1. Voci — Importa computo (Excel/CSV/PDF/XPWE) / ＋ Voce / Da listino…
2. Abbinamento — Abbina al listino / a mano; filtri Solo non abbinate / Dubbie
3. Offerta — ricarichi, sconti, IVA, pagamenti, condizioni
4. Consegna — Anteprima → PDF/Excel; Marca inviata (snapshot); Diff versioni

Toolbar

• Importa computo — Excel/CSV/PDF/XPWE (AI allinea colonne; OCR su scansioni; su PDF riconosce se è un computo già redatto e guida import fedele o multi-prezzario; Free: 10 voci su PDF/OCR).
• Importa listino / Gestisci listini — Excel/CSV/XPWE, tariffe ML, analisi costi.
• ＋ Voce / Da listino… / elimina; Abbina al listino / Abbina a mano….
• Anteprima / Excel / PDF (template cliente o interno); Marca inviata / Diff versioni.
• Importa .tkpv / Esporta .tkpv — il Salva progetto (Ctrl+S) tiene il preventivo nel .tkcm.

Dati offerta (sezione collassabile): titolo, cliente, P.IVA, n. offerta, azienda/logo, ricarichi SG%/utile%, sconti, regime IVA, pagamenti, condizioni, blocchi nota personalizzati, impaginazione PDF. KPI: Voci · Abbinate · Mancanti · Imponibile · Totale ivato. Opzione Vista economica (margine %).

Il listino interno è il tuo (diverso dagli Archivi prezzari). Memoria abbinamenti isolata. Archivio clienti e aziende: persistenti sul PC, non nel .tkcm.

Libretto e S A L

Libretto delle misure

Dalla sidebar sul computo (tasto destro): 📐 Nuovo libretto misure…, da CME (guidato) o da revisione (guidato). Il libretto è nel .tkcm.

Workspace unico a cinque destinazioni (niente doppia navigazione Misure|Contabilità):

Quadro generale

KPI (contratto/maturato, SAL, certificato, residuo pagamenti) e prossima azione deterministica; elenco «Da completare».

Misure

Viste: Registrazioni | Confronto | Distinta ferri. Toolbar: ＋ Nuova voce, Elimina, ↑↓, sync prezzi, Importa da CME…, Ferri Ø, Annulla/Ripristina.

• A misura / A corpo nel dettaglio; ferri con editor sagome e anteprima vettoriale quotata.
• Misure già in atti definitivi: sola lettura (+ rettifica).

SAL e documenti (fascicolo)

Elenco SAL + tab fascicolo: Riepilogo, Certificati, Documenti, Atti, Controlli, Cronologia, Archivio, Conto finale.

• ＋ Prepara SAL… — wizard 3 step (periodo/cutoff → misure → riconciliazione): salva bozza o apre fascicolo; nessuna emissione automatica.
• Emesso: Consulta / Esporta / Prepara certificato; bozza: Modifica / Verifica / Elimina.
• Documenti non associati: filtro sugli atti senza SAL (niente auto-link).
• Archivio ricercabile: doppio clic seleziona l’entità corretta.

Pagamenti

Viste Certificati da saldare / Movimenti; pagamento parziale; storno con motivo (la storia resta). Esporta XLSX… / Esporta PDF… sul prospetto (generazione in background).

Contratto

Anagrafica, Importi / Ribassi, revisioni contabili. Schema contabilità v4 nel .tkcm (pagamenti inclusi).

Importi, atti e flusso SAL

Importi e ribassi

Destinazione Contratto → Importi / Ribassi:

1. Tipologia appalto (a misura / a corpo / misto) e offerta (unico ribasso / prezzi unitari).
2. Flag (non ribassare sicurezza/manodopera, sicurezza analitica).
3. Quadro progetto oppure Ricalcola da CME.
4. Ribasso/aumento % e verifica importo contratto.
5. Applica a contabilità per propagare al libretto/SAL.

Atti contabili

In SAL e documenti → Atti (e Archivio): storico bozze e definitivi (libretto, registro, sommario, SAL, certificato, stato finale).

• ＋ Nuova bozza — snapshot (libretto/registro/sommario dal libretto corrente).
• Archivia definitiva (irreversibile): le misure incluse diventano in sola lettura.
• Export…: PDF formale; libretto anche XLSX/DOCX; sommario XLSX/DOCX; conto/stato finale XLSX/DOCX; pagamenti PDF/XLSX. Gli emessi si ristampano dallo snapshot storico.
• Filtro Solo documenti non associati a SAL.
• Dai Certificati: Registra sul registro. Tab Conto / stato finale: maturato/certificato/pagato (non è collaudo).

Wizard SAL e certificato

1. Configura Contratto → Importi / Ribassi e applica; registra le misure.
2. ＋ Prepara SAL… — 3 step; Salva bozza o Apri fascicolo (nessuna emissione alla chiusura).
3. Dal fascicolo: ✔ Emetti / 🔒 Blocca; poi certificato e Registra sul registro.
4. Pagamenti: residui / parziali / storno con motivo.
5. Export registro, SAL e certificato in Excel, Word, PDF.

Un SAL/certificato emesso o bloccato non si elimina. Flusso: Contratto → Misure → Prepara SAL → Fascicolo → Certificato → Pagamenti → Conto finale.

Revisioni del computo

Tasto destro sul computo in sidebar: ↻ Crea revisione…. Poi Apri, Rinomina, Duplica, Elimina; Nuovo libretto da questa revisione. La vista revisione (identità azzurro) è lo snapshot del computo con evidenziazione diff: Invariata / Modificata / Aggiunta / Eliminata. Libreria prezzi attiva (Ctrl+Alt+B).

Se il CME ha i costi sicurezza attivi, la revisione li congela; altrimenti resta senza. Footer e riepilogo: Totale lavori · sicurezza · generale; Δ Sicurezza rispetto al computo attuale. Per modificare lo snapshot sicurezza: ⛑ Sicurezza nella toolbar revisione (solo su quella revisione).

Esporta log variante: Copia, TXT, PDF, Excel. Utile prima delle varianti di cantiere e per collegare libretto/SAL a uno stato congelato.

Documenti

Stampa ed export

Esporta computo (Ctrl+Shift+E o ⎙ Esporta)

Formati: PDF, Word, Excel, XPWE PriMus. Opzioni (da Impostazioni): righe di misurazione, quadro riepilogativo, dati commessa; Voci a corpo / Voci a misura (almeno una); supercapitoli in nuova pagina, livello capitoli, descrizione sintetica/estesa; frontespizio personalizzato (template in templates/); data; precheck prezzi/q.tà a zero. Generazione in background (UI resta reattiva). Se il file destinazione è aperto, MetriTek salva con suffisso _1.

Stampa progetto (sidebar)

Tipo: Computo, Elenco prezzi, Analisi prezzi, Quadro comparativo (2 sorgenti). Sorgente A/B: computi e revisioni ↻. Preset Tecnica / Presentazione. Con misurazioni: combo Formule in stampa.

Con una revisione come sorgente: Evidenzia modifiche (colori + voci eliminate con «−»); Allega log varianti. Il comparativo accetta qualsiasi coppia diversa (computo↔revisione, revisione↔revisione, …).

Capitolato tecnico AI e Analisi di prezzo

Strumenti → Capitolato tecnico AI: 1) Aggiorna computi e scegli sorgente (computo o revisione ↻); 2) dettaglio Standard / Professionale / Molto esteso; 3) output PDF+DOCX / solo PDF / solo DOCX; 4) Genera capitolato… in background (puoi usare altre schede) — bozza da revisionare.

Strumenti → Analisi di prezzo: scegli una sorgente (computo o revisione), cerca, Aggiorna elenco, Apri analisi…. Nella scheda: scomposizione costi; Suggerisci con AI… → anteprima → Sostituisci/Aggiungi → Salva. Anche dal computo: tasto destro → Analisi prezzo….

Account e AI

Piani Free, Plus e Pro

• Chat voce-singola, import Excel già strutturato, computo manuale: non sono bloccati dal piano (la chat sull'inclusa conta nelle richieste del piano).
• Plus oltre le 50: solo le tue chiavi. Reset al rinnovo abbonamento.
• Pro: oltre il budget token, chiavi personali o attesa rinnovo del ciclo Stripe (non il 1° del mese).
• Free: reset richieste al mese di calendario.

Impostazioni

Impostazioni (sidebar o Strumenti → Impostazioni). Sezioni in ordine:

1. Account — nome, email, Disconnetti (chiude l'app).
2. Licenza e utilizzo — stato, piano, postazioni, rinnovo, chiave, Attiva; a destra contatore AI del mese (senza € in chiaro).
3. Intelligenza Artificiale — vedi sotto.
4. Azienda / anagrafiche — emittenti preventivo (più aziende, anagrafiche, logo, predefinita).
5. Preferenze — tema; precheck export; Modulo Preventivo; export predefinito (misurazioni, voci a corpo/misura, riepilogo, commessa, supercapitoli, livello capitoli, formato).
6. Aggiornamenti — verifica all'avvio (opzione), verifica manuale, scarica e installa.

Impostazioni AI

• Switch AI on/off globale: puoi lavorare senza AI.
• Informativa AI: alla prima funzione AI (o da Impostazioni) compare il consenso (checkbox non pre-spuntata). Senza accettazione le AI non partono; una nuova versione sul server richiederà di nuovo il consenso.
• Free: solo AI inclusa MetriTek.
• Plus/Pro: AI inclusa oppure chiavi personali (OpenAI, Claude, DeepSeek, Gemini), cifrate sul PC. Come ottenere le chiavi API →
• Ruoli AI (chat, PDF, OCR, embedding): Plus/Pro con chiavi personali. OCR PDF: provider con vision (oggi Gemini).
• Indice semantico prezzari: Plus e Pro (in Plus con chiavi tue se non vuoi bruciare le 50).
• Utilizzo: colonna a destra in Licenza e utilizzo AI (totali dal server).

Congruità e voci correlate: Analisi Congruità AI… (Ctrl+Shift+K) — voci mancanti, anomalie di quantità, incongruenze sul computo attivo (se fallisce resta aperta: Riprova); Suggerisci voci correlate (AI)… (Ctrl+Shift+G) — lavorazioni tipicamente associate alla voce selezionata. Sono suggerimenti da accettare o scartare, non modifiche automatiche.

Come ottenere le chiavi API (Plus e Pro)

Con i piani Plus e Pro puoi usare le tue chiavi API dei provider AI: le chiamate vanno sul tuo account del provider (tu paghi l’uso), cifrate sul PC con DPAPI. Sul piano Free le chiavi personali non sono disponibili: solo l’AI inclusa MetriTek.

Dove inserirle in MetriTek: Strumenti → Impostazioni → Intelligenza Artificiale → salva la chiave del provider → assegna i ruoli (chat, PDF, OCR, embedding) al modello che preferisci.

OpenAI (ChatGPT / GPT)

1. Apri platform.openai.com e accedi (o crea un account).
2. Vai su API keys (menu account / dashboard).
3. Clicca Create new secret key, assegna un nome (es. «MetriTek»), copia la chiave subito (inizia tipicamente con sk-): non viene mostrata di nuovo.
4. In Billing verifica di avere credito o metodo di pagamento attivo, altrimenti le richieste falliscono.
5. In MetriTek: Impostazioni AI → provider OpenAI → incolla la chiave → Salva.

DeepSeek

1. Apri platform.deepseek.com e registrati / accedi.
2. Nella console, sezione API Keys, crea una nuova chiave e copiala.
3. Ricarica il credito (Top-up / Billing) se richiesto.
4. In MetriTek: provider DeepSeek → incolla → Salva. Ideale per chat e abbinamenti a costo contenuto.

Anthropic Claude

1. Apri console.anthropic.com e accedi.
2. Vai su API Keys → Create Key, copia la chiave (spesso inizia con sk-ant-).
3. Attiva la fatturazione / crediti nella console se necessario.
4. In MetriTek: provider Claude (Anthropic) → incolla → Salva.

Google Gemini

1. Apri Google AI Studio → API key (account Google).
2. Clicca Create API key, scegli o crea un progetto Google Cloud, copia la chiave.
3. Per uso oltre le quote gratuite, collega la fatturazione su Google Cloud come indicato da Google.
4. In MetriTek: provider Gemini → incolla → Salva. Consigliato per OCR / vision su PDF scansionati e per embedding (indice semantico prezzario).

Ruoli consigliati

• Chat / abbinamento: DeepSeek, OpenAI o Claude.
• OCR PDF (scansioni): Gemini (vision).
• Embedding / indice semantico: Gemini (modelli embedding).

Puoi mischiare i provider: ad esempio Gemini per OCR e DeepSeek per la chat. Se una chiave non è valida o il credito è esaurito, MetriTek segnala l’errore: controlla la console del provider.

Riferimenti

Log di sistema — Visualizza → Mostra/Nascondi log di sistema (Ctrl+L); pannello diagnostica utile se qualcosa fallisce (import, AI, indicizzazione). Informazioni su MetriTek — versione, tagline, disclaimer AI.

Ricorda: l'AI è assistita; non inventa voci ufficiali; un listino regionale alla volta; il preventivo non sostituisce il computo metrico; nel computo usa la toolbar della griglia per annulla/taglia/incolla. L'Analisi di prezzo in sidebar può risultare «in sviluppo» nel tooltip: il workspace è comunque usabile (elenco + apri analisi).

Scorciatoie da tastiera

Elenco completo: Aiuto → Scorciatoie da tastiera…

Aggiornamenti

All'apertura, se l'opzione è attiva in Impostazioni → Aggiornamenti, MetriTek chiede di verificare gli aggiornamenti (default: attiva). Se ne trova uno propone Installa ora. Puoi disattivare la verifica automatica con il checkbox Verifica aggiornamenti all'avvio; la verifica manuale resta da Aiuto → Verifica aggiornamenti… o Impostazioni → Aggiornamenti.