Creare Knowledge Base

Tempo Stimato

⏱️ 5-15 minuti per completare questa sezione

🎯 Obiettivo

Impara a creare e configurare Knowledge Base efficaci per organizzare i tuoi documenti e ottimizzare le risposte dell'AI. Al termine saprai pianificare, creare e configurare Knowledge Base professionali per diverse esigenze aziendali.

🧠 Cos'è una Knowledge Base

Una Knowledge Base (KB) in Emblema è un contenitore intelligente che:

• 📚 Organizza documenti correlati in gruppi logici
• 🔍 Abilita ricerca semantica basata sul contenuto, non solo sui nomi
• 🤖 Fornisce contesto all'AI per risposte più precise e pertinenti
• 👥 Gestisce permessi per controllo accessi granulare
• 📊 Traccia statistiche d'uso e performance

[Screenshot placeholder: Vista panoramica di una Knowledge Base con sezioni principali]

Differenza con le Cartelle Tradizionali

Cartelle Tradizionali	Knowledge Base Emblema
Organizzazione per nome/data	Organizzazione semantica per contenuto
Ricerca per nome file	Ricerca per significato e contesto
Accesso tutto-o-niente	Permessi granulari per utente
Nessuna elaborazione	Chunking e embedding automatici
Metadati limitati	Analytics completi su utilizzo

🎯 Pianificare la Knowledge Base

Identificare lo Scopo

Prima di creare una KB, definisci chiaramente:

🎯 Obiettivo Principale:

• Supporto clienti con FAQ e manuali?
• Ricerca interna su progetti aziendali?
• Archivio normativo e compliance?
• Base dati tecnica per sviluppatori?

👥 Utenti Target:

• Chi userà principalmente questa KB?
• Che livello di competenza tecnica hanno?
• Quali tipi di domande faranno?

📄 Tipi di Contenuto:

• Prevalentemente testo o multimedia?
• Documenti formali o conversazionali?
• Contenuto statico o aggiornato frequentemente?

Esempi di Knowledge Base Efficaci

🏢 KB Aziendale - "Policies & Procedures"

• Regolamenti interni, policy HR, procedure operative
• Utenti: Tutti i dipendenti
• Configurazione: Preset "Default", permessi di sola lettura

🔧 KB Tecnica - "Documentazione Prodotto"

• Manuali tecnici, specifiche, troubleshooting
• Utenti: Team tecnico, supporto clienti
• Configurazione: Preset "Technical", chunking granulare

📞 KB Supporto - "Customer Service"

• FAQ, casi comuni, script di supporto
• Utenti: Team customer service
• Configurazione: Preset "Q&A", chunking preciso

🎓 KB Training - "Materiali Formativi"

• Corsi, tutorial, video training
• Utenti: Nuovi dipendenti, formatori
• Configurazione: Preset "Meeting" per video, "Default" per documenti

🚀 Creare una Nuova Knowledge Base

Passo 1: Accesso alla Sezione

1. Dalla dashboard principale, clicca su "Basi di Conoscenza"
2. Visualizza l'elenco delle KB esistenti (se presenti)
3. Clicca su "Aggiungi" per creare una nuova Knowledge Base

[Screenshot placeholder: Elenco Knowledge Base con pulsante Aggiungi evidenziato]

Passo 2: Configurazione Base

Compila i campi essenziali nel form di creazione:

📝 Nome Knowledge Base

• Usa nomi descrittivi e professionali
• Includi il reparto o progetto se necessario
• Esempi: "Manuali Tecnici 2024", "Policies HR", "Progetto Alpha Docs"

📄 Descrizione

• Spiega brevemente lo scopo e il contenuto
• Menziona gli utenti target
• Indica il tipo di documenti contenuti

[Screenshot placeholder: Form di creazione Knowledge Base con campi compilati]

Esempio di descrizione efficace:
"Raccolta completa della documentazione tecnica del Progetto Alpha,
inclusi specifiche architetturali, API reference e guide di deploy.
Destinata al team di sviluppo e DevOps per supporto quotidiano e onboarding."

Passo 3: Configurazione Avanzata

Dopo la creazione base, configura le impostazioni avanzate:

⚙️ Configurazione Chunking

Accedi alla sezione "Configurazione" della KB per personalizzare:

• Strategia predefinita: Scelta del preset ottimale per i tuoi contenuti
• Dimensioni chunk: Ottimizzazione per tipologia documenti
• Modello embedding: BGE-M3 multilingue (raccomandato)
• Lingua trascrizioni: Per file audio/video (it, en, fr, de, es)

[Screenshot placeholder: Schermata configurazione avanzata chunking]

Raccomandazioni per Tipologia:

Tipo Contenuto	Preset Consigliato	Dimensione Chunk	Note
Documentazione Tecnica	Technical	600 token	Per manuali complessi
FAQ e Supporto	Q&A	200 token	Per risposte precise
Presentazioni	Executive	300 token	Per contenuti densi
Registrazioni Meeting	Meeting	400 token	Con diarizzazione
Documenti Misti	Default	512 token	Bilanciato per tutti i tipi

👥 Gestione Permessi e Accessi

Controllo Accessi Granulare

Emblema offre un sistema di permessi flessibile:

📖 Permessi di Lettura (Read):

• Visualizzare documenti e contenuti
• Eseguire ricerche e chat
• Accedere alle statistiche base

✏️ Permessi di Scrittura (Update):

• Caricare nuovi documenti
• Modificare chunk e contenuti
• Gestire configurazioni KB

