Trupeer Blog

Struttura della Knowledge Base IT: Come organizzare una Knowledge Base per il Service Desk

Struttura della Knowledge Base IT: Come organizzare una Knowledge Base per il Service Desk

Riassumi

Indice

Crea video e documentazione di prodotto straordinari con l’IA

Inizia gratis

Una knowledge base per il service desk è utile solo se le persone riescono a trovare l'articolo giusto in pochi secondi, sia che si tratti di un dipendente che cerca di risolvere un problema in autonomia, sia di un operatore alle prese con un ticket aperto. La maggior parte delle knowledge base per help desk fallisce nella struttura, non nei contenuti: gli articoli sono archiviati per team, intitolati con gergo IT, redatti in formati diversi e mai revisionati. Questa guida mostra come strutturare una knowledge base IT, quali categorie e tipologie di articoli utilizzare, un modello di articolo pronto all'uso e come mantenerla sempre aggiornata.

Che cos'è una knowledge base IT?

Una knowledge base IT, detta anche knowledge base per help desk o service desk, è una raccolta consultabile di articoli che aiutano i dipendenti e gli operatori del service desk a risolvere problemi tecnologici e a completare richieste, come reimpostare una password, connettersi alla VPN o richiedere software. Di solito si articola in due sezioni: un portale self-service per i dipendenti e un'area interna riservata agli operatori. Se ne stai creando una da zero, la nostra guida alle knowledge base interne ne illustra i concetti fondamentali.

Come strutturare una knowledge base IT

1. Separa innanzitutto i destinatari

Dividi i contenuti tra articoli per utenti finali, che i dipendenti possono seguire in autonomia, e articoli interni per gli operatori, che contengono procedure di diagnostica, strumenti di amministrazione e dettagli per l'escalation. Mescolarli confonde i dipendenti ed espone informazioni che non dovrebbero visualizzare.

2. Scegli da cinque a otto categorie di primo livello

Assegna alle categorie nomi basati sulle esigenze di supporto degli utenti, idealmente allineati al tuo catalogo dei servizi. Troppe categorie di primo livello rendono la navigazione più complessa; se una categoria diventa troppo ampia, aggiungi delle sottocategorie.

Esempio di categoria

Articoli tipici

Account e accessi

Reimpostazione password, MFA, richieste di accesso

Email e calendario

Configurazione di Outlook, cassette postali condivise, sincronizzazione calendario

Rete e VPN

Connessione VPN, Wi-Fi, accesso remoto

Dispositivi e hardware

Laptop, stampanti, periferiche, dispositivi mobili

Software e applicazioni

Installazione e utilizzo di app aziendali approvate

Sicurezza

Segnalazione phishing, crittografia dei dispositivi, gestione dei dati

Nuovi assunti e uscite

Configurazione per l'onboarding, procedure di offboarding

Richieste e policy

Come richiedere attrezzature, policy IT

3. Standardizza le tipologie di articolo

  • Guida pratica (How-to): istruzioni dettagliate per svolgere un'attività

  • Risoluzione dei problemi (Troubleshooting): sintomi, cause e soluzioni per un problema comune

  • Errore noto: un problema documentato con una soluzione alternativa temporanea (workaround) in attesa di una correzione definitiva

  • FAQ: risposte brevi alle domande più frequenti

  • Policy o materiale di riferimento: regole, standard e dettagli di contatto

  • Guida all'escalation (interna): cosa verificare e cosa includere prima di procedere con l'escalation

4. Utilizza i tag per sistemi e dispositivi

Le categorie rispondono alla domanda "che tipo di problema è questo?". I tag rispondono a "quale sistema, dispositivo o sede?", ad esempio Windows, macOS, Salesforce o sede di Londra. I tag consentono a un articolo di comparire in diverse visualizzazioni filtrate senza doverlo duplicare.

5. Scrivi i titoli nello stesso modo in cui gli utenti cercano

Usa le parole che i dipendenti digitano nella casella di ricerca, come "Impossibile connettersi alla VPN" o "Come reimpostare la password", anziché nomi di sistemi interni o codici dei ticket. Inizia i titoli delle guide pratiche con "Come" e quelli di risoluzione dei problemi con il sintomo.

Modello di articolo per la knowledge base IT

Ogni articolo dovrebbe seguire la stessa struttura in modo che le persone sappiano dove cercare:

Sezione

Cosa includere

Titolo

L'attività o il sintomo espresso con le parole dell'utente

Metadati

Categoria, tag, sistema interessato, destinatari, proprietario, stato e data di revisione

