Glossario delle entità principali

Panoramica

Questo glossario raccoglie le definizioni dei concetti fondamentali di Whisperer — dalla sessione di chiamata fino alla base di conoscenza e ai piani. Esiste affinché il resto della documentazione si legga senza dover indovinare nulla: quando incontri un termine in un qualsiasi articolo, qui ne troverai il significato esatto.

Questa è una pagina di riferimento. Invece di una procedura passo dopo passo, include una sezione "Come si collegano le entità" — che mostra come i concetti si uniscono in un unico flusso di lavoro del prodotto.

Quando usarlo

Stai leggendo la documentazione per la prima volta e vuoi verificare i termini.
Un altro articolo ha usato un termine che non conosci (per esempio, "no-logs" o "ruolo del modello").
Stai configurando i prompt, la base di conoscenza o un abbonamento e vuoi capire i confini dei concetti.

Termini

Sessione (Session) — una sessione dell'assistente durante una chiamata. Ha un ciclo di vita: avvio (session.start) → registrazione audio → domande e risposte → conclusione con salvataggio dei dati. A una sessione sono associati una trascrizione, le domande poste e le risposte del modello. La sessione è l'unità di conteggio dei minuti e la base della cronologia nel pannello di controllo.

Segmento di trascrizione (Segment) — un frammento di parlato riconosciuto che Whisperer forma al volo a partire dall'audio in streaming. Ogni segmento è contrassegnato con un interlocutore e una marca temporale. I segmenti si sommano fino a comporre la trascrizione completa della sessione, mostrata come un ticker scorrevole nel client e salvata nella cronologia (tranne in modalità no-logs).

Interlocutore ([Me] / [Other]) — l'etichetta dell'interlocutore nella trascrizione. [Me] è la tua voce dal microfono, [Other] è la voce proveniente dall'audio di sistema (ciò che viene riprodotto nelle tue cuffie/altoparlanti). Questa etichettatura è possibile perché il client cattura due sorgenti audio indipendenti e contrassegna ogni blocco audio con un'etichetta di interlocutore.

Mind-map (nodo: topic / action_item / decision) — la mappa della riunione che Whisperer estrae dopo una sessione. I nodi (MeetingMapNode) sono di tre tipi: topic (un argomento discusso), action_item (un compito da svolgere), decision (una decisione presa). Nel pannello di controllo la mappa può essere visualizzata e ulteriormente arricchita (enrich-mindmap).

Modello di prompt (prompt di ruolo) — una bozza di istruzione di sistema per il modello, adattata a un ruolo specifico. Lo imposti tu in Prompt Studio e viene incorporato nel prompt di sistema prima del contesto utente e del blocco della base di conoscenza.

Ruolo del modello — lo scopo per cui un modello viene selezionato. Whisperer ha sette ruoli: responses (risposte normali in chat), coding (codice), vision (screenshot e immagini), system_design (risposta strutturata con diagrammi Mermaid), generation (generazione e arricchimento della mind-map), transcription (riconoscimento vocale, Whisper), embedding (vettorizzazione del testo per RAG). Puoi impostare un modello separato per ciascun ruolo.

Base di conoscenza / Nota (Note) — il tuo archivio personale di conoscenza nel pannello di controllo. Una nota contiene un titolo, testo in Markdown e tag. I wiki-link nella forma [[...]] collegano le note in un grafo (vicini, percorso più breve, centralità). La base di conoscenza viene conservata fino a quando non la elimini.

RAG (Retrieval-Augmented Generation) — il meccanismo grazie al quale la risposta del modello viene arricchita con fatti tratti dalla tua base di conoscenza. Le note vengono suddivise in chunk (~512 token, sovrapposizione 64), trasformate in embedding e archiviate in un database vettoriale; per ogni query il sistema usa la ricerca per coseno per trovare i top-k frammenti rilevanti e li inserisce nel prompt. In questo modo i suggerimenti si basano sui tuoi materiali, non solo sulla conoscenza generale del modello.

