Formatera riktlinjer för importerade dokument och URL:er

  • Artikel

Granska de här formateringsriktlinjerna för att få bästa resultat för ditt innehåll.

Formateringsöverväganden

När du har importerat en fil eller URL konverterar och lagrar QnA Maker ditt innehåll i markdown-format. Konverteringsprocessen lägger till nya rader i texten, till exempel \n\n. En kunskap om markdown-formatet hjälper dig att förstå det konverterade innehållet och hantera ditt kunskapsbas innehåll.

Om du lägger till eller redigerar ditt innehåll direkt i kunskapsbas använder du markdown-formatering för att skapa RTF-innehåll eller ändra markdown-formatinnehållet som redan finns i svaret. QnA Maker stöder mycket av markdown-formatet för att ge rtF-funktioner till ditt innehåll. Klientprogrammet, till exempel en chattrobot, kanske inte stöder samma uppsättning markdown-format. Det är viktigt att testa klientprogrammets visning av svar.

Se en fullständig lista över innehållstyper och exempel.

Grundläggande dokumentformatering

QnA Maker identifierar avsnitt och underavsnitt och relationer i filen baserat på visuella ledtrådar som:

  • Teckenstorlek
  • Teckenstil
  • Numrering
  • Färger

Kommentar

Vi stöder för närvarande inte extrahering av bilder från uppladdade dokument.

Produkthandböcker

En handbok är vanligtvis vägledningsmaterial som medföljer en produkt. Det hjälper användaren att konfigurera, använda, underhålla och felsöka produkten. När QnA Maker bearbetar en handbok extraheras rubrikerna och underrubrikerna som frågor och det efterföljande innehållet som svar. Se ett exempel här.

Nedan visas ett exempel på en handbok med en indexsida och hierarkiskt innehåll

Product Manual example for a knowledge base

Kommentar

Extrahering fungerar bäst på handböcker som har en innehållsförteckning och/eller en indexsida och en tydlig struktur med hierarkiska rubriker.

Broschyrer, riktlinjer, papper och andra filer

Många andra typer av dokument kan också bearbetas för att generera QA-par, förutsatt att de har en tydlig struktur och layout. Dessa omfattar: Broschyrer, riktlinjer, rapporter, vitböcker, vetenskapliga artiklar, policyer, böcker osv. Se ett exempel här.

Nedan visas ett exempel på ett halvstrukturerat dokument, utan index:

Azure Blob storage semi-structured Doc

Stöd för ostrukturerade dokument

Svar på anpassade frågor stöder nu ostrukturerade dokument. Ett dokument som inte har sitt innehåll organiserat på ett väldefinierat hierarkiskt sätt, saknar en uppsättningsstruktur eller har ett fritt flöde av innehåll kan betraktas som ett ostrukturerat dokument.

Nedan visas ett exempel på ett ostrukturerat PDF-dokument:

Unstructured document example for a knowledge base

För närvarande är den här funktionen endast tillgänglig via dokumentuppladdning och endast för PDF- och DOC-filformat.

Viktigt!

Stöd för ostrukturerad fil/innehåll är endast tillgängligt i frågesvar.

Strukturerat QnA-dokument

Formatet för strukturerade frågesvar i DOC-filer är i form av alternerande frågor och svar per rad, en fråga per rad följt av svaret på följande rad, som visas nedan:

Question1

Answer1

Question2

Answer2

Nedan visas ett exempel på ett strukturerat QnA-orddokument:

Structured QnA document example for a knowledge base

Strukturerade TXT-, TSV- och XLS-filer

QnA:er i form av strukturerade .txt-, .tsv- eller .xls-filer kan också laddas upp till QnA Maker för att skapa eller utöka en kunskapsbas. Dessa kan antingen vara oformaterad text eller ha innehåll i RTF eller HTML. QnA-par har ett valfritt metadatafält som kan användas för att gruppera QnA-par i kategorier.

Fråga Svar Metadata (1 nyckel: 1 värde)
Fråga 1 Svar 1 Key1:Value1 | Key2:Value2
Fråga 2 Svar 2 Key:Value

Eventuella ytterligare kolumner i källfilen ignoreras.

Exempel på strukturerad Excel-fil

Nedan visas ett exempel på en strukturerad QnA .xls-fil med HTML-innehåll:

Structured QnA excel example for a knowledge base

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

Nedan visas ett exempel på en strukturerad QnA .xls-fil med flera alternativa frågor för ett enda svar:

Example of alternate questions for single answer in Excel file

När filen har importerats finns fråge- och svarsparet i kunskapsbas enligt nedan:

Screenshot of alternate questions for single answer imported into knowledge base

Strukturerat dataformat via import

Om du importerar en kunskapsbas ersätts innehållet i den befintliga kunskapsbas. Import kräver en strukturerad .tsv-fil som innehåller information om datakällan. Den här informationen hjälper QnA Maker att gruppera frågesvarsparen och tillskriva dem till en viss datakälla. QnA-par har ett valfritt metadatafält som kan användas för att gruppera QnA-par i kategorier.

Fråga Svar Källa Metadata (1 nyckel: 1 värde)
Fråga 1 Svar 1 Url1 Key1:Value1 | Key2:Value2
Fråga 2 Svar 2 Redaktionellt Key:Value

Dokumentformatering i flera svängar

  • Använd rubriker och underrubriker för att ange hierarki. Du kan till exempel h1 ange den överordnade QnA och h2 för att ange den QnA som ska tas som prompt. Använd liten rubrikstorlek för att ange efterföljande hierarki. Använd inte format, färg eller någon annan mekanism för att implicera struktur i dokumentet, QnA Maker extraherar inte multi-turn-prompterna.
  • Det första tecknet i rubriken måste vara versalt.
  • Avsluta inte en rubrik med ett frågetecken, ?.

Exempeldokument:
Surface Pro (docx)
Contoso-fördelar (docx)
Contoso-förmåner (pdf)

URL:er för vanliga frågor och svar

QnA Maker har stöd för vanliga frågor och svar-webbsidor i tre olika formulär:

  • Vanliga frågor och svar-sidor
  • Vanliga frågor och svar-sidor med länkar
  • Vanliga frågor och svar-sidor med en startsida för ämnen

Vanliga frågor och svar-sidor

Det här är den vanligaste typen av sida med vanliga frågor och svar, där svaren omedelbart följer frågorna på samma sida.

Nedan visas ett exempel på en vanlig sida med vanliga frågor och svar:

Plain FAQ page example for a knowledge base

På den här sidan med vanliga frågor och svar sammanställs frågorna och länkas till svar som antingen finns i olika avsnitt på samma sida eller på olika sidor.

Nedan visas ett exempel på en sida med vanliga frågor och svar med länkar i avsnitt som finns på samma sida:

Section Link FAQ page example for a knowledge base

Länkar till sidor med underordnade svar på sidan Överordnat ämne

Den här typen av vanliga frågor och svar har en ämnessida där varje ämne är länkat till en motsvarande uppsättning frågor och svar på en annan sida. QnA Maker crawlar alla länkade sidor för att extrahera motsvarande frågor och svar.

Nedan visas ett exempel på en ämnessida med länkar till avsnitt med vanliga frågor och svar på olika sidor.

Deep link FAQ page example for a knowledge base

Support-URL:er

QnA Maker kan bearbeta halvstrukturerade supportwebbplatser, till exempel webbartiklar som beskriver hur du utför en viss uppgift, hur du diagnostiserar och löser ett visst problem och vilka metodtips som används för en viss process. Extrahering fungerar bäst på innehåll som har en tydlig struktur med hierarkiska rubriker.

Kommentar

Extrahering för supportartiklar är en ny funktion och är i ett tidigt skede. Det fungerar bäst för enkla sidor som är väl strukturerade och inte innehåller komplexa sidhuvuden/sidfötter.

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

Importera och exportera kunskapsbas

TSV- och XLS-filer från exporterade kunskapsbas kan endast användas genom att importera filerna från sidan Inställningar i QnA Maker-portalen. De kan inte användas som datakällor när kunskapsbas skapas eller från funktionen + Lägg till fil eller + Lägg till URL på Inställningar sidan.

När du importerar kunskapsbasen via dessa TSV- och XLS-filer läggs QnA-paren till i den redaktionella källan och inte de källor som QnA:erna extraherades från i den exporterade kunskapsbasen.

Nästa steg

Se en fullständig lista över innehållstyper och exempel