🗑️ Permessi di Cancellazione (Delete):

• Rimuovere documenti
• Eliminare chunk
• Gestire archivio KB

➕ Permessi di Creazione (Create):

• Aggiungere nuove sezioni
• Creare sotto-Knowledge Base
• Generare artefatti

Configurare Team di Lavoro

1. Accedi alla sezione "Utenti autorizzati" della tua KB
2. Clicca "Aggiungi permesso" per invitare nuovi utenti
3. Inserisci email utente o seleziona da lista esistenti
4. Seleziona permessi specifici da assegnare
5. Salva configurazione e invia notifica (opzionale)

[Screenshot placeholder: Interfaccia gestione permessi con utenti e ruoli]

Modelli di Permessi Comuni:

🔒 Modello "Read-Only Team":

• Utenti: Tutto il team
• Permessi: Solo lettura
• Uso: Consultazione documenti aziendali

👥 Modello "Collaborative Team":

• Utenti: Team di progetto
• Permessi: Lettura + Scrittura
• Uso: Lavoro collaborativo su documenti

🛡️ Modello "Admin-Controlled":

• Admin: Tutti i permessi
• Utenti: Solo lettura
• Uso: Contenuti sensibili o normativi

📊 Monitoraggio e Analytics

Dashboard Knowledge Base

Ogni KB include una dashboard con metriche chiave:

📈 Statistiche Utilizzo:

• Numero di ricerche giornaliere/settimanali
• Documenti più consultati
• Query più frequenti
• Utenti più attivi

📚 Statistiche Contenuto:

• Numero totale documenti
• Distribuzione per tipo file
• Stato elaborazione documenti
• Chunk totali generati

[Screenshot placeholder: Dashboard analytics con grafici e metriche]

Ottimizzazione Performance

Monitora queste metriche per ottimizzare la KB:

🚀 Velocità Ricerca:

• Tempo medio risposta query
• Efficacia risultati (click-through rate)
• Soddisfazione utenti (se abilitato feedback)

🎯 Qualità Risultati:

• Percentuale query con risultati utili
• Frequenza ri-formulazione domande
• Documenti mai referenziati (possibili candidati per rimozione)

🔄 Manutenzione e Aggiornamenti

Ciclo di Vita della Knowledge Base

📅 Manutenzione Regolare (Settimanale):

• Verifica nuovi documenti da aggiungere
• Controlla link rotti o contenuti obsoleti
• Review permessi utenti

🔍 Revisione Contenuti (Mensile):

• Analizza documenti meno utilizzati
• Identifica gap informativi dai query log
• Ottimizza configurazioni chunking se necessario

📊 Audit Completo (Trimestrale):

• Review completa permessi e accessi
• Valutazione performance vs obiettivi
• Pianificazione evoluzioni future

Aggiornamento Contenuti

🔄 Rielaborazione Documenti:

• Quando modifichi significativamente un documento
• Per applicare nuove configurazioni chunking
• Dopo update del sistema di embedding

📝 Gestione Versioni:

• Emblema mantiene storico modifiche chunk
• Puoi ripristinare versioni precedenti se necessario
• Le modifiche sono tracciate per audit

✅ Riepilogo

Hai imparato a:

• ✓ Pianificare Knowledge Base efficaci per diversi casi d'uso
• ✓ Creare e configurare KB con impostazioni ottimali
• ✓ Gestire permessi e team di lavoro
• ✓ Configurare chunking avanzato per diversi tipi di contenuto
• ✓ Monitorare performance e ottimizzare nel tempo
• ✓ Implementare cicli di manutenzione strutturati

🎓 Prossimi Passi

Approfondisci la gestione Knowledge Base:

• Gestire Contenuti: Organizzazione avanzata e workflow
• Condividere KB: Collaborazione e integrazione team
• Chunking Documenti: Ottimizzazione elaborazione
• Chat con Knowledge Base: Sfruttare al meglio l'AI

❓ Domande Frequenti

Q: Quante Knowledge Base posso creare? A: Non ci sono limiti tecnici. Tuttavia, è meglio avere poche KB ben organizzate piuttosto che molte KB sparse.

Q: Posso spostare documenti tra Knowledge Base? A: Attualmente non direttamente. Devi scaricare e ricaricare i documenti nella KB di destinazione.

Q: Come backup di una Knowledge Base? A: Usa la funzione "Esporta tutto" per salvare documenti e configurazioni. Il backup completo include metadati e chunk.

Q: Posso duplicare una Knowledge Base? A: Non esiste una funzione diretta di duplicazione. Crea una nuova KB e ricarica i documenti con le stesse configurazioni.

Q: Le modifiche ai chunk si applicano retroattivamente? A: No, le modifiche ai chunk sono immediate. Usa la funzione "Rielabora" per applicare nuove configurazioni ai documenti esistenti.

🆘 Risoluzione Problemi

🔧 KB non si carica correttamente:

• Verifica permessi di accesso
• Controlla stato servizi nella dashboard
• Prova refresh della pagina

📊 Statistiche non aggiornate:

• Le metriche si aggiornano ogni 15 minuti
• Verifica che ci sia stata attività recente
• Controlla filtri data applicati

👥 Utenti non ricevono permessi:

• Verifica email corretta dell'utente
• Controlla che l'utente sia registrato nel sistema
• Verifica permessi di gestione utenti

🔍 Ricerca non funziona bene:

• Controlla che i documenti siano completamente elaborati
• Verifica configurazione chunking appropriata
• Considera re-elaborazione con parametri diversi