Origini dati per i contenuti QnA MakerData sources for QnA Maker content

QnA Maker estrae automaticamente coppie di domande e risposte da contenuto semistrutturato come domande frequenti, manuali di prodotto, linee guida, documenti di supporto e criteri archiviati come pagine Web, file PDF o file di documento di Microsoft Word.QnA Maker automatically extracts question-answer pairs from semi-structured content such as FAQs, product manuals, guidelines, support documents, and policies stored as web pages, PDF files, or MS Word doc files . I contenuti possono anche essere aggiunti alla Knowledge Base da file di contenuto QnA strutturati.Content can also be added to the knowledge base from structured QnA content files.

Tipi di dati di file e URLFile and URL data types

La tabella seguente riepiloga i tipi di contenuto e di formato di file supportati da QnA Maker.The table below summarizes the types of content and file formats that are supported by QnA Maker.

Tipo di origineSource Type Content TypeContent Type esempiExamples
URLURL Domande frequentiFAQs
(con struttura piatta, a sezioni o con collegamenti ad altre pagine)(Flat, with sections or with a topics homepage)
Pagine del supportoSupport pages
(singola pagina di procedure dettagliate, articoli sulla risoluzione dei problemi e così via).(Single page how-to articles, troubleshooting articles etc.)
Domande frequenti semplici,Plain FAQ,
domande frequenti con collegamenti,FAQ with links,
domande frequenti con home page degli argomentiFAQ with topics homepage
articolo del supporto tecnicoSupport article
PDF/DOCPDF / DOC domande frequenti,FAQs,
manuale del prodotto,Product Manual,
brochure,Brochures,
documento,Paper,
volantino,Flyer Policy,
guida di supporto,Support guide,
file domanda-risposta strutturato,Structured QnA,
e così via.etc.
File domanda-risposta strutturato,Structured QnA.doc,
Sample Product Manual.pdf,Sample Product Manual.pdf,
Sample semi-structured.doc,Sample semi-structured.doc,
Esempio white paper. pdf,Sample white paper.pdf,
Esempio di multi-turn. docxSample multi-turn.docx
* Excel*Excel File domanda-risposta strutturatoStructured QnA file
(tra cui RTF, supporto HTML)(including RTF, HTML support)
Sample QnA FAQ.xlsSample QnA FAQ.xls
* TXT/TSV*TXT/TSV File domanda-risposta strutturatoStructured QnA file Esempio chit-chat.tsvSample chit-chat.tsv

Importazione ed esportazione della Knowledge baseImport and export 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.TSV and XLS files, from exported knowledge bases, can only be used by importing the files from the Settings page in the QnA Maker portal. Non possono essere utilizzati come origini dati durante la creazione della Knowledge base o nella funzionalità + Aggiungi file o Aggiungi URL nella pagina Impostazioni .They can't be used as data sources during knowledge base creation or from the + Add file or + Add URL feature on the Settings page.

Percorsi di origine datiData source locations

I percorsi delle origini dati sono URL o file pubblici, che non richiedono l'autenticazione.Data source locations are public URLs or files, which do not require authentication.

Se è necessaria l'autenticazione per l'origine dati, considerare i metodi seguenti per ottenere i dati in QnA Maker:If you need authentication for your data source, consider the following methods to get that data into QnA Maker:

Scarica file dal percorso dell'origine dati autenticatoDownload file from authenticated data source location

Se si dispone di un file autenticato (non in un percorso di SharePoint autenticato) o di un URL, un'opzione alternativa consiste nel scaricare il file dal sito autenticato al computer locale, quindi aggiungere il file dal computer locale alla Knowledge base.If you have an authenticated file (not on an authenticated Sharepoint location) or URL, an alternative option is to download the file from the authenticated site to your local computer, then add the file from your local computer to the knowledge base.

Importa il file da SharePoint autenticatoImport file from authenticated Sharepoint

I percorsi delle origini dati di SharePoint possono fornire fileautenticati.Sharepoint data source locations are allowed to provide authenticated files. Le risorse di SharePoint devono essere file, non pagine Web.Sharepoint resources must be files, not web pages. Se l'URL termina con un'estensione Web, ad esempio . ASPX, non verrà importato in QnA Maker da SharePoint.If the URL ends with a web extension, such as .ASPX, it will not import into QnA Maker from Sharepoint.

Indirizzo Web di domande frequentiFAQ URLs

