Vai al contenuto principale

​
Panoramica

Creare una base di conoscenza è il primo passo per dare al tuo agente AI una conoscenza a livello esperto della tua attività. Questa guida ti accompagna attraverso l’intero processo, dalla creazione della base di conoscenza all’organizzazione del contenuto e al rispetto delle best practice.
Pianifica la struttura della tua conoscenza prima di iniziare. Una base di conoscenza ben organizzata è più facile da mantenere e più efficace per i tuoi agenti.

​
Passo 1: Crea una Base di Conoscenza

  1. Accedi al tuo dashboard itellicoAI
  2. Clicca su Basi di Conoscenza nel menu di navigazione a sinistra
  3. Clicca il pulsante + Crea Base di Conoscenza

​
Compila le Informazioni di Base

Finestra di dialogo Crea Base di Conoscenza con campi nome e descrizione
Finestra di dialogo Crea Base di Conoscenza con campi nome e descrizione
1

Inserisci il Nome della Base di Conoscenza

Scegli un nome chiaro e descrittivo che rifletta la categoria del contenuto.Regole di denominazione:
  • Solo lettere, numeri, spazi, trattini e trattini bassi
  • Nessun carattere speciale (@, #, $, ecc.)
  • Massimo 100 caratteri
Buoni esempi:
  • “FAQ Assistenza Clienti”
  • “Documentazione Prodotto”
  • “Politiche Aziendali”
  • “Risoluzione Problemi Tecnici”
Evita:
  • “KB_001” (non descrittivo)
  • “Vari Documenti” (troppo vago)
  • “Tutto!!!” (poco professionale)
2

Aggiungi Descrizione (Facoltativo)

Fornisci un contesto su cosa contiene questa base di conoscenza e quando usarla.Esempi di descrizioni:
  • “Documentazione di supporto rivolta ai clienti incluse FAQ, politiche e guide di risoluzione problemi”
  • “Specifiche di prodotto interne, documentazione delle funzionalità e dettagli tecnici”
  • “Politiche HR aziendali, documenti di conformità e procedure interne”
3

Clicca Crea

La tua base di conoscenza è ora creata e pronta per il contenuto!

​
Passo 2: Organizza con le Cartelle

Le cartelle organizzano i tuoi elementi di conoscenza in gruppi logici.
Una cartella predefinita viene creata automaticamente quando crei una nuova base di conoscenza. Puoi rinominarla, aggiungere più cartelle o iniziare ad aggiungere elementi subito.

​
Aggiungi Cartelle Aggiuntive (Facoltativo)

  1. Apri la tua base di conoscenza
  2. Clicca il pulsante Crea Cartella
  3. Inserisci un nome per la cartella
  4. Aggiungi una descrizione facoltativa
  5. Clicca Crea

​
Best Practice per la Denominazione delle Cartelle

Chiaro & Specifico

  • “Fatturazione & Pagamenti”
  • “Politiche di Reso”
  • “Specifiche Prodotto”
  • “Problemi Tecnici”

Vago o Generico

  • “Roba”
  • “Cartella 1”
  • “Documenti”
  • “Vari”

​
Quante Cartelle?

3-5 cartelle sono solitamente sufficientiEsempio di struttura:
  • Domande Clienti
  • Politiche Aziendali
  • Informazioni Prodotto
5-10 cartelle forniscono una buona organizzazioneEsempio di struttura:
  • Fatturazione & Pagamenti
  • Supporto Tecnico
  • Funzionalità Prodotto
  • Gestione Account
  • Spedizione & Resi
  • FAQ Generali
10-15 cartelle mantiene le cose gestibiliConsidera di dividere in più basi di conoscenza se superi le 15 cartelle.Esempio di struttura:
  • Configurazione Account
  • Problemi di Fatturazione
  • Metodi di Pagamento
  • Rimborsi & Crediti
  • Categorie Prodotto A-F
  • Categorie Prodotto G-M
  • Categorie Prodotto N-Z
  • Risoluzione Problemi Tecnici
  • Guide di Integrazione
  • Documentazione API
  • Resi & Cambi
  • Opzioni di Spedizione
  • Tracciamento Ordini

​
Passo 3: Aggiungi Elementi di Conoscenza

Gli elementi di conoscenza sono il contenuto effettivo - i documenti, le FAQ, le politiche e le informazioni che vuoi che il tuo agente conosca.
Finestra di dialogo Crea Nuovo Elemento che mostra le opzioni Contenuto Testo, Carica File e Pagina Web
Finestra di dialogo Crea Nuovo Elemento che mostra le opzioni Contenuto Testo, Carica File e Pagina Web
Puoi aggiungere elementi di conoscenza in tre modi diversi. Scegli il metodo che si adatta meglio al tuo contenuto:
Ideale per: FAQ, politiche, procedure, informazioni di riferimento rapidoInserimento diretto del testo usando l’editor integrato. Perfetto per contenuto che stai creando specificamente per la tua base di conoscenza.

​
Come Aggiungere un Elemento di Testo

1

Clicca 'Aggiungi Elemento di Conoscenza'

Nella tua cartella, clicca il pulsante aggiungi per creare un nuovo elemento.
2

Seleziona 'TEXT' come categoria

Scegli testo se stai inserendo contenuto direttamente.
3

Inserisci un titolo descrittivo

Buoni titoli:
  • “Politica di Reso per Prodotti Digitali”
  • “Istruzioni per Reimpostazione Password”
  • “Livelli di Prezzo Spiegati”
Evita:
  • “Doc 1”
  • “Politica”
  • “Info”
4

Scrivi o incolla il tuo contenuto

Inserisci le informazioni che vuoi che il tuo agente conosca. Sii chiaro e completo.Esempio:
Politica di Reso per Prodotti Digitali

I prodotti digitali possono essere rimborsati entro 30 giorni dall'acquisto se:
1. Il prodotto ha un difetto tecnico che impedisce l'utilizzo
2. La descrizione del prodotto era materialmente imprecisa
3. Il cliente non ha acceduto o scaricato il prodotto

I rimborsi non sono disponibili per:
- Cambio di idea dopo aver acceduto al prodotto
- Problemi di compatibilità che erano rivelati nella descrizione del prodotto
- Errore dell'utente o incomprensione delle funzionalità

Per richiedere un rimborso, i clienti dovrebbero inviare un'email a support@company.com
con il loro numero d'ordine e il motivo della richiesta di rimborso.

Tempo di elaborazione: 5-7 giorni lavorativi
5

Clicca 'Crea'

Il tuo elemento di conoscenza è salvato e verrà elaborato immediatamente.
Ideale per: Manuali utente, specifiche prodotto, documenti legali, materiali di formazioneCarica documenti in vari formati fino a 10MB. Il sistema estrae ed elabora il contenuto testuale.Formati supportati: PDF, Word (.doc, .docx), Testo (.txt, .log), Markdown (.md), CSV/TSV, JSON, YAML, XML

​
Come Aggiungere un File

1

Clicca 'Aggiungi Elemento di Conoscenza'

Nella tua cartella, clicca il pulsante aggiungi.
2

Seleziona 'FILE' come categoria

Scegli file per caricamenti di documenti.
3

Inserisci un titolo

Dai al tuo file un titolo descrittivo (il nome del file verrà memorizzato separatamente).
4

Carica il tuo file

Clicca Carica e seleziona il tuo documento.Requisiti:
  • Formati supportati: PDF, Word (.doc, .docx), Testo (.txt, .log), Markdown (.md), CSV/TSV, JSON, YAML, XML
  • Dimensione massima: 10MB
  • Documenti basati su testo e immagini scansionate (il parsing avanzato gestisce la maggior parte delle scansioni)
5

Clicca 'Crea'

Il sistema caricherà e inizierà a elaborare il tuo file. Lo stato cambierà da PENDING → PROCESSING → COMPLETED.
Il tempo di elaborazione dei file varia in base alla dimensione e complessità del file. File grandi (5-10MB) possono richiedere diversi minuti per essere elaborati.
Ideale per: Pagine di documentazione, post di blog, articoli di aiuto, risorse esterneEstrai contenuto da una singola pagina web (non interi siti web).

​
Come Aggiungere un URL

1

Clicca 'Aggiungi Elemento di Conoscenza'

Nella tua cartella, clicca il pulsante aggiungi.
2

Seleziona 'URL' come categoria

Scegli URL per estrarre contenuto web.
3

Inserisci un titolo

Dai al contenuto un titolo descrittivo.
4

Inserisci l'URL di origine

Incolla l’URL completo incluso https://Esempio:
https://docs.company.com/api/authentication
5

Clicca 'Crea'

Il sistema recupererà ed elaborerà il contenuto della pagina web. Lo stato cambierà da PENDING → PROCESSING → COMPLETED.
Lo scraping di URL funziona meglio con pagine web semplici basate su testo. Applicazioni JavaScript complesse o pagine che richiedono autenticazione potrebbero non essere estratte con successo.

​
Comprendere gli Stati di Elaborazione

Dopo aver aggiunto un elemento di conoscenza, questo passa attraverso due pipeline di elaborazione separate. Vedrai entrambi gli stati nell’interfaccia:

​
Stato Elaborazione Contenuto

Questo traccia se il contenuto è stato estratto con successo dalla tua fonte.
Elemento creato e in coda per l’elaborazione. Solitamente richiede solo pochi secondi.
Il contenuto è in elaborazione proprio ora:
  • File: Parsing dei documenti usando i nostri parser di documenti AI avanzati
  • URL: Recupero e scraping della pagina web
  • Testo: Salta questo (va direttamente a COMPLETED)
Contenuto estratto e memorizzato con successo. L’indicizzazione vettoriale inizierà automaticamente.
L’estrazione del contenuto è fallita. Cause comuni:
  • Il file è corrotto o protetto da password
  • L’URL richiede autenticazione o usa JavaScript complesso
  • Il file supera il limite di 10MB
Soluzioni rapide:
  • Prova a caricare il contenuto come TEXT invece
  • Rimuovi la protezione con password dal file
  • Dividi file grandi in documenti più piccoli
Hai bisogno di aiuto?Se il problema persiste, contatta il nostro team di supporto a support@itellico.ai con:
  • Il titolo dell’elemento di conoscenza
  • Il tipo di file o URL che stai cercando di aggiungere
  • Qualsiasi messaggio di errore mostrato

​
Stato Indicizzazione Vettoriale

Dopo che il contenuto è estratto, deve essere indicizzato per RAG (Generazione Aumentata da Recupero). Questo permette al tuo agente di trovare conoscenza rilevante basata sul significato.
In attesa che inizi l’indicizzazione vettoriale. Elaborazione del contenuto completata con successo.
Creazione di embedding vettoriali per RAG:
  • Il contenuto viene diviso in blocchi
  • Vengono generati embedding AI
  • I vettori vengono memorizzati nel database
Questo può richiedere diversi minuti per documenti grandi.
L’elemento è completamente pronto! L’agente può ora trovare e usare questa conoscenza tramite ricerca semantica.
L’indicizzazione vettoriale è fallita. Il contenuto è estratto ma non apparirà nei risultati di ricerca RAG.Soluzioni rapide:
  • Clicca il pulsante Reindicizza sull’elemento di conoscenza per riprovare l’indicizzazione
  • Se la reindicizzazione fallisce, prova a eliminare e ricreare l’elemento
  • Assicurati che il contenuto non sia troppo breve (necessita almeno di alcune frasi)
Hai bisogno di aiuto?Se la reindicizzazione non funziona, contatta il nostro team di supporto a support@itellico.ai con:
  • Il titolo dell’elemento di conoscenza
  • Quando hai creato l’elemento
  • Tipo di contenuto (TEXT, FILE o URL)
Entrambi gli stati devono avere successo per la piena funzionalità:
  • Stato Contenuto: COMPLETED
  • Stato Vettoriale: INDEXED
Solo allora il tuo agente può usare la conoscenza nelle conversazioni.

​
Linee Guida per la Qualità del Contenuto

​
Scrivi Contenuto Chiaro e Completo

Non dare per scontata la conoscenza. Spiega chiaramente.Invece di: “I clienti possono restituire gli articoli entro la nostra finestra standard.”Scrivi: “I clienti possono restituire gli articoli entro 30 giorni dall’acquisto. Gli articoli devono essere non utilizzati e nella confezione originale con tutte le etichette attaccate.”
Evita il gergo a meno che non sia standard del settore e il tuo pubblico lo conosca.Invece di: “Utilizza l’endpoint di autenticazione per generare un token bearer.”Scrivi: “Per autenticarti, chiama l’endpoint /auth. Riceverai un token di accesso da includere nelle richieste successive.”
Gli esempi rendono concreti i concetti astratti.Esempio: “I nostri livelli di prezzo includono:
  • Basic: 29€/mese - Fino a 1.000 contatti
  • Pro: 99€/mese - Fino a 10.000 contatti
  • Enterprise: Prezzi personalizzati - Contatti illimitati”
Usa intestazioni e punti elenco per contenuto scansionabile.Buona struttura:
Politica di Reso

Articoli Idonei:
- Prodotti non aperti nella confezione originale
- Articoli acquistati entro 30 giorni
- Prodotti senza segni di utilizzo

Articoli Non Idonei:
- Download digitali
- Prodotti personalizzati
- Articoli in saldo contrassegnati come vendita finale

Processo:
1. Invia email a support@company.com
2. Fornisci numero d'ordine
3. Ricevi autorizzazione al reso
4. Spedisci l'articolo entro 7 giorni
Ogni elemento dovrebbe coprire un argomento in modo approfondito. Dividi argomenti grandi in più elementi.Invece di: Un “Manuale Aziendale Completo” di 20 pagineCrea:
  • Politica di Reso
  • Opzioni di Spedizione
  • Metodi di Pagamento
  • Garanzia Prodotto
  • Politica sulla Privacy
  • Informazioni di Contatto

​
Collega la Base di Conoscenza agli Agenti

Una volta che la tua base di conoscenza ha contenuto, dovrai collegarla ai tuoi agenti in modo che possano accedere alle informazioni.

Assegna Conoscenza agli Agenti

Scopri come collegare la tua base di conoscenza agli agenti e scegliere il metodo di accesso giusto (Context vs RAG).

​
Prossimi Passi

Assegna agli Agenti

Collega la tua base di conoscenza agli agenti

Context vs RAG

Scegli come i tuoi agenti accedono alla conoscenza

Best Practice Architettura

Scopri come strutturare e organizzare le basi di conoscenza