Configurare i servizi di sistema
Usa le dodici aree del sistema per collegare Obelisk, regolare raccolta e report e verificare i servizi necessari alle automazioni opzionali.
Individuare l’area pertinente
Apri Amministrazione → Sistema e utilità. Le aree comprendono identità e lingua, autenticazione, centralino e database, percorsi, aggiornamento, salute code, tendenze e previsioni, Gemini, analisi in background, SMTP e pulizia, diagnostica e licenza. Lavora nell’area del requisito o sintomo effettivo.
Modificare e salvare un’area
Annota i valori esistenti prima di sostituirli. Connessioni, percorsi delle registrazioni e opzioni di conservazione hanno effetti diversi: cambiare l’intervallo della schermata non ripara una connessione SQL o AMI.
Configurare la dipendenza
Imposta connessione PBX/database, percorso o parametri SMTP necessari. Per l’AI, controlla modello e chiave Gemini, poi le impostazioni dell’elaborazione in background.
Separare analisi ed eliminazione
Controlla lo stato dell’analisi automatica separatamente da pulizia e conservazione. Attivare i lavori pianificati non abilita da solo l’eliminazione delle registrazioni: le opzioni richiedono una configurazione specifica.
Orientarsi nei dodici pannelli Sistema
La navigazione laterale contiene undici pannelli numerati di impostazioni e diagnostica, più Licenza. Alcuni controlli hanno un proprio salvataggio o una conferma dedicata: leggi il pulsante e il riscontro locale prima di lasciare il pannello.
| Pannello | Cosa controlla |
|---|---|
| 1. Identità e lingua | Identità aziendale e della linea PBX, lingua dei report, separatore CSV e memoria per lavori audio e report mensile. |
| 2. Sicurezza e accesso | Tentativi e blocco degli accessi, oltre alle durate delle sessioni normali e Schermo con salvataggio dedicato. |
| 3. Asterisk e database | Connessione e credenziali AMI, database applicativo e database CDR sorgente. Controlla il servizio pertinente quando una funzione non si connette. |
| 4. Registrazioni e file di log | Percorso registrazioni Asterisk, arretrati delle cartelle precedenti, estensioni audio consentite, percorsi dei log di processi e applicazione e geografia degli IP pubblici. |
| 5. Intervalli di aggiornamento | Aggiornamento live, cache, raccolta storica e intervallo delle richieste AI, oltre a URL e attribuzione delle tessere della mappa. Gli intervalli hanno scopi diversi. |
| 6. Salute delle code | Obiettivi di SLA e attesa e penalità degli indicatori di salute; confronta lo stato risultante con la situazione operativa effettiva. |
| 7. Tendenze e previsioni | Sensibilità delle tendenze, storico, campione e orizzonte delle previsioni, cache, ore della heatmap e dimensione della nuvola di parole della qualità. |
| 8. Google Gemini AI | Chiave API, modello e temperatura, strumenti dei modelli, campionamento e fuso dei report. Rivedi le indicazioni mostrate sulla pianificazione settimanale e mensile. |
| 9. Analisi audio e protezione | Limiti di scansione e lotti, dimensioni e stabilità dei file, tempi dei processi, errori transitori e stato dell’analisi automatica. |
| 10. Email SMTP e pulizia audio | Destinatari e mittente, server SMTP e cifratura, pulizia e conservazione. Distingui eliminazione locale e rimozione dei file remoti AI. |
| 11. Verifiche installazione | Esegui la diagnostica in sola lettura, controlla requisiti del database e dell’ambiente e rivedi le correzioni mirate proposte. |
| Licenza | Leggi tipo, stato e scadenza quando presente; usa il collegamento di gestione per le operazioni di attivazione. |
Salvare consapevolmente sessioni e intervalli
In Sicurezza e accesso, l’inattività normale si esprime in minuti, la durata massima normale in ore e quella Schermo in giorni. Usa il pulsante Salva dedicato alla politica delle sessioni. Utenti seleziona la modalità della sessione; questo pannello ne definisce la durata.
Comprendere il ciclo dell’audio con Gemini
L’analisi AI di una registrazione invia l’audio al servizio Gemini configurato. In base alle dimensioni della richiesta, Obelisk include l’audio direttamente oppure carica un file temporaneo tramite Files API. La rimozione dipende dal percorso utilizzato.
Inviare l’audio selezionato
Le richieste più piccole includono l’audio direttamente. Quelle più grandi caricano un file temporaneo e attendono che sia pronto prima dell’analisi. Il caricamento non elimina la registrazione originale del centralino.
Completare il tentativo di analisi
Gemini elabora la richiesta e Obelisk gestisce risultato o errore. Il file Files API deve restare disponibile durante il tentativo di analisi: la cancellazione non viene richiesta immediatamente dopo l’invio.
Richiedere la rimozione del file temporaneo
Per un file caricato e riconosciuto come proprio, Obelisk tenta la richiesta di cancellazione al termine del flusso, anche in presenza di errori gestiti. L’audio incluso direttamente non ha un oggetto Files API da eliminare. La conservazione locale si gestisce separatamente.
Impostare il percorso delle registrazioni e controllare i link simbolici
In Sistema e utilità → Registrazioni e file di log, imposta una cartella esistente sul server Obelisk. Il valore iniziale è /var/spool/asterisk/monitor, con sottocartelle anno/mese/giorno. L’account asterisk deve poter attraversare le cartelle e leggere l’audio. Una connessione SQL remota non copia le registrazioni in questo percorso.
Usare il percorso reale dell’archivio
Preferisci la cartella reale o il punto di montaggio previsto, conservando sottocartelle anno/mese/giorno e nomi. Verifica una registrazione nota in Registrazioni, poi controlla separatamente lo stato dell’analisi automatica. Non usare chmod 777 e non rimuovere i controlli sui percorsi per far comparire un file.
Quando sposti lo stesso archivio
Sospendi i job audio e attendi la fine delle lavorazioni prima di spostare i file. Salva il nuovo percorso, usa in questo pannello l’anteprima degli arretrati della cartella precedente e conferma il trasferimento solo se è lo stesso archivio. Vengono trasferiti coda di lavoro e storico di scansione: non vengono spostati o cancellati audio. Riattiva dopo la verifica.
| Operazione | Comportamento dei link simbolici |
|---|---|
| Consultare, ascoltare e scaricare | I percorsi vengono risolti rispetto alla radice delle registrazioni. Un link verso un elemento esistente dentro quella radice reale può essere letto, anche se il percorso della radice configurata è un link. Un collegamento che esce dalla radice viene rifiutato. Restano necessari i permessi della pagina e dell’azione. |
| Ricerca automatica degli audio | Il worker risolve la radice, ma rifiuta link simbolici nelle cartelle anno/mese/giorno e salta i file che sono link. Un file ascoltabile, quindi, non è necessariamente individuabile dalla ricerca automatica. |
| Pulizia per categoria di errore | Il cleaner rifiuta una radice configurata che sia essa stessa un link simbolico e salta i link sotto la radice risolta. Sono candidabili solo le categorie di errore selezionate e verificate: la presenza nel catalogo non autorizza la cancellazione. |
| Conservazione audio | La conservazione rifiuta link simbolici nella radice configurata o nelle sue cartelle superiori, salta sottocartelle/file collegati e file con più hard link. Verifica inoltre anzianità, analisi completata e utilizzabile e attività del file. |
Collegare analisi e report periodici
Configura chiave e modello Gemini, rivedi il campionamento e scegli il fuso dei report. Il pannello mostra la pianificazione settimanale e mensile e spiega il trattamento dei dati tardivi. Controlla la lingua in Identità e lingua e destinatari, mittente e SMTP in Email e pulizia.
Verificare il modello
Usa gli strumenti di elenco e prova dei modelli, scegli quello previsto e salva la selezione. Una prova non salva da sola un modello diverso né conferma un’analisi audio completata.
Controllare l’analisi di origine
Esamina lo stato automatico e conferma i risultati delle registrazioni idonee. Per quelle sospese, leggi il motivo e correggilo prima di rimettere in attesa gli elementi selezionati.
Verificare separatamente generazione e consegna
Rivedi lo stato dell’esecuzione pianificata e il log settimanale o mensile pertinente, poi controlla la casella destinataria. Report generato ed email consegnata sono due esiti distinti.
Verificare configurazione ed esecuzione
Esegui il controllo della connessione pertinente e Diagnostica installazione dopo il salvataggio. Rivedi gli stati di esecuzione disponibili, poi prova la funzione effettiva. La presenza della configurazione richiesta non conferma una consegna a Gemini o SMTP né un flusso completo in produzione.
Gestire consapevolmente l’analisi sospesa
Un aggiornamento conserva le registrazioni sospese senza riavviarle silenziosamente. Esamina il motivo nello stato dell’analisi automatica e usa Rimetti in attesa dopo aver corretto la causa. Distingui destinatari dei report e avvisi di sicurezza e conferma la lingua prevista.
Mantieni definizioni cron e SQL sotto il controllo del supporto
Le attività cron e gli eventi SQL servono parti diverse dell’elaborazione. Non modificare pianificazioni distribuite, comandi dei worker, stored procedure o definizioni degli eventi SQL senza un’indicazione precisa del supporto Obelisk. Modificare, eseguire e ripristinare una procedura hanno effetti diversi: nessuna di queste operazioni è un modo generico per aggiornare la pagina.
Consultare componenti e licenze di terze parti
L’applicazione installata include un elenco leggibile di librerie, font, dati geografici e relativi file di licenza originali. Con il percorso standard apri /obelisk/assets/vendor/notices/THIRD_PARTY_NOTICES.txt sul tuo server Obelisk; via SSH lo stesso file si trova in /var/www/html/obelisk/assets/vendor/notices/THIRD_PARTY_NOTICES.txt. Adatta la radice se l’installazione usa un percorso diverso. L’elenco distingue i componenti distribuiti dai servizi esterni di grafici/mappe e dai download facoltativi.
Usa i controlli e comprendi cosa cambia
Usa il pannello numerato per trovare l’impostazione, poi leggi unità e salvataggio dedicato. Le sessioni usano minuti, ore e giorni in campi diversi. Aggiornamento, raccolta storica e intervallo AI sono controlli distinti: cambiarne uno non cambia automaticamente gli altri.
Schermate complete del prodotto
Dati dimostrativi. Apri la schermata per ingrandirla e riconoscere i comandi descritti in questo capitolo.
Apri schermata completa
Leggi la schermata sezione per sezione
Collega i numeri e i pannelli seguenti alla schermata completa. Le immagini usano dati dimostrativi; le procedure precedenti spiegano come lavorare sulla tua installazione.
Connessioni applicative e PBX
Verifica impostazioni del database applicativo, sorgenti FreePBX e connessione Asterisk AMI. Distingui credenziali e indirizzi delle diverse integrazioni.
Percorsi e archiviazione
Individua registrazioni, log e dati applicativi. Controlla percorsi configurati e relativo stato prima di elaborare audio o approfondire una verifica dell’installazione.
Intervalli di aggiornamento e raccolta
Regola aggiornamento live, durata della cache AMI condivisa, raccolta dello storico e intervallo fra richieste AI dal web secondo l’installazione.
Salute delle code
Configura pesi e soglie degli indicatori di salute delle code, in modo che gli avvisi riflettano le condizioni di servizio da osservare.
Tendenze, previsioni e visualizzazione dei report
Regola sensibilità delle tendenze, previsioni di attesa, cache SLA, ore delle matrici e nuvola di parole di Qualità e AI.
Impostazioni Gemini e AI
Scegli impostazioni del provider, modelli e opzioni di analisi per le funzioni AI che attivi. Queste impostazioni supportano anche i report presentati in Qualità e AI.
Elaborazione in background
Controlla stato dei processi audio, registrazioni in attesa di analisi, richieste rifiutate e tentativi. Segui la coda di elaborazione e approfondisci gli elementi da verificare.
Email, conservazione e manutenzione
Configura destinatari dei report e invio SMTP, timeout delle connessioni e scelte di pulizia dell’audio. Imposta le opzioni utilizzate dalle attività pianificate sul server.
Diagnostica installazione
Esegui il controllo dell’installazione e leggi i risultati di connessioni, percorsi e componenti necessari. Apri la guida dedicata per approfondire controlli e anteprime di riparazione dei permessi.
Licenza installata
Consulta il tipo di licenza e, quando prevista, la scadenza. Apri da questo pannello la gestione della licenza per seguire il percorso di attivazione o rinnovo.