Format rikt linjer för importerade dokument och webb adresserFormat guidelines for imported documents and URLs

Granska dessa rikt linjer för formatering för att få bästa möjliga resultat för ditt innehåll.Review these formatting guidelines to get the best results for your content.

Överväganden vid formateringFormatting considerations

När du har importerat en fil eller URL, QnA Maker konvertera och lagra innehållet i markdown-formatet.After importing a file or URL, QnA Maker converts and stores your content in the markdown format. Konverterings processen lägger till nya rader i texten, t \n\n. ex..The conversion process adds new lines in the text, such as \n\n. En kunskap om markdown-formatet hjälper dig att förstå det konverterade innehållet och hantera ditt kunskaps bas innehåll.A knowledge of the markdown format helps you to understand the converted content and manage your knowledge base content.

Om du lägger till eller redigerar innehållet direkt i din kunskaps bas använder du markdown-formatering för att skapa RTF-innehåll eller ändra markdown format innehåll som redan finns i svaret.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 stöder mycket av markdown-formatet för att få RTF-funktioner till ditt innehåll.QnA Maker supports much of the markdown format to bring rich text capabilities to your content. Men klient programmet, till exempel en chatt-robot, kanske inte stöder samma uppsättning markdown-format.However, the client application, such as a chat bot may not support the same set of markdown formats. Det är viktigt att testa klient programmets visning av svar.It is important to test the client application's display of answers.

Se en fullständig lista över innehålls typer och exempel.See a full list of content types and examples.

Grundläggande dokumentformateringBasic document formatting

QnA Maker identifierar avsnitt och underavsnitt och relationer i filen baserat på visuella LED trådar som:QnA Maker identifies sections and subsections and relationships in the file based on visual clues like:

  • teckenstorlekfont size
  • tecken stilfont style
  • numreringennumbering
  • färgercolors

Produkt handböckerProduct manuals

En manuell är vanligt vis ett hjälp material som medföljer en produkt.A manual is typically guidance material that accompanies a product. Det hjälper användaren att konfigurera, använda, underhålla och felsöka produkten.It helps the user to set up, use, maintain, and troubleshoot the product. När QnA Maker bearbetar en manuell extraheras rubriker och under rubriker som frågor och efterföljande innehåll som svar.When QnA Maker processes a manual, it extracts the headings and subheadings as questions and the subsequent content as answers. Se ett exempel här.See an example here.

Nedan visas ett exempel på en manuell med en index sida och hierarkiskt innehållBelow is an example of a manual with an index page, and hierarchical content

Produkt hand bok exempel för en kunskaps bas

Anteckning

Extraktion fungerar bäst på handböcker som har en innehålls förteckning och/eller en index sida och en tydlig struktur med hierarkiska rubriker.Extraction works best on manuals that have a table of contents and/or an index page, and a clear structure with hierarchical headings.

Broschyrer, rikt linjer, dokument och andra filerBrochures, guidelines, papers, and other files

Många andra typer av dokument kan också bearbetas för att generera frågor och svar, förutsatt att de har en tydlig struktur och layout.Many other types of documents can also be processed to generate QA pairs, provided they have a clear structure and layout. Dessa omfattar: broschyrer, rikt linjer, rapporter, fakta blad, vetenskapliga handlingar, principer, böcker osv. Se ett exempel här.These include: Brochures, guidelines, reports, white papers, scientific papers, policies, books, etc. See an example here.

Nedan visas ett exempel på ett delvis strukturerat dokument utan ett index:Below is an example of a semi-structured doc, without an index:

Halv strukturerat dokument i Azure Blob Storage

Strukturerat QnA-dokumentStructured QnA Document

Formatet för strukturerad fråga – svar i DOC-filer, är i form av alternerande frågor och svar per rad, en fråga per rad följt av dess svar på följande rad, enligt nedan: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

Nedan visas ett exempel på ett strukturerat QnA Word-dokument:Below is an example of a structured QnA word document:

Exempel på strukturerade QnA-dokument för en kunskaps bas

Strukturerade txt-, TSV -och xls -filerStructured TXT, TSV and XLS Files

Kring i form av Structured . txt-, . tsv -eller . xls -filer kan också överföras till QNA Maker för att skapa eller utöka en kunskaps bas.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. Dessa kan antingen vara oformaterad text eller ha innehåll i RTF eller HTML.These can either be plain text, or can have content in RTF or HTML.

FrågaQuestion SvarAnswer Metadata (1 nyckel: 1 värde)Metadata (1 key: 1 value)
Question1Question1 Answer1Answer1 Key1:Value1 | Key2:Value2
Question2Question2 Answer2Answer2 Key:Value

Eventuella ytterligare kolumner i käll filen ignoreras.Any additional columns in the source file are ignored.

Exempel på strukturerad Excel-filExample of structured Excel file

Nedan visas ett exempel på en strukturerad QnA . xls -fil med HTML-innehåll:Below is an example of a structured QnA .xls file, with HTML content:

Strukturerad QnA Excel-exempel för en kunskaps bas

Exempel på alternativa frågor för ett enskilt svar i Excel-filExample of alternate questions for single answer in Excel file

Nedan visas ett exempel på en strukturerad QnA . xls -fil med flera alternativa frågor för ett enda svar:Below is an example of a structured QnA .xls file, with several alternate questions for a single answer:

Exempel på alternativa frågor för ett enskilt svar i Excel-fil

När filen har importer ATS visas fråga-och-svar-paret i kunskaps basen enligt nedan:After the file is imported, the question-and-answer pair is in the knowledge base as shown below:

Skärm bild av alternativa frågor för enskilda svar som importeras till kunskaps basen

Strukturerat data format via importStructured data format through import

Om du importerar en kunskaps bas ersätts innehållet i den befintliga kunskaps basen.Importing a knowledge base replaces the content of the existing knowledge base. Importen kräver en strukturerad. TSV-fil som innehåller information om data källan.Import requires a structured .tsv file that contains data source information. Den här informationen hjälper QnA Maker att gruppera frågans svars par och attributerar dem till en viss data källa.This information helps QnA Maker group the question-answer pairs and attribute them to a particular data source.

FrågaQuestion SvarAnswer KällaSource Metadata (1 nyckel: 1 värde)Metadata (1 key: 1 value)
Question1Question1 Answer1Answer1 Url1Url1 Key1:Value1 | Key2:Value2
Question2Question2 Answer2Answer2 RedaktionelltEditorial Key:Value

Flersidig dokumentformateringMulti-turn document formatting

  • Använd rubriker och under rubriker för att beteckna hierarkier.Use headings and sub-headings to denote hierarchy. Till exempel kan du ange den överordnade QnA och H2 för att ange den QnA som ska tas med i frågan.For example You can h1 to denote the parent QnA and h2 to denote the QnA that should be taken as prompt. Använd liten rubrik storlek för att beteckna efterföljande hierarkier.Use small heading size to denote subsequent hierarchy. Använd inte formatmall, färg eller någon annan mekanism för att göra en struktur i ditt dokument, QnA Maker inte extraherar flera inaktiverade prompter.Don't use style, color, or some other mechanism to imply structure in your document, QnA Maker will not extract the multi-turn prompts.
  • Första bokstaven i rubriken måste vara kapitaliserad.First character of heading must be capitalized.
  • Avsluta inte en rubrik med ett frågetecken, ?.Do not end a heading with a question mark, ?.

Exempel dokument:Sample documents:
Surface Pro (docx)Surface Pro (docx)
Contoso-förmåner (docx)Contoso Benefits (docx)
Contoso-förmåner (PDF)Contoso Benefits (pdf)

Nästa stegNext steps

Se en fullständig lista över innehålls typer och exempelSee a full list of content types and examples