QnA Maker supporta 3 diversi formati di pagine Web di domande frequenti: pagine semplici di domande frequenti, pagine di domande frequenti con collegamenti, pagine di domande frequenti con collegamenti ad altre pagine.QnA Maker can support FAQ web pages in 3 different forms: Plain FAQ pages, FAQ pages with links, FAQ pages with a Topics Homepage.

Pagine semplici di domande frequentiPlain FAQ pages

Si tratta del tipo più comune di pagina di domande frequenti, in cui le risposte seguono immediatamente le domande nella stessa pagina.This is the most common type of FAQ page, in which the answers immediately follow the questions in the same page.

Di seguito è riportato un esempio di pagina semplice di domande frequenti:Below is an example of a plain FAQ page:

Esempio di pagina semplice di domande frequenti per una 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.In this type of FAQ page, questions are aggregated together and are linked to answers that are either in different sections of the same page, or in different pages.

Di seguito è riportato un esempio di pagina di domande frequenti con collegamenti a sezioni che si trovano nella stessa pagina:Below is an example of an FAQ page with links in sections that are on the same page:

Esempio di pagina di domande frequenti con collegamenti a sezioni per una knowledge base

Pagina di domande frequenti con collegamenti ad altre pagineFAQ pages with a Topics homepage

Questo tipo di pagina di domande frequenti include una home page con argomenti in cui ogni argomento è un collegamento alle relative pagine QnA in una pagina diversa.This type of FAQ has a home page with the Topics where each Topic is a link to its relevant QnAs in a different page. Qui, QnA Maker esegue una ricerca per indicizzazione di tutte le pagine collegate per estrarre le domande e le risposte corrispondenti.Here, QnA Maker crawls all the linked pages to extract the corresponding questions & answers.

Di seguito è riportato un esempio di pagina delle domande frequenti in cui la home page di argomenti include collegamenti a sezioni di domande frequenti in pagine diverse.Below is an example of an FAQ page where a topics homepage has links to FAQ sections in different pages.

Esempio di pagina di domande frequenti con collegamenti diretti per una knowledge base

URL del supportoSupport Urls

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.QnA Maker can process semi-structured support web pages, such as web articles that would describe how to perform a given task, how to diagnose and resolve a given problem, and what are the best practices for a given process. Il procedimento di estrazione funziona meglio su contenuti che presentano una struttura chiara con intestazioni gerarchiche.Extraction works best on content that has a clear structure with hierarchical headings.

Nota

L'estrazione per gli articoli di supporto è una nuova funzionalità, nelle sue prime fasi.Extraction for support articles is a new feature and is in early stages. Funziona al meglio con pagine semplici, ben strutturate e che non contengono intestazioni o piè di pagina complessi.It works best for simple pages, that are well structured, and do not contain complex headers/footers.

QnA Maker supporta l'estrazione da pagine web semi-strutturate che presentano una struttura chiara con intestazioni gerarchiche.

File PDF/DOCPDF/ DOC files

QnA Maker può elaborare il contenuto semistrutturato di un file PDF o DOC e convertirlo in file domanda-risposta.QnA Maker can process semi-structured content in a PDF or DOC file, and convert it into QnAs. Un buon file che può inoltre essere estratto è uno in cui il contenuto è organizzato in un formato strutturato e viene rappresentato da sezioni ben definite.A good file that can be extracted well is one where content is organized in some structured form, and is represented in well-defined sections. Le sezioni possono essere suddivise ulteriormente in sottosezioni o argomenti correlati.The sections can further be broken inTO subsections, or subtopics. Il procedimento di estrazione funziona meglio su documenti che presentano una struttura chiara con intestazioni gerarchiche.Extraction works best on documents that have a clear structure with hierarchical headings.

QnA Maker identifica le sezioni e le sottosezioni e le relazioni nel file in base a indizi visivi come dimensioni del carattere, stile del carattere, numerazione, colori e così via. I file PDF o DOC semi-strutturati possono essere manuali, domande frequenti, linee guida, criteri, brochure, volantini e molti altri tipi di file.QnA Maker identifies sections and subsections and relationships in the file based on visual clues like font size, font style, numbering, colors, etc. Semi-structured PDF or DOC files could be Manuals, FAQs, Guidelines, Policies, Brochures, Flyers, and many other types of files. Di seguito alcuni esempi di questi tipi di file.Below are some example types of these files.