Contesto utente — dati arbitrari che fornisci in anticipo all'assistente (per esempio, una descrizione del tuo ruolo, del prodotto o del curriculum). Impostato nel tuo profilo, influenza il tono e la profondità delle risposte in tutte le sessioni.

Abbonamento / Piano (Plan) — il tuo livello di accesso al prodotto: Free, Start, Pro, Max. Il piano determina il limite di minuti, l'accesso alla base di conoscenza, il multi-screenshot, la modalità System Design e i modelli frontier. Il nucleo del prodotto (sessioni, base di conoscenza) richiede un abbonamento a pagamento attivo.

Quota di minuti — il limite di tempo di riconoscimento all'interno di un piano. Su Free è di 60 minuti al mese; sui piani a pagamento i minuti sono illimitati. I minuti di una sessione vengono conteggiati nella quota, anche in modalità no-logs (un contatore separato, no_logs_minutes_used). La quota è flessibile: la sessione in corso si concluderà, ma non potrai avviarne una nuova finché non viene reintegrata.

Modalità no-logs (effimera) — una modalità di sessione privata in cui la trascrizione e le risposte non vengono scritte nel database e vengono eliminate al termine della sessione. Utile per conversazioni riservate. Importante: i minuti vengono comunque consumati dalla quota.

Modelli frontier — gli LLM di punta, i più potenti (per esempio, Claude Opus, GPT di fascia alta ed equivalenti). In Whisperer sono sbloccati solo sui piani Max.

Referral — un utente che hai invitato. Per ogni acquisto idoneo da parte di un referral (piano Pro o Max) ricevi una ricompensa di 500 ₽; una ricompensa per ogni persona invitata.

Codice promozionale — un codice sconto. Due tipi: percent (uno sconto percentuale sul prezzo) e bonus_days (giorni bonus di abbonamento). La maggiorazione per la conversione di valuta non viene applicata a sconti e bonus.

Come si collegano le entità

I concetti di Whisperer formano un unico flusso — dalla conversazione alla conoscenza:

Avvii una sessione. Il client cattura due sorgenti audio e le contrassegna con gli interlocutori [Me] / [Other].
Il riconoscimento (il ruolo del modello transcription) trasforma l'audio in segmenti di trascrizione.
Quando poni una domanda, viene assemblato il prompt di sistema: il modello di prompt del ruolo del modello scelto → il contesto utente → il blocco RAG dalla tua base di conoscenza.
Il modello risponde; in modalità no-logs non vengono salvate né la trascrizione né le risposte, ma i minuti vengono comunque detratti dalla quota stabilita dal piano.
Dopo la sessione, Whisperer estrae una mind-map (topic / action_item / decision) per il riepilogo della riunione.
Il livello di accesso a tutto questo è stabilito dall'abbonamento; i codici promozionali e i referral aiutano a estenderlo o a renderlo più economico, mentre i modelli frontier sono abilitati su Max.

Screenshot

📸 [Screenshot: trascrizione live con le etichette [Me] e [Other]]

📸 [Screenshot: mind-map della riunione con nodi topic/action_item/decision]

📸 [Screenshot: grafo della base di conoscenza costruito dai wiki-link]

Errori comuni

Confondere una sessione con una trascrizione. La sessione è l'intera sessione, con conteggio dei minuti; la trascrizione (un insieme di segmenti) ne è solo una parte.
Considerare no-logs come "gratuito". I minuti in no-logs vengono consumati come al solito; solo i dati non vengono salvati.
Aspettarsi i modelli frontier su Pro. I modelli frontier sono disponibili solo su Max.
Cercare di impartire comandi tramite il contesto utente. Il contesto fornisce fatti su di te; usa un modello di Prompt Studio per controllare come risponde l'assistente.

Buone pratiche

Consulta il glossario prima di configurare prompt e ruoli del modello — fa risparmiare tempo di debug.
Compila in anticipo il tuo contesto utente e la tua base di conoscenza: RAG inserisce i tuoi fatti in ogni risposta.
Usa i wiki-link tra le note in modo che il grafo della conoscenza aiuti nella ricerca e nella navigazione.
Per le chiamate riservate, abilita no-logs, tenendo presente che i minuti vengono comunque consumati.