Linee guida sul formato per documenti e URL importati
Esaminare queste linee guida di formattazione per ottenere i risultati migliori per il contenuto.
Considerazioni sulla formattazione
Dopo aver importato un file o un URL, QnA Maker converte e archivia il contenuto nel formato markdown. Il processo di conversione aggiunge nuove righe nel testo, ad esempio \n\n
. Una conoscenza del formato markdown consente di comprendere il contenuto convertito e di gestire il contenuto della Knowledge Base.
Se si aggiunge o si modifica il contenuto direttamente nella Knowledge Base, usare la formattazione markdown per creare contenuto RTF o modificare il contenuto del formato markdown già presente nella risposta. QnA Maker supporta gran parte del formato markdown per offrire funzionalità di testo RTF ai contenuti. Tuttavia, l'applicazione client, ad esempio un chatbot, potrebbe non supportare lo stesso set di formati markdown. È importante testare la visualizzazione delle risposte dell'applicazione client.
Vedere un elenco completo dei tipi di contenuto e degli esempi.
Formattazione di base dei documenti
QnA Maker identifica sezioni e sottosezioni e relazioni nel file in base a indizi visivi come:
- dimensione carattere
- stile carattere
- numerazione
- colors
Nota
Attualmente non è supportata l'estrazione di immagini dai documenti caricati.
Manuali di prodotti
Un manuale è in genere materiale di riferimento fornito insieme a un prodotto. Consente all'utente di configurare, usare e gestire un prodotto e di risolverne i problemi. Quando QnA Maker elabora un manuale, estrae i titoli e sottotitoli come domande e il contenuto successivo come risposte. Vedere un esempio qui.
Di seguito è riportato un esempio di un manuale con una pagina di indice e con contenuto gerarchico
Nota
L'estrazione funziona al meglio con i manuali che hanno un sommario e/o una pagina di indice e una struttura chiara con titoli gerarchici.
Brochure, linee guida, documenti e altri file
Possono essere elaborati anche molti altri tipi di documento in modo che possano generare coppie di controllo qualità, purché essi dispongano di una struttura e di un layout chiari. Tra cui: brochure, linee guida, report, white paper, documenti scientifici, politiche, libri e così via. Vedere un esempio qui.
Di seguito è riportato un esempio di documento semistrutturato, senza un indice:
Supporto di documenti non strutturati
La risposta alle domande personalizzata supporta ora documenti non strutturati. Un documento che non ha il contenuto organizzato in modo gerarchico ben definito, manca una struttura di set o ha un flusso di contenuto libero può essere considerato come un documento non strutturato.
Di seguito è riportato un esempio di documento PDF non strutturato:
Attualmente questa funzionalità è disponibile solo tramite il caricamento di documenti e solo per i formati di file PDF e DOC.
Importante
Il supporto per file/contenuto non strutturato è disponibile solo nella risposta alle domande.
Documento domanda-risposta strutturato
Il formato per documenti domanda-risposta strutturati in file con estensione DOC consiste nell'alternanza di domande e risposte per ogni linea, una domanda per ogni linea seguita dalla relativa risposta nella linea seguente, come illustrato di seguito:
Question1
Answer1
Question2
Answer2
Di seguito è riportato un esempio di un documento di Word di domanda-risposta strutturato:
File TXT, TSV e XLS strutturati
Anche i documenti domanda-risposta sotto forma di file .txt, .tsv oppure .xls strutturati possono essere caricati da QnA Maker per creare o estendere una knowledge base. Questi file possono essere testo normale, o possono disporre di contenuto in formato RTF o HTML. Le coppie QnA hanno un campo di metadati facoltativo che può essere usato per raggruppare le coppie QnA in categorie.
Domanda | Risposta | Metadati (1 chiave: 1 valore) |
---|---|---|
Question1 | Answer1 | Key1:Value1 | Key2:Value2 |
Question2 | Answer2 | Key:Value |
Qualsiasi colonna aggiuntiva nel file di origine viene ignorata.
Esempio di file di Excel strutturato
Di seguito è riportato un esempio di file .xls domanda-risposta strutturato, con contenuto HTML:
Esempio di domande alternative per una singola risposta nel file di Excel
Di seguito è riportato un esempio di file di .xls QnA strutturato, con diverse domande alternative per una singola risposta:
Dopo l'importazione del file, la coppia di domande e risposte si trova nella Knowledge Base, come illustrato di seguito:
Formato di dati strutturati tramite l'importazione
L'importazione di una Knowledge Base sostituisce il contenuto della Knowledge Base esistente. L'importazione richiede un file TSV strutturato che contiene informazioni sull'origine dei dati. Queste informazioni consentono a QnA Maker di raggruppare le coppie domanda/risposta e di attribuirle a una specifica origine dati. Le coppie QnA hanno un campo di metadati facoltativo che può essere usato per raggruppare le coppie QnA in categorie.
Domanda | Risposta | Origine | Metadati (1 chiave: 1 valore) |
---|---|---|---|
Question1 | Answer1 | Url1 | Key1:Value1 | Key2:Value2 |
Question2 | Answer2 | Editoriale | Key:Value |
Formattazione di documenti a più turni
- Usare titoli e sottotitoli per contrassegnare la gerarchia. Ad esempio, è possibile indicare il QnA padre e h2 per indicare il QnA che deve essere richiesto. Usare dimensioni di titoli ridotte per indicare la gerarchia successiva. Non usare stili, colori o altri meccanismi per definire implicitamente la struttura nel documento. In questo caso, QnA Maker non potrà estrarre le richieste a più turni.
- Il primo carattere dell'intestazione deve essere maiuscolo.
- Non terminare un titolo con un punto interrogativo,
?
.
Documenti di esempio:
Surface Pro (docx)
Vantaggi di Contoso (docx)
Vantaggi di Contoso (pdf)
Indirizzo Web di domande frequenti
QnA Maker può supportare tre diversi formati di pagine Web di domande frequenti:
- Pagine semplici di domande frequenti
- Pagina di domande frequenti con collegamenti
- Pagine di domande frequenti con una home page degli argomenti
Pagine semplici di domande frequenti
Si tratta del tipo più comune di pagina di domande frequenti, in cui le risposte seguono immediatamente le domande nella stessa pagina.
Di seguito è riportato un esempio di pagina semplice di domande frequenti:
Pagina di domande frequenti con collegamenti
In questo tipo di pagina di domande frequenti, le domande sono aggregate e collegate a risposte che si trovano in diverse sezioni della stessa pagina o in pagine differenti.
Di seguito è riportato un esempio di pagina di domande frequenti con collegamenti a sezioni che si trovano nella stessa pagina:
Collegamenti alla pagina Argomenti padre alle pagine delle risposte figlio
Questo tipo di domande frequenti include una pagina Argomenti in cui ogni argomento è collegato a un set corrispondente di domande e risposte in una pagina diversa. QnA Maker esegue la ricerca per indicizzazione di tutte le pagine collegate per estrarre le domande e le risposte corrispondenti.
Di seguito è riportato un esempio di pagina Argomenti con collegamenti a sezioni di domande frequenti in pagine diverse.
URL di supporto
QnA Maker è in grado di elaborare pagine web di supporto semi-strutturatee, ad esempio articoli web che descrivono come eseguire una determinata attività, come diagnosticare e risolvere un problema specifico e quali sono le procedure consigliate per un determinato processo. Il procedimento di estrazione funziona meglio su contenuti che presentano una struttura chiara con intestazioni gerarchiche.
Nota
L'estrazione per gli articoli di supporto è una nuova funzionalità, nelle sue prime fasi. Funziona al meglio con pagine semplici, ben strutturate e che non contengono intestazioni o piè di pagina complessi.
Importare ed esportare la Knowledge Base
I file TSV e XLS, dalle knowledge base esportate, possono essere usati solo importando i file dalla pagina Impostazioni nel portale di QnA Maker. Non possono essere usati come origini dati durante la creazione della Knowledge Base o dalla funzionalità + Aggiungi file o + Aggiungi URL nella pagina Impostazioni .
Quando si importa la Knowledge Base tramite questi file TSV e XLS, le coppie QnA vengono aggiunte all'origine editoriale e non alle origini da cui sono state estratte le domande e risposte nella Knowledge Base esportata.
Passaggi successivi
Vedere un elenco completo di tipi di contenuto ed esempi