Manuali di prodottiProduct manuals

Un manuale è in genere materiale di riferimento fornito insieme a un prodotto.A manual is typically guidance material that accompanies a product. Consente all'utente di configurare, usare e gestire un prodotto e di risolverne i problemi.It helps the user to set up, use, maintain, and troubleshoot the product. Quando QnA Maker elabora un manuale, estrae i titoli e sottotitoli come domande e il contenuto successivo come risposte.When QnA Maker processes a manual, it extracts the headings and subheadings as questions and the subsequent content as answers. Vedere un esempio qui.See an example here.

Di seguito è riportato un esempio di un manuale con una pagina di indice e con contenuto gerarchicoBelow is an example of a manual with an index page, and hierarchical content

Esempio di manuale del prodotto per una 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.Extraction works best on manuals that have a table of contents and/or an index page, and a clear structure with hierarchical headings.

Brochure, linee guida, documenti e altri fileBrochures, guidelines, papers, and other files

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.Many other types of documents can also be processed to generate QA pairs, provided they have a clear structure and layout. Sono inclusi: brochure, linee guida, report, white paper, articoli scientifici, criteri, libri e così via. Vedere un esempio qui.These include: Brochures, guidelines, reports, white papers, scientific papers, policies, books, etc. See an example here.

Di seguito è riportato un esempio di documento semistrutturato, senza un indice:Below is an example of a semi-structured doc, without an index:

Documento semistrutturato di Archiviazione Blob di Azure

Documento domanda-risposta strutturatoStructured QnA Document

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:The format for structured Question-Answers in DOC files, is in the form of alternating Questions and Answers per line, one question per line followed by its answer in the following line, as shown below:

Question1

Answer1

Question2

Answer2

Di seguito è riportato un esempio di un documento di Word di domanda-risposta strutturato:Below is an example of a structured QnA word document:

Esempio di documento domanda-risposta strutturato per una knowledge base

File TXT, TSV e XLS strutturatiStructured TXT, TSV and XLS Files

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.QnAs in the form of structured .txt, .tsv or .xls files can also be uploaded to QnA Maker to create or augment a knowledge base. Questi file possono essere testo normale, o possono disporre di contenuto in formato RTF o HTML.These can either be plain text, or can have content in RTF or HTML.

DomandaQuestion RispostaAnswer Metadati (1 chiave: 1 valore)Metadata (1 key: 1 value)
Question1Question1 Answer1Answer1 Key1:Value1 | Key2:Value2
Question2Question2 Answer2Answer2 Key:Value

Qualsiasi colonna aggiuntiva nel file di origine viene ignorata.Any additional columns in the source file are ignored.

Esempio di file di Excel strutturatoExample of structured Excel file

Di seguito è riportato un esempio di file .xls domanda-risposta strutturato, con contenuto HTML:Below is an example of a structured QnA .xls file, with HTML content:

Esempio di file Excel domanda-risposta strutturato per una knowledge base

Esempio di domande alternative per una singola risposta in un file di ExcelExample of alternate questions for single answer in Excel file

Di seguito è riportato un esempio di un file QnA . xls strutturato, con diverse domande alternative per una singola risposta:Below is an example of a structured QnA .xls file, with several alternate questions for a single answer:

Esempio di domande alternative per una singola risposta in un file di Excel

Una volta importato il file, la coppia di domande e risposte si trova nella Knowledge base, come illustrato di seguito:After the file is imported, the question-and-answer pair is in the knowledge base as shown below:

Screenshot delle domande alternative per la singola risposta importata nella Knowledge base

Formato di dati strutturati tramite l'importazioneStructured data format through import

L'importazione di una Knowledge Base sostituisce il contenuto della Knowledge Base esistente.Importing a knowledge base replaces the content of the existing knowledge base. L'importazione richiede un file TSV strutturato che contiene informazioni sull'origine dei dati.Import requires a structured .tsv file that contains data source information. Queste informazioni consentono a QnA Maker di raggruppare le coppie domanda/risposta e di attribuirle a una specifica origine dati.This information helps QnA Maker group the question-answer pairs and attribute them to a particular data source.

DomandaQuestion RispostaAnswer Source (Sorgente)Source Metadati (1 chiave: 1 valore)Metadata (1 key: 1 value)
Question1Question1 Answer1Answer1 Url1Url1 Key1:Value1 | Key2:Value2
Question2Question2 Answer2Answer2 EditorialeEditorial Key:Value

