Skip to main content

​
Panoramica

itellicoAI supporta tre tipi di elementi di conoscenza, ciascuno progettato per diverse fonti di contenuto e casi d’uso. Comprendere come funziona ogni tipo e come vengono elaborati ti aiuterà a scegliere il formato giusto per le tue informazioni.

​
Panoramica dei Tipi di Contenuto

Elementi di Testo

Inserimento diretto del contenuto usando l’editor integrato

Caricamenti di File

Carica PDF, DOC, DOCX, TXT e altri formati di documenti fino a 10MB

Scraping di URL

Estrai contenuto da pagine web

​
Elementi di Testo

​
Cosa Sono gli Elementi di Testo?

Gli elementi di testo sono contenuti che inserisci direttamente nell’editor della base di conoscenza di itellicoAI. Sono il tipo di contenuto più diretto e affidabile.

​
Quando Usare gli Elementi di Testo

Crea coppie domanda-risposta direttamente nel sistema.Esempio:
Titolo: Come posso reimpostare la mia password?

Contenuto:
Per reimpostare la tua password:

1. Vai alla pagina di accesso
2. Clicca "Password Dimenticata"
3. Inserisci il tuo indirizzo email
4. Controlla la tua email per un link di reimpostazione
5. Clicca il link e crea una nuova password

Requisiti della password:
- Minimo 8 caratteri
- Almeno una lettera maiuscola
- Almeno un numero
- Almeno un carattere speciale

Se non ricevi l'email entro 5 minuti, controlla la cartella spam
o contatta support@company.com.
Scrivi dichiarazioni di politica chiare e concise.Esempio:
Titolo: Politica di Reso - Prodotti Digitali

Contenuto:
I prodotti digitali possono essere rimborsati entro 30 giorni dall'acquisto se:

Idoneo per rimborso:
- Il prodotto ha un difetto tecnico che impedisce l'utilizzo
- La descrizione del prodotto era materialmente imprecisa
- Il cliente non ha acceduto o scaricato il prodotto

Non idoneo per rimborso:
- Cambio di idea dopo aver acceduto al prodotto
- Problemi di compatibilità rivelati nella descrizione del prodotto
- Errore dell'utente o incomprensione delle funzionalità

Per richiedere un rimborso:
Invia un'email a support@company.com con il tuo numero d'ordine e il motivo
della richiesta di rimborso.

Tempo di elaborazione: 5-7 giorni lavorativi
Metodo di rimborso: Metodo di pagamento originale
Istruzioni passo-passo per i processi.Esempio:
Titolo: Processo di Modifica Ordine

Contenuto:
I clienti possono modificare gli ordini entro 24 ore dal loro posizionamento.