Riepilogo

Una o due frasi su ciò che l'articolo risolve

Sintomi o quando utilizzarlo

Come l'utente capisce che questo è l'articolo giusto

Passaggi

Passaggi numerati con uno screenshot per ciascuno

Verifica

Come verificare che la procedura sia andata a buon fine

Se non ha funzionato

Cosa provare successivamente o come aprire un ticket

Articoli correlati

Link alla domanda successiva più probabile

Per formati già pronti all'uso, consulta i modelli di articoli per knowledge base o il modello di knowledge base per pianificare l'intera struttura.

Esempio: un articolo di risoluzione dei problemi ben strutturato

Titolo: Impossibile connettersi alla VPN su Windows

Metadati: Categoria: Rete e VPN · Tag: Windows, client VPN · Destinatari: Tutti i dipendenti · Proprietario: Team di rete · Revisione: ogni 6 mesi

Riepilogo: Risolve i motivi più comuni per cui il client VPN non riesce a connettersi sui laptop aziendali.

Sintomi: Il client VPN mostra "Connessione non riuscita" o continua a tentare la connessione.

  1. Verifica di essere connesso a Internet aprendo un sito web qualsiasi.

  2. Riavvia il client VPN dalla barra delle applicazioni.

  3. Esci dal client VPN e accedi nuovamente con il tuo account aziendale.

  4. Se hai modificato la password di recente, riavvia il laptop in modo che la nuova password venga sincronizzata.

  5. Connettiti di nuovo e controlla se i siti interni si aprono.

Se non ha funzionato: Apri un ticket nella categoria Rete e VPN includendo uno screenshot del messaggio di errore.

Correlati: Come configurare l'autenticazione a più fattori (MFA) · Come connettersi al Wi-Fi dell'ufficio

Mantieni aggiornata la knowledge base con il Knowledge-Centered Service

Il Knowledge-Centered Service (KCS) è un metodo ampiamente utilizzato in cui gli operatori creano o aggiornano gli articoli durante la risoluzione dei ticket, invece di redigere la documentazione come progetto a sé stante. In pratica:

  • Cerca nella knowledge base all'inizio di ogni ticket

  • Se esiste un articolo, utilizzalo e miglioralo se contiene errori o imprecisioni

  • In caso contrario, documenta la soluzione creando una nuova bozza di articolo mentre le informazioni sono ancora fresche

  • Revisiona le bozze e pubblica quelle che risolvono problemi ricorrenti

Combina questa procedura con una revisione mensile delle ricerche senza risultati, che evidenziano gli articoli mancanti, e degli articoli obsoleti, che indicano i contenuti da verificare.

Rendi la tua knowledge base facilmente utilizzabile dagli assistenti IA

Sempre più service desk integrano un assistente basato su intelligenza artificiale a monte della knowledge base, nel portale, su Slack o su Microsoft Teams. La stessa struttura che aiuta le persone consente all'IA di individuare la risposta corretta:

  • Un solo problema per articolo, con titolo e riepilogo chiari

  • Passaggi numerati in formato testo, non solo all'interno di screenshot o video

  • Metadati coerenti, in modo che l'assistente possa filtrare per sistema, destinatari e stato

  • Autorizzazioni ben definite, affinché gli articoli interni non vengano utilizzati per rispondere ai dipendenti

  • Eliminazione degli articoli obsoleti, evitando che l'assistente ripeta soluzioni superate

Le knowledge base di Trupeer possono essere collegate anche ad assistenti IA come Claude e ChatGPT tramite il server MCP di Trupeer, consentendo loro di cercare tra articoli e video quando generano le risposte.

Come creare articoli per la knowledge base IT più velocemente con Trupeer

Scrivere articoli dettagliati completi di screenshot è la fase più lenta nella creazione di una knowledge base per il service desk. Trupeer trasforma la registrazione della procedura di risoluzione direttamente in un articolo. Scopri il generatore di documentazione IT.

1. Registra la soluzione

Recording an IT fix with the Trupeer Chrome extension

Registra una scheda del browser, una finestra o l'intero schermo con l'estensione Chrome di Trupeer mentre esegui la risoluzione del problema.

2. Genera l'articolo e il video

Generating a step-by-step IT knowledge base article from a recording in Trupeer

Fai clic su Genera contenuti IA per ottenere un articolo dettagliato con uno screenshot per ogni passaggio e un breve video. Utilizza Doc Skills per applicare il tuo modello di articolo ogni volta e sfoca password o dati personali.