Aggiunta di contenuti a livello editoriale alla knowledge baseEditorially add to knowledge base

Se non è presente contenuto pre-esistente per popolare la Knowledge Base, è possibile aggiungere contenuti domanda-risposta a livello editoriale nella Knowledge Base di QnA Maker.If you do not have pre-existing content to populate the knowledge base, you can add QnAs editorially in QnA Maker Knowledge base. Informazioni su come aggiornare la Knowledge Base sono disponibili qui.Learn how to update your knowledge base here.

Considerazioni di formattazioneFormatting considerations

Dopo aver importato un file o un URL, QnA Maker converte e archivia il contenuto nel formato Markdown.After importing a file or URL, QnA Maker converts and stores your content in the markdown format. Il processo di conversione aggiunge nuove righe nel testo, ad esempio \n\n.The conversion process adds new lines in the text, such as \n\n. Una conoscenza del formato Markdown consente di comprendere il contenuto convertito e gestire il contenuto della Knowledge base.A knowledge of the markdown format helps you to understand the converted content and manage your knowledge base content.

Se si aggiunge o modifica il contenuto direttamente nella Knowledge base, utilizzare la formattazione Markdown per creare contenuto RTF o modificare il contenuto del formato Markdown già presente nella risposta.If you add or edit your content directly in your knowledge base, use markdown formatting to create rich text content or change the markdown format content that is already in the answer. QnA Maker supporta gran parte del formato Markdown per fornire funzionalità di testo avanzate ai contenuti.QnA Maker supports much of the markdown format to bring rich text capabilities to your content. Tuttavia, l'applicazione client, ad esempio un bot di chat, potrebbe non supportare lo stesso set di formati Markdown.However, the client application, such as a chat bot may not support the same set of markdown formats. È importante testare la visualizzazione delle risposte dell'applicazione client.It is important to test the client application's display of answers.

Di seguito è riportato l'elenco dei formati Markdown che è possibile usare in QnA Maker:Following is the list of markdown formats that you can use in QnA Maker:

FinalitàPurpose FormatFormat Markdown di esempioExample markdown RenderingRendering
come visualizzato in chat botas displayed in Chat bot
Nuova riga tra due frasi.A new line between 2 sentences. \n\n How can I create a bot with \n\n QnA Maker? formattare la nuova riga tra due frasi
Intestazioni da H1 a H6, il numero di # indica l'intestazione.Headers from h1 to h6, the number of # denotes which header. 1 # è H1.1 # is the h1. \n# text \n## text \n### text \n####text \n#####text ## Creating a bot \n ...text.... \n### Important news\n ...text... \n### Related Information\n ....text...