Cosa può essere modificato:
- Indirizzo di spedizione
- Velocità di consegna
- Quantità degli articoli (se l'inventario è disponibile)

Cosa non può essere modificato:
- Metodo di pagamento (deve annullare e riordinare)
- Articoli dopo l'inizio dell'elaborazione
- Ordini effettuati più di 24 ore fa

Processo di modifica:
1. Il cliente contatta il supporto via telefono o email
2. L'agente verifica che l'ordine sia nella finestra di modifica
3. L'agente controlla l'inventario per le modifiche richieste
4. L'agente aggiorna l'ordine nel sistema
5. Il cliente riceve un'email di conferma

Se l'ordine è già stato spedito, il cliente deve usare il processo di reso.
Informazioni brevi, a cui si fa riferimento frequentemente.Esempio:
Titolo: Orari di Apertura & Informazioni di Contatto

Contenuto:
Assistenza Clienti:
- Telefono: 1-800-555-0123
- Email: support@company.com
- Orari: Lunedì-Venerdì, 9:00 - 18:00 CET
- Fuori orario: emergency@company.com (solo problemi urgenti)

Vendite:
- Telefono: 1-800-555-0124
- Email: sales@company.com
- Orari: Lunedì-Venerdì, 8:00 - 20:00 CET

Fatturazione:
- Telefono: 1-800-555-0125
- Email: billing@company.com
- Orari: Lunedì-Venerdì, 9:00 - 17:00 CET

​
Creare Elementi di Testo

1

Naviga alla cartella

Apri la cartella in cui vuoi aggiungere l’elemento.
2

Clicca 'Aggiungi Elemento di Conoscenza'

Clicca il pulsante per creare un nuovo elemento.
3

Seleziona la categoria 'TEXT'

Scegli TEXT dalle opzioni del tipo di contenuto.
4

Inserisci il titolo

Dai al tuo elemento un titolo chiaro e descrittivo.
5

Scrivi il contenuto

Inserisci il tuo contenuto nell’editor. Usa la formattazione per chiarezza:
  • Intestazioni per le sezioni
  • Elenchi puntati per le liste
  • Numeri per i passaggi
  • Grassetto per enfasi
6

Clicca 'Crea'

Salva il tuo elemento di testo. Lo stato mostrerà immediatamente COMPLETATO.

​
Esempio JSON di Elemento di Testo

{
  "category": "TEXT",
  "title": "Informazioni sui Prezzi del Prodotto",
  "content": "I nostri livelli di prezzo includono Basic (29€/mese), Pro (99€/mese) e Enterprise (prezzi personalizzati).",
  "status": "COMPLETED"
}

​
Vantaggi degli Elementi di Testo

Elaborazione Istantanea

Gli elementi di testo sono immediatamente disponibili - nessun ritardo di elaborazione

Controllo Completo

Controllo completo sulla formattazione e la struttura del contenuto

Aggiornamenti Facili

Veloci da modificare e aggiornare quando cambiano le informazioni

Affidabile

Nessun errore di elaborazione o problemi di estrazione
Gli elementi di testo sono il tipo di contenuto più affidabile. Quando possibile, inserisci il contenuto come testo piuttosto che caricare file.

​
Elementi di Caricamento File

​
Cosa Sono gli Elementi di Caricamento File?

Gli elementi di caricamento file ti permettono di caricare documenti esistenti in vari formati. Il sistema estrae il contenuto testuale e lo rende disponibile ai tuoi agenti.

​
Quando Usare i Caricamenti di File

Hai già contenuto in formato documento.Esempi:
  • Manuali utente
  • Specifiche di prodotto
  • Documenti legali
  • Materiali di formazione
Documenti con layout specifici che sono più facili da mantenere come file.Esempi:
  • Diagrammi tecnici
  • Tabelle e grafici
  • Layout multi-colonna
  • Template brandizzati
Documentazione che ricevi da fornitori o partner.Esempi:
  • Cataloghi fornitori
  • Documenti di conformità
  • Materiali di certificazione

​
Requisiti dei File

Specifiche dei file:
  • Formati: PDF, DOC, DOCX, TXT e altri formati di documenti
  • Limite di dimensione: Massimo 10MB
  • Contenuto: Documenti basati su testo e immagini scansionate (il parsing avanzato gestisce la maggior parte delle scansioni)
  • Protezione: Nessuna protezione con password
Il sistema utilizza il parsing avanzato dei documenti per estrarre testo da immagini scansionate e PDF. La maggior parte dei documenti scansionati verrà elaborata correttamente, anche se scansioni di qualità molto scarsa potrebbero richiedere l’inserimento manuale del testo.

​
Creare Elementi di File

1

Naviga alla cartella

Apri la cartella in cui vuoi aggiungere il file.
2

Clicca 'Aggiungi Elemento di Conoscenza'

Clicca il pulsante per creare un nuovo elemento.
3

Seleziona la categoria 'FILE'

Scegli FILE dalle opzioni del tipo di contenuto.
4

Inserisci il titolo

Dai al tuo file un titolo descrittivo (separato dal nome del file).
5

Carica il file

Clicca Carica e seleziona il tuo documento dal tuo computer.
6

Clicca 'Crea'

Il sistema caricherà e inizierà a elaborare il tuo file.Progressione dello stato:
  • PENDING → File caricato, in coda per l’elaborazione
  • PROCESSING → Estrazione del contenuto testuale
  • COMPLETED → Pronto per l’uso
  • FAILED → Si è verificato un errore di elaborazione

​
Esempio JSON di Elemento File

{
  "category": "FILE",
  "title": "Manuale Utente - Prodotto X",
  "file": "/uploads/knowledge/manuale-utente-prodotto-x.pdf",
  "status": "COMPLETED"
}

​
Tempo di Elaborazione

Il tempo di elaborazione dei file varia in base a:
  • Dimensione del file: File più grandi richiedono più tempo
  • Numero di pagine: Più pagine = elaborazione più lunga
  • Complessità: Tabelle, immagini e layout complessi rallentano l’elaborazione
  • Qualità del testo: Testo pulito e semplice si estrae più velocemente
Tempi di elaborazione tipici:
  • File piccoli (< 1MB, 10 pagine): 10-30 secondi
  • File medi (1-5MB, 10-50 pagine): 30-90 secondi
  • File grandi (5-10MB, 50+ pagine): 2-5 minuti

​
Problemi Comuni con i File

Cause:
  • Il file supera i 10MB
  • Il file è protetto da password
  • Il file è corrotto
  • Immagini scansionate di qualità molto scarsa
Soluzioni:
  • Comprimi il file o dividilo in file più piccoli
  • Rimuovi la protezione con password
  • Riesporta il file dalla fonte
  • Per scansioni di qualità molto scarsa, copia il contenuto in un elemento di testo
Cause:
  • Layout complessi (multi-colonna, tabelle)
  • Immagini scansionate di qualità molto scarsa
  • Font speciali o codifica
  • Campi modulo ed elementi interattivi
Soluzioni:
  • Controlla il contenuto estratto in modalità modifica
  • Ricrea come elemento di testo con formattazione corretta
  • Semplifica il layout del documento prima di caricarlo
  • Esporta come documento di testo semplice
Cosa fare:
  • Aspetta 5-10 minuti prima di presumere un fallimento
  • Controlla la dimensione del file e il numero di pagine
  • Per file grandi, considera di dividerli in più file
  • Converti in testo e carica come elementi TEXT

​
Best Practice per il Caricamento di File

Ottimizza prima del caricamento

  • Comprimi file grandi
  • Rimuovi immagini non necessarie
  • Usa documenti basati su testo
  • Mantieni sotto i 5MB quando possibile

Testa l'estrazione

  • Rivedi il contenuto estratto dopo l’elaborazione
  • Controlla i problemi di formattazione
  • Verifica che le informazioni critiche siano accurate
  • Ricarica se l’estrazione è scarsa

​
Elementi URL

​
Cosa Sono gli Elementi URL?

Gli elementi URL estraggono contenuto da pagine web e lo memorizzano nella tua base di conoscenza. Questo è utile per fare riferimento a documentazione online, centri di assistenza o post di blog.

​
Quando Usare gli Elementi URL

Fai riferimento a documentazione esterna che non mantieni.Esempi:
  • Documentazione API (tua o di terze parti)
  • Basi di conoscenza pubbliche
  • Articoli del centro assistenza
  • Pagine di prodotto
Contenuto che cambia regolarmente e che vuoi mantenere aggiornato ri-estraendo.Esempi:
  • Pagine dei prezzi
  • Disponibilità prodotti
  • Promozioni attuali
  • Pagine di stato
Contenuto educativo o annunci.Esempi:
  • Guide how-to
  • Articoli di best practice
  • Annunci di prodotto
  • Tutorial sulle funzionalità

​
Creare Elementi URL

1

Naviga alla cartella

Apri la cartella in cui vuoi aggiungere l’URL.
2

Clicca 'Aggiungi Elemento di Conoscenza'

Clicca il pulsante per creare un nuovo elemento.
3

Seleziona la categoria 'URL'

Scegli URL dalle opzioni del tipo di contenuto.
4

Inserisci il titolo

Dai al contenuto un titolo descrittivo.
5

Inserisci l'URL di origine

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

Clicca 'Crea'

Il sistema recupererà ed elaborerà la pagina web.Progressione dello stato:
  • PENDING → URL in coda per lo scraping
  • PROCESSING → Recupero ed estrazione del contenuto
  • COMPLETED → Contenuto disponibile
  • FAILED → Si è verificato un errore di scraping

​
Esempio JSON di Elemento URL

{
  "category": "URL",
  "title": "Documentazione Autenticazione API",
  "source_url": "https://docs.company.com/api/authentication",
  "status": "COMPLETED"
}

​
Requisiti URL

URL funzionanti:
  • Accessibili pubblicamente (nessun login richiesto)
  • Pagine di contenuto HTML semplici
  • Siti di documentazione
  • Post di blog e articoli
  • Pagine di contenuto statico
URL problematici:
  • Pagine che richiedono autenticazione
  • Applicazioni pesanti in JavaScript (SPA)
  • Contenuto a pagamento
  • Contenuto caricato dinamicamente
  • Applicazioni interattive
Lo scraping di URL funziona meglio con pagine web semplici basate su testo. Applicazioni web complesse potrebbero non essere estratte con successo.

​
Problemi Comuni con gli URL

Cause:
  • La pagina richiede login/autenticazione
  • L’URL è errato o rotto
  • Il contenuto si carica tramite JavaScript
  • Il sito web blocca lo scraping (robots.txt)
  • La pagina non esiste (404)
Soluzioni:
  • Verifica che l’URL sia accessibile pubblicamente
  • Testa l’URL in una finestra del browser in incognito
  • Controlla che l’URL sia completo e corretto
  • Copia il contenuto manualmente in un elemento di testo
  • Usa l’esportazione PDF della pagina
Cause:
  • Contenuto renderizzato con JavaScript non catturato
  • Caricamento dinamico del contenuto
  • Più schede/sezioni sulla pagina
  • Commenti o barra laterale estratti invece del contenuto principale
Soluzioni:
  • Ispeziona il contenuto estratto in modalità modifica
  • Usa URL diretto al contenuto specifico
  • Copia il contenuto desiderato in un elemento di testo
  • Esporta la pagina come PDF e carica invece
Soluzione: Il contenuto URL viene estratto una volta al momento della creazione. Per aggiornare:
  • Elimina e ricrea l’elemento URL
  • Oppure copia il contenuto attuale in un elemento di testo per aggiornamenti manuali
Per contenuto che cambia frequentemente, considera:
  • Elementi di testo manuali che aggiorni regolarmente
  • Esportazioni PDF che aggiorni periodicamente

​
Best Practice per gli URL

Testa l'accessibilità

  • Apri l’URL in una finestra in incognito
  • Verifica che non sia richiesto il login
  • Controlla che il contenuto sia visibile
  • Assicurati che la pagina si carichi rapidamente

Rivedi il contenuto estratto

  • Controlla il contenuto dopo lo scraping
  • Verifica che sia stato catturato il contenuto corretto
  • Cerca problemi di formattazione
  • Conferma che non ci sia contenuto extra (annunci, barre laterali)

​
Flusso dello Stato di Elaborazione

Gli elementi di conoscenza attraversano due pipeline di elaborazione separate:
  1. Elaborazione del Contenuto - Estrazione del testo da file/URL
  2. Indicizzazione Vettoriale - Preparazione del contenuto per RAG (ricerca semantica)

​
Stato Elaborazione Contenuto

Questo traccia l’estrazione del contenuto testuale dalla tua fonte.
1

PENDING

Significato: Elemento creato, in coda per l’estrazione del contenutoCosa sta succedendo:
  • L’elemento è stato salvato nel database
  • In attesa che il worker di elaborazione lo prelevi
  • Solitamente molto breve (secondi)
Azione necessaria: Nessuna - aspetta che inizi l’elaborazione
2

PROCESSING

Significato: Il contenuto dell’elemento è in fase di estrazioneCosa sta succedendo:
  • Per FILE: Estrazione del testo da PDF, Word, ecc.
  • Per URL: Recupero e scraping della pagina web specifica
  • Per TEXT: N/A (passa direttamente a COMPLETED)
Azione necessaria: Aspetta che l’elaborazione sia completata
3

COMPLETED

Significato: Estrazione del contenuto completata con successoCosa sta succedendo:
  • Il contenuto è stato estratto e memorizzato
  • L’indicizzazione vettoriale inizierà automaticamente
  • L’elemento sarà disponibile una volta completata l’indicizzazione
Azione necessaria: Nessuna - aspetta l’indicizzazione vettoriale
4

FAILED

Significato: L’estrazione del contenuto ha riscontrato un erroreCosa sta succedendo:
  • L’estrazione del file è fallita (PDF corrotto, formato non supportato)
  • Lo scraping dell’URL è fallito (pagina non trovata, bloccata, richiede autenticazione)
  • Il contenuto non è disponibile per gli agenti
Azione necessaria: Controlla il messaggio di errore e risolvi il problema
Flusso Elaborazione Contenuto: CREATED → PENDING → PROCESSING → COMPLETED o FAILED

​
Stato Indicizzazione Vettoriale

Dopo che il contenuto è estratto, deve essere indicizzato per RAG (ricerca semantica). Questo permette agli agenti di trovare conoscenza rilevante basata sul significato, non solo sulle parole chiave.
1

PENDING

Significato: In attesa che inizi l’indicizzazione vettorialeCosa sta succedendo:
  • Elaborazione del contenuto completata con successo
  • In coda per la generazione di embedding
  • Solitamente breve (da secondi a minuti)
Azione necessaria: Nessuna
2

INDEXING

Significato: Creazione di embedding vettoriali per RAGCosa sta succedendo:
  • Il contenuto viene diviso in blocchi
  • Vengono generati embedding AI per ogni blocco
  • I vettori vengono memorizzati nella base di conoscenza
Azione necessaria: Aspetta - può richiedere diversi minuti per documenti grandi
3

INDEXED

Significato: L’elemento è completamente pronto per il recupero RAGCosa sta succedendo:
  • Gli embedding vettoriali sono stati memorizzati con successo
  • L’elemento può essere recuperato tramite ricerca semantica
  • Gli agenti possono ora usare questa conoscenza
Azione necessaria: Nessuna - l’elemento è completamente pronto
4

FAILED

Significato: L’indicizzazione vettoriale è fallitaCosa sta succedendo:
  • La generazione di embedding ha riscontrato un errore
  • L’elemento non apparirà nei risultati RAG
  • Potrebbe essere disponibile solo per l’iniezione nel contesto
Azione necessaria: Prova a reindicizzare o contatta il supporto
5

REMOVED

Significato: I vettori sono stati eliminatiCosa sta succedendo:
  • L’elemento è stato eliminato o esplicitamente rimosso dall’indice
  • Non più disponibile per RAG
Azione necessaria: Reindicizza se necessario
Flusso Indicizzazione Vettoriale: PENDING → INDEXING → INDEXED o FAILED
Entrambi gli stati devono avere successo per la piena funzionalità:
  • Stato Contenuto: COMPLETED
  • Stato Vettoriale: INDEXED
Solo allora l’elemento può essere utilizzato sia nell’iniezione del contesto che nel recupero RAG.

​
Gestione degli Errori

​
Quando gli Elementi Falliscono

Se un elemento di conoscenza mostra lo stato FAILED:
1

Controlla il messaggio di errore

Clicca sull’elemento fallito per vedere i dettagli dell’errore.
2

Identifica la causa

Cause comuni:
  • File: File troppo grande, corrotto, protetto da password, immagine scansionata
  • URL: Autenticazione richiesta, link rotto, contenuto non accessibile
3

Prova le soluzioni

  • Per File: Comprimi, rimuovi protezione, aggiungi livello di testo, o converti in testo
  • Per URL: Verifica accessibilità, prova URL diverso, o copia contenuto in elemento di testo
4

Ricrea o converti

  • Elimina l’elemento fallito
  • Crea un nuovo elemento con le correzioni applicate
  • Oppure converti in elemento di testo copiando il contenuto manualmente

​
Prevenire gli Errori

Prevenzione File

  • Mantieni i file sotto i 5MB
  • Usa documenti basati su testo o scansioni di qualità
  • Rimuovi password
  • Testa con un file piccolo prima

Prevenzione URL

  • Testa l’URL in modalità in incognito
  • Usa pagine HTML semplici
  • Evita contenuto autenticato
  • Controlla la compatibilità robots.txt

​
Monitoraggio dell’Elaborazione

​
Indicatori del Dashboard

Nel dashboard della tua base di conoscenza, puoi vedere lo stato di elaborazione a colpo d’occhio per ogni elemento nelle tue cartelle: Indicatori di stato:
  • Segno di spunta verde = COMPLETED
  • Clessidra = PROCESSING
  • Simbolo di pausa = PENDING
  • X rossa = FAILED
Esempio vista cartella:
  • Manuale Utente.pdf - COMPLETED
  • Guida Avvio Rapido.pdf - PROCESSING
  • Documentazione API - PENDING
  • Manuale Legacy.pdf - FAILED

​
Elaborazione in Blocco

Quando carichi più elementi:
  1. Gli elementi vengono elaborati in sequenza o in parallelo (dipende dal sistema)
  2. Controlla dopo 5-10 minuti per batch grandi
  3. Rivedi lo stato di ogni elemento
  4. Risolvi eventuali fallimenti individualmente
Carica prima un elemento di test per verificare il formato e l’elaborazione prima del caricamento in blocco.

​
Scegliere il Tipo di Contenuto Giusto

Usa questo albero decisionale per selezionare il miglior tipo di contenuto: Hai contenuto esistente?
  • No → Usa TEXT (scrivi direttamente)
  • Sì, è un documento →
    • Sotto 10MB → Usa FILE
    • Oltre 10MB → Estrai testo, usa TEXT
  • Sì, è una pagina web →
    • Accessibile pubblicamente → Usa URL (se lo scraping fallisce, copia in TEXT)
    • Non accessibile → Copia contenuto in TEXT

​
Raccomandazioni Rapide

La Tua SituazioneMiglior Tipo di Contenuto
Scrivere FAQ da zeroTEXT
Hai documenti Word/PDF esistentiCarica come FILE
Hai documenti sotto 10MBFILE
Hai documenti oltre 10MBDividi in file più piccoli o estrai in TEXT
Documentazione web pubblicaURL (con TEXT come backup)
Contenuto privato/autenticatoCopia in TEXT
Necessità di disponibilità immediataTEXT (nessun ritardo di elaborazione)
La formattazione complessa è importanteFILE

​
Prossimi Passi

Context vs RAG

Scopri come gli agenti accedono al contenuto della tua conoscenza

Crea Basi di Conoscenza

Guida passo-passo alla creazione

Panoramica Architettura

Comprendi la struttura della base di conoscenza

Variabili & Contenuto Dinamico

Fai riferimento alla conoscenza nelle istruzioni dell’agente