3. Traduci per i team globali

Translating IT knowledge base articles in Trupeer

Traduci articoli e video per i dipendenti presenti in altre aree geografiche.

4. Pubblica impostando le giuste autorizzazioni di accesso

Publishing IT articles to a Trupeer knowledge base with access settings

Pubblica all'interno di una knowledge base di Trupeer organizzata con sezioni per ciascuna categoria e con l'accesso impostato su Organizzazione, Dominio selezionato o Solo su invito, così che gli articoli riservati agli operatori rimangano interni. I dipendenti possono effettuare ricerche con Ask AI, mentre i dati analitici mostrano visualizzazioni, ricerche senza risposta e contenuti obsoleti. Puoi anche esportare gli articoli in DOC, PDF o Markdown per il tuo strumento ITSM.

Errori comuni nelle knowledge base IT

  • Organizzare i contenuti per team IT anziché in base alle esigenze degli utenti

  • Mescolare i contenuti per i dipendenti con quelli per gli operatori

  • Utilizzo di formati diversi da parte di ciascun autore

  • Titoli pieni di gergo tecnico o riferimenti a codici di ticket

  • Assenza di un proprietario o di una data di revisione, con conseguente obsolescenza non rilevata degli articoli

  • Articoli duplicati per lo stesso problema

Stai scegliendo una piattaforma? Confronta il modo in cui ServiceNow, Freshservice e Atomicwork gestiscono la knowledge base nel nostro confronto della documentazione ITSM e verifica il livello di copertura con l'analisi dei gap della documentazione ITIL.

Considerazioni finali

La struttura di una buona knowledge base IT è semplice: segmentazione dei destinatari, poche categorie incentrate sull'utente, tipologie di articoli coerenti e un unico modello, accompagnati da tag per i sistemi e un proprietario chiaramente assegnato per ciascun articolo. Mantienila aggiornata modificando gli articoli man mano che i ticket vengono risolti e sfrutta i dati delle ricerche per colmare eventuali lacune.

Domande frequenti

Come si organizza una knowledge base?

Separa i segmenti di pubblico, crea da cinque a otto categorie di primo livello in base alle esigenze degli utenti, standardizza le tipologie di articoli, usa i tag per sistemi e dispositivi e applica a ogni articolo lo stesso modello dotato di un responsabile e di una data di revisione.

Come si struttura una knowledge base interna per un team?

Raggruppa i contenuti in base alle attività svolte dal tuo team, mantieni un modello di articolo coerente, assegna i proprietari e collega gli articoli correlati in modo che le persone possano passare facilmente da una risposta all'altra.

Come si crea una knowledge base IT?

Inizia con i ticket più comuni, scegli le categorie e i tipi di articolo, scrivi gli articoli partendo da un modello condiviso con screenshot, pubblicali in un portale ricercabile e aggiornali man mano che i ticket vengono risolti.

Come documenti gli articoli della knowledge base IT?

Utilizza un modello coerente: un titolo espresso con le parole dell'utente, metadati, un riepilogo, sintomi, passaggi numerati con schermate, verifica, passaggi successivi e articoli correlati.

Quali categorie dovrebbe avere una knowledge base IT?

Le categorie comuni sono account e accesso, e-mail e calendario, rete e VPN, dispositivi, software, sicurezza, nuovi assunti e uscenti, e richieste e policy.

Cos'è il Knowledge-Centered Service (KCS)?

Il KCS è un metodo in cui gli operatori del service desk creano e migliorano gli articoli della knowledge base come parte della risoluzione dei ticket, consentendo così alla base di conoscenza di svilupparsi a partire da problemi reali.

Si scrive “knowledgebase” o “knowledge base”?

Entrambi sono usati, ma “knowledge base” come due parole separate è l'ortografia più comune nella documentazione e nei nomi dei prodotti.

In che modo Trupeer aiuta a creare una knowledge base IT?

Trupeer trasforma la registrazione di una risoluzione in un articolo passo-passo con screenshot e un breve video, pubblicandolo in una knowledge base ricercabile con controlli degli accessi e analisi.

Hai bisogno di un video editor, di un traduttore e di uno sceneggiatore?

Prova Trupeer gratuitamente

Prenota una demo

Hai bisogno di un video editor, di un traduttore e di uno sceneggiatore?

Prova Trupeer gratuitamente

Prenota una demo

Hai bisogno di un video editor, di un traduttore e di uno sceneggiatore?

Prova Trupeer gratuitamente

Prenota una demo