\n# my h1 \n## my h2\n### my h3 \n#### my h4 \n##### my h5
formattare con le intestazioni Markdown
formattare con le intestazioni Markdown da H1 a H5
corsivoItalics *text* How do I create a bot with *QnA Maker*? formattare con corsivo
Stringa (in grassetto)String (bold) **text** How do I create a bot with **QnA Maker**? formato con contrassegno forte per grassetto
URL per il collegamentoURL for link [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? formato per URL (collegamento ipertestuale)
* URL per l'immagine pubblica*URL for public image ![text](https://www.my.com/image.png) How can I create a bot with ![QnAMaker](https://review.docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) formato dell'URL dell'immagine pubblicaformat for public image URL
barratoStrikethrough ~~text~~ some ~~questoins~~ questions need to be asked formato per barrato
Grassetto e corsivoBold and italics ***text*** How can I create a ***QnA Maker*** bot? formato per grassetto e corsivo
URL grassetto per il collegamentoBold URL for link [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? formattare l'URL in grassetto
URL corsivo per il collegamentoItalics URL for link [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? formato per l'URL corsivo
Caratteri di escape MarkdownEscape markdown symbols \*text\* How do I create a bot with \*QnA Maker\*? formato per l'URL corsivo
Elenco ordinatoOrdered list \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
Nell'esempio precedente viene usata la numerazione automatica incorporata in Markdown.The preceding example uses automatic numbering built into markdown.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
Nell'esempio precedente viene usata la numerazione esplicita.The preceding example uses explicit numbering.
formato dell'elenco ordinato
Elenco non ordinatoUnordered list \n * item1 \n * item2
Oppureor
\n - item1 \n - item2
This is an ordered list: \n * List item 1 \n * List item 2 formato dell'elenco non ordinato
Elenchi annidatiNested lists \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

\n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2

È possibile annidare insieme elenchi ordinati e non ordinati.You can nest ordered and unordered lists together. La scheda \tindica il livello di rientro dell'elemento figlio.The tab, \t, indicates the indentation level of the child element.
This is an unordered list: \n * List item 1 \n\t * Child1 \n\t * Child2 \n * List item 2

This is an ordered nested list: \n 1. Parent1 \n\t 1. Child1 \n\t 1. Child2 \n 1. Parent2
formato per un elenco non ordinato annidato
formato dell'elenco ordinato annidato

* QnA Maker non elabora l'immagine in alcun modo.*QnA Maker doesn't process the image in any way. Si tratta del ruolo dell'applicazione client per il rendering dell'immagine.It is the client application's role to render the image.

Se si vuole aggiungere contenuto usando le API della Knowledge base di aggiornamento/sostituzione e il contenuto e il file contengono tag HTML, è possibile mantenere il codice HTML nel file assicurandosi che l'apertura e la chiusura dei tag vengano convertite nel formato codificato.If you want to add content using update/replace knowledgebase APIs and the content/file contains html tags, you can preserve the HTML in your file by ensuring that opening and closing of the tags are converted in the encoded format.

Mantieni HTMLPreserve HTML Rappresentazione nella richiesta APIRepresentation in the API request Rappresentazione in KBRepresentation in KB
Yes &lt; br&gt;&lt;br&gt; <BR><br>
Yes &lt; H3&gt; header&lt;/H3&gt;&lt;h3&gt;header&lt;/h3&gt; <intestazione>H3</H3><h3>header</h3>

Inoltre, CR LF (\r\n) viene convertito in \n nella KB.Additionally, CR LF(\r\n) are converted to \n in the KB. LF (\n) viene mantenuto così com'è.LF(\n) is kept as is. Se si vuole eseguire l'escape di qualsiasi sequenza di escape come \t o \n, è possibile usare la barra rovesciata, ad esempio:'\\r\\n'' è\\t'If you want to escape any escape sequence like a \t or \n you can use backslash, for example: '\\r\\n' and '\\t'

Modificare la knowledge base in localeEditing your knowledge base locally

Dopo aver creato una knowledge base, si consiglia di apportare modifiche al testo della knowledge base nel portale di QnA Maker, invece di esportare e reimportare tramite file locali.Once a knowledge base is created, it is recommended that you make edits to the knowledge base text in the QnA Maker portal, rather than exporting and reimporting through local files. Tuttavia, potrebbe essere talvolta necessario modificare una knowledge base in locale.However, there may be times that you need to edit a knowledge base locally.

Esportare la knowledge base dalla pagina Impostazioni e modificarla con Microsoft Excel.Export the knowledge base from the Settings page, then edit the knowledge base with Microsoft Excel. Se si sceglie di usare un'altra applicazione per modificare il file TSV esportato, l'applicazione può comportare errori di sintassi perché non è completamente conforme al formato TSV.If you choose to use another application to edit your exported TSV file, the application may introduce syntax errors because it is not fully TSV compliant. File TSV Microsoft Excel, in genere non introducono eventuali errori di formattazione.Microsoft Excel's TSV files generally don't introduce any formatting errors.

Dopo aver completato le modifiche, reimportare il file TSV dalla pagina Impostazioni.Once you are done with your edits, reimport the TSV file from the Settings page. In questo modo si sostituirà completamente la knowledge base corrente con la knowledge base importata.This will completely replace the current knowledge base with the imported knowledge base.

Test di MarkdownTesting your Markdown

Usare l'esercitazione CommonMark per convalidare il codice Markdown.Use the CommonMark tutorial to validate your Markdown. L'esercitazione contiene la funzionalità Prova per la convalida veloce copia/incolla.The tutorial has a Try it feature for quick copy/paste validation.

Controllo della versione per i dati nella Knowledge baseVersion control for data in your knowledge base

Il controllo della versione per i dati viene fornito tramite la funzionalità importazione/esportazione nella pagina Impostazioni .Version control for data is provided through the import/export feature on the Settings page.

Passaggi successiviNext steps

Vedi ancheSee also

Panoramica di QnA MakerQnA Maker overview