Az importált dokumentumokra és URL-címekre vonatkozó irányelvek formázása

Tekintse át ezeket a formázási irányelveket, hogy a legjobb eredményt kapja a tartalomhoz.

Formázási szempontok

Egy fájl vagy URL importálása után a QnA Maker markdown formátumban konvertálja és tárolja a tartalmat. Az átalakítási folyamat új sorokat ad hozzá a szöveghez, például \n\n. A markdown formátum ismerete segít megérteni a konvertált tartalmat, és kezelni a tudásbázis tartalmat.

Ha közvetlenül a tudásbázis veszi fel vagy szerkessze a tartalmat, a Markdown-formázással rich text-tartalmat hozhat létre, vagy módosíthatja a markdown formátumú tartalmat, amely már szerepel a válaszban. A QnA Maker a Markdown formátum nagy részét támogatja, így a tartalom gazdag szöveges képességeket nyújt. Előfordulhat azonban, hogy az ügyfélalkalmazás, például a csevegőrobot nem támogatja ugyanazokat a Markdown-formátumokat. Fontos, hogy tesztelje az ügyfélalkalmazás válaszainak megjelenítését.

Tekintse meg a tartalomtípusok és példák teljes listáját.

Egyszerű dokumentumformázás

A QnA Maker az alábbi vizuális jelek alapján azonosítja a fájl szakaszait és alszakaszait és kapcsolatait:

  • Betűméret
  • Betűstílus
  • Számozás
  • Színek

Megjegyzés:

Jelenleg nem támogatjuk a képek kinyerésének támogatását a feltöltött dokumentumokból.

Termék kézikönyvei

A kézikönyvek általában olyan útmutató anyagok, amelyek egy terméket kísérnek. Segít a felhasználónak a termék beállításában, használatában, karbantartásában és hibaelhárításában. Amikor a QnA Maker feldolgoz egy kézikönyvet, a címsorokat és alcímeket kérdésekként, az azt követő tartalmat pedig válaszként nyeri ki. Itt talál egy példát.

Az alábbiakban egy példa egy indexoldallal és hierarchikus tartalommal rendelkező kézikönyvre

Product Manual example for a knowledge base

Megjegyzés:

A kinyerés olyan kézikönyveken működik a legjobban, amelyek tartalomjegyzékkel és/vagy indexoldallal, valamint hierarchikus címsorokkal rendelkező egyértelmű struktúrával rendelkeznek.

Brosúrák, irányelvek, dokumentumok és egyéb fájlok

Számos más típusú dokumentum is feldolgozható minőségbiztosítási párok létrehozásához, feltéve, hogy világos szerkezettel és elrendezéssel rendelkeznek. Ezek közé tartoznak a brosúrák, irányelvek, jelentések, tanulmányok, tudományos dokumentumok, szabályzatok, könyvek stb. Itt talál egy példát.

Az alábbiakban egy példa egy részben strukturált dokumentumra, index nélkül:

Azure Blob storage semi-structured Doc

Strukturálatlan dokumentumtámogatás

Az egyéni kérdések megválaszolása mostantól támogatja a strukturálatlan dokumentumokat. Strukturálatlan dokumentumnak tekinthető az a dokumentum, amely nem rendelkezik a tartalma jól definiált hierarchikus rendszerezésével, hiányzik egy meghatározott struktúra, vagy a tartalommentes áramlása strukturálatlan dokumentumnak tekinthető.

Az alábbiakban egy strukturálatlan PDF-dokumentum látható:

Unstructured document example for a knowledge base

Ez a funkció jelenleg csak dokumentumfeltöltéssel érhető el, és csak PDF- és DOC-fájlformátumokhoz.

Fontos

A strukturálatlan fájlok/tartalmak támogatása csak a kérdés megválaszolásakor érhető el.

Strukturált QnA-dokumentum

A DOC-fájlokban a strukturált kérdésekre adott válaszok formátuma soronként váltakozó kérdések és válaszok formájában jelenik meg, soronként egy kérdés, majd a válasz az alábbi sorban, ahogy az alább látható:

Question1

Answer1

Question2

Answer2

Az alábbiakban egy strukturált QnA-szódokumentum látható:

Structured QnA document example for a knowledge base

Strukturált TXT-, TSV- és XLS-fájlok

Strukturált .txt, .tsv vagy .xls fájlok formájában a QnA Makerbe is feltölthetők a tudásbázis létrehozásához vagy bővítéséhez. Ezek lehetnek egyszerű szövegek, vagy rtf-ben vagy HTML-ben lévő tartalmak. A QnA-párok opcionális metaadatmezővel rendelkeznek, amellyel kategóriákba csoportosíthatók a QnA-párok.

Question Answer Metaadatok (1 kulcs: 1 érték)
1. kérdés Válasz1 Key1:Value1 | Key2:Value2
2. kérdés Válasz2 Key:Value

A forrásfájl további oszlopai figyelmen kívül lesznek hagyva.

Példa strukturált Excel-fájlra

Az alábbi példa egy strukturált QnA .xls-fájlra mutat be HTML-tartalommal:

Structured QnA excel example for a knowledge base

Példa az önálló válaszra vonatkozó alternatív kérdésekre az Excel-fájlban

Az alábbiakban egy strukturált QnA .xls-fájl látható, amely több alternatív kérdést is megválaszol egyetlen válaszhoz:

Example of alternate questions for single answer in Excel file

A fájl importálása után a kérdés-válasz pár az alábbi tudásbázis található:

Screenshot of alternate questions for single answer imported into knowledge base

Strukturált adatformátum importálással

A tudásbázis importálása lecseréli a meglévő tudásbázis tartalmát. Az importáláshoz olyan strukturált .tsv-fájl szükséges, amely adatforrás-információkat tartalmaz. Ez az információ segít a QnA Makernek csoportosítani a kérdés-válasz párokat, és hozzárendelni őket egy adott adatforráshoz. A QnA-párok opcionális metaadatmezővel rendelkeznek, amellyel kategóriákba csoportosíthatók a QnA-párok.

Question Answer Source Metaadatok (1 kulcs: 1 érték)
1. kérdés Válasz1 URL1 Key1:Value1 | Key2:Value2
2. kérdés Válasz2 Szerkesztői Key:Value

Többfordulós dokumentumformázás

  • A hierarchia jelöléséhez használjon címsorokat és alfejléceket. A h1 például a szülő QnA-t és a h2-t jelölheti a kérdésként felveendő QnA jelöléséhez. A következő hierarchia jelöléséhez használjon kis címsorméretet. Ne használjon stílust, színt vagy más mechanizmust a dokumentum strukturálására, a QnA Maker nem fogja kinyerni a többfordulós kéréseket.
  • A címsor első karakterét nagybetűsre kell tenni.
  • Ne fejezz be egy címsort kérdőjellel, ?.

Mintadokumentumok:
Surface Pro (docx)
Contoso-előnyök (docx)
Contoso előnyök (pdf)

Gyakori kérdések URL-címei

A QnA Maker három különböző formában támogatja a GYIK-weblapokat:

  • Egyszerű GYIK-oldalak
  • Gyik oldalak hivatkozásokkal
  • Gyakori kérdések lapjai témakörök kezdőlapjával

Egyszerű GYIK-oldalak

Ez a gyakori kérdések leggyakoribb típusa, amelyben a válaszok azonnal követik az ugyanazon az oldalon található kérdéseket.

Az alábbiakban egy egyszerű GYIK-lap látható:

Plain FAQ page example for a knowledge base

Az ilyen típusú GYIK-lapon a kérdések összesítve jelennek meg, és az ugyanazon lap különböző szakaszaiban vagy különböző oldalakon található válaszokhoz vannak csatolva.

Az alábbiakban látható egy példa egy gyakori kérdések lapra, amely az ugyanazon az oldalon található szakaszokban található hivatkozásokat tartalmazza:

Section Link FAQ page example for a knowledge base

Az ilyen típusú GYIK-hez tartozik egy Témakörök lap, ahol minden témakör egy másik oldalon lévő kérdések és válaszok megfelelő készletéhez van csatolva. A QnA Maker bejárja az összes csatolt oldalt, hogy kinyerje a megfelelő kérdéseket és válaszokat.

Az alábbiakban egy példa látható egy Témakörök lapra, amelyen a különböző oldalakon található GYAKORI KÉRDÉSEK szakaszokra mutató hivatkozások találhatók.

Deep link FAQ page example for a knowledge base

Támogatási URL-címek

A QnA Maker képes részben strukturált támogatási weblapokat feldolgozni, például olyan webcikkeket, amelyek leírják egy adott feladat elvégzését, egy adott probléma diagnosztizálására és megoldására vonatkozó útmutatókat, valamint az adott folyamat ajánlott eljárásait. A kinyerés a hierarchikus címsorokkal egyértelmű struktúrával rendelkező tartalmakon működik a legjobban.

Megjegyzés:

A támogatási cikkek kinyerése egy új funkció, és korai fázisban van. Az egyszerű, jól strukturált, összetett élőfejeket/élőlábakat nem tartalmazó oldalakhoz működik a legjobban.

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

Tudásbázis importálása és exportálása

Az exportált tudásbázis TSV- és XLS-fájlok csak a QnA Maker portál Gépház oldaláról importálhatók. Nem használhatók adatforrásként tudásbázis létrehozásakor, illetve a + Fájl hozzáadása vagy + URL-cím hozzáadása funkcióból a Gépház lapon.

Amikor ezen TSV- és XLS-fájlokon keresztül importálja a tudásbázist, a QnA-párok a szerkesztői forráshoz lesznek hozzáadva, és nem azokhoz a forrásokhoz, amelyekből a QnA-k ki lettek nyerve az exportált tudásbázisban.

További lépések

Tartalomtípusok és példák teljes listájának megtekintése