Linee guida sul formato per documenti e URL importati

  • Articolo

Esaminare queste linee guida di formattazione per ottenere i risultati migliori per il contenuto.

Considerazioni di 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

Product Manual example for a knowledge base

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:

Azure Blob storage semi-structured Doc

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:

Unstructured document example for a knowledge base

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:

Structured QnA document example for a knowledge base

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:

Structured QnA excel example for a knowledge base

Esempio di domande alternative per una singola risposta nel file di Excel

Di seguito è riportato un esempio di file QnA con estensione xls strutturato, con diverse domande alternative per una singola risposta:

Example of alternate questions for single answer in Excel file

Dopo l'importazione del file, la coppia di domande e risposte si trova nella Knowledge Base, come illustrato di seguito:

Screenshot of alternate questions for single answer imported into knowledge base

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 intestazioni e intestazioni secondarie per indicare la gerarchia. Ad esempio, è possibile indicare il QnA padre e h2 per indicare il QnA che deve essere richiesto. Usare dimensioni di intestazione ridotte per indicare la gerarchia successiva. Non usare lo stile, il colore o un altro meccanismo per implicare la struttura nel documento, QnA Maker non estraerà le richieste a più turni.
  • Il primo carattere dell'intestazione deve essere maiuscolo.
  • Non terminare un'intestazione 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:

Plain FAQ page example for a knowledge base

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:

Section Link FAQ page example for a knowledge base

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.

Deep link FAQ page example for a knowledge base

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.

QnA Maker supports extraction from semi-structured web pages where a clear structure is presented with hierarchical headings

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