Richtlijnen voor opmaak voor geïmporteerde documenten en URL's

Bekijk deze opmaakrichtlijnen om de beste resultaten voor uw inhoud te krijgen.

Overwegingen voor opmaak

Na het importeren van een bestand of URL converteert QnA Maker uw inhoud en slaat deze op in de Markdown-indeling. Met het conversieproces worden nieuwe regels in de tekst toegevoegd, zoals \n\n. Een kennis van de Markdown-indeling helpt u de geconverteerde inhoud te begrijpen en uw Knowledge Base-inhoud te beheren.

Als u uw inhoud rechtstreeks in uw Knowledge Base toevoegt of bewerkt, gebruikt u markdown-opmaak om inhoud met opmaak te maken of de inhoud van de Markdown-indeling te wijzigen die al in het antwoord staat. QnA Maker ondersteunt veel van de Markdown-indeling om rtf-tekstmogelijkheden toe te voegen aan uw inhoud. De clienttoepassing, zoals een chatbot, ondersteunt echter mogelijk niet dezelfde set markdown-indelingen. Het is belangrijk om de weergave van antwoorden van de clienttoepassing te testen.

Bekijk een volledige lijst met inhoudstypen en voorbeelden.

Basisdocumentopmaak

QnA Maker identificeert secties en subsecties en relaties in het bestand op basis van visuele aanwijzingen zoals:

  • Tekengrootte
  • Tekenstijl
  • Nummering
  • Kleuren

Notitie

We bieden momenteel geen ondersteuning voor het extraheren van afbeeldingen uit geüploade documenten.

Producthandleidingen

Een handleiding is doorgaans hulpmateriaal dat bij een product hoort. Hiermee kan de gebruiker het product instellen, gebruiken, onderhouden en problemen oplossen. Wanneer QnA Maker een handleiding verwerkt, worden de koppen en subkoppen geëxtraheerd als vragen en de volgende inhoud als antwoorden. Bekijk hier een voorbeeld.

Hieronder ziet u een voorbeeld van een handleiding met een indexpagina en hiërarchische inhoud

Product Manual example for a knowledge base

Notitie

Extractie werkt het beste voor handleidingen met een inhoudsopgave en/of een indexpagina en een duidelijke structuur met hiërarchische koppen.

Brochures, richtlijnen, documenten en andere bestanden

Veel andere typen documenten kunnen ook worden verwerkt om QA-paren te genereren, mits ze een duidelijke structuur en indeling hebben. Deze omvatten: Brochures, richtlijnen, rapporten, whitepapers, wetenschappelijke documenten, beleid, boeken, enzovoort. Bekijk hier een voorbeeld.

Hieronder ziet u een voorbeeld van een semi-gestructureerd document, zonder een index:

Azure Blob storage semi-structured Doc

Ondersteuning voor ongestructureerde documenten

Aangepaste vraagantwoorden ondersteunen nu ongestructureerde documenten. Een document dat de inhoud niet op een goed gedefinieerde hiërarchische manier heeft georganiseerd, een setstructuur ontbreekt of de inhoud vrije stroom heeft, kan worden beschouwd als een ongestructureerd document.

Hieronder ziet u een voorbeeld van een ongestructureerd PDF-document:

Unstructured document example for a knowledge base

Deze functionaliteit is momenteel alleen beschikbaar via het uploaden van documenten en alleen voor PDF- en DOC-bestandsindelingen.

Belangrijk

Ondersteuning voor ongestructureerde bestanden/inhoud is alleen beschikbaar bij het beantwoorden van vragen.

Gestructureerd QnA-document

De indeling voor gestructureerde vraag-antwoorden in DOC-bestanden heeft de vorm van afwisselende vragen en antwoorden per regel, één vraag per regel gevolgd door het antwoord in de volgende regel, zoals hieronder wordt weergegeven:

Question1

Answer1

Question2

Answer2

Hieronder ziet u een voorbeeld van een gestructureerd QnA Word-document:

Structured QnA document example for a knowledge base

Gestructureerde TXT-, TSV- en XLS-bestanden

QnA's in de vorm van gestructureerde .txt-, .tsv - of .xls-bestanden kunnen ook worden geüpload naar QnA Maker om een knowledge base te maken of uit te breiden. Dit kan tekst zonder opmaak zijn of kan inhoud bevatten in RTF of HTML. QnA-paren hebben een optioneel metagegevensveld dat kan worden gebruikt om QnA-paren te groeperen in categorieën.

Vraag Antwoord Metagegevens (1 sleutel: 1 waarde)
Vraag1 Antwoord1 Key1:Value1 | Key2:Value2
Vraag2 Answer2 Key:Value

Eventuele extra kolommen in het bronbestand worden genegeerd.

Voorbeeld van gestructureerd Excel-bestand

Hieronder ziet u een voorbeeld van een gestructureerd QnA XLS-bestand met HTML-inhoud:

Structured QnA excel example for a knowledge base

Voorbeeld van alternatieve vragen voor één antwoord in excel-bestand

Hieronder ziet u een voorbeeld van een gestructureerd QnA .xls-bestand , met verschillende alternatieve vragen voor één antwoord:

Example of alternate questions for single answer in Excel file

Nadat het bestand is geïmporteerd, bevindt het vraag-en-antwoordpaar zich in de knowledge base, zoals hieronder wordt weergegeven:

Screenshot of alternate questions for single answer imported into knowledge base

Gestructureerde gegevensindeling via importeren

Als u een knowledge base importeert, wordt de inhoud van de bestaande knowledge base vervangen. Importeren vereist een gestructureerd .tsv-bestand dat gegevensbrongegevens bevat. Deze informatie helpt QnA Maker de vraag-antwoordparen te groeperen en deze toe te passen aan een bepaalde gegevensbron. QnA-paren hebben een optioneel metagegevensveld dat kan worden gebruikt om QnA-paren te groeperen in categorieën.

Vraag Antwoord Bron Metagegevens (1 sleutel: 1 waarde)
Vraag1 Antwoord1 URL1 Key1:Value1 | Key2:Value2
Vraag2 Answer2 Redactionele informatie Key:Value

Documentopmaak met meerdere draaiing

  • Gebruik koppen en subkoppen om de hiërarchie aan te geven. U kunt bijvoorbeeld h1 om de bovenliggende QnA en h2 aan te geven om de QnA aan te geven die als prompt moet worden beschouwd. Gebruik kleine kopgrootte om de volgende hiërarchie aan te geven. Gebruik geen stijl, kleur of een ander mechanisme om structuur in uw document te impliceren. QnA Maker extraheert de prompts met meerdere keren niet.
  • Het eerste teken van de kop moet een hoofdletter hebben.
  • Beëindig een kop niet met een vraagteken. ?

Voorbeelddocumenten:
Surface Pro (docx)
Contoso Benefits (docx)
Contoso Benefits (pdf)

Veelgestelde vragen OVER URL's

QnA Maker kan webpagina's met veelgestelde vragen in drie verschillende formulieren ondersteunen:

  • Pagina's met veelgestelde vragen
  • Veelgestelde vragen over pagina's met koppelingen
  • Veelgestelde vragen over pagina's met een startpagina met onderwerpen

Pagina's met veelgestelde vragen

Dit is het meest voorkomende type veelgestelde vragenpagina, waarin de antwoorden direct de vragen op dezelfde pagina volgen.

Hieronder ziet u een voorbeeld van een pagina met veelgestelde vragen:

Plain FAQ page example for a knowledge base

In dit type pagina met veelgestelde vragen worden vragen samengevoegd en gekoppeld aan antwoorden die zich in verschillende secties van dezelfde pagina of op verschillende pagina's bevinden.

Hieronder ziet u een voorbeeld van een pagina met veelgestelde vragen met koppelingen in secties die zich op dezelfde pagina bevinden:

Section Link FAQ page example for a knowledge base

Dit type veelgestelde vragen heeft een pagina Onderwerpen waarin elk onderwerp is gekoppeld aan een bijbehorende set vragen en antwoorden op een andere pagina. QnA Maker verkent alle gekoppelde pagina's om de bijbehorende vragen en antwoorden te extraheren.

Hieronder ziet u een voorbeeld van een pagina Onderwerpen met koppelingen naar secties met veelgestelde vragen op verschillende pagina's.

Deep link FAQ page example for a knowledge base

Ondersteunings-URL's

QnA Maker kan semi-gestructureerde ondersteuningswebpagina's verwerken, zoals webartikelen waarin wordt beschreven hoe u een bepaalde taak uitvoert, hoe u een bepaald probleem kunt vaststellen en oplossen, en wat zijn de aanbevolen procedures voor een bepaald proces. Extractie werkt het beste voor inhoud met een duidelijke structuur met hiërarchische koppen.

Notitie

Extractie voor ondersteuningsartikelen is een nieuwe functie en bevindt zich in een vroeg stadium. Het werkt het beste voor eenvoudige pagina's, die goed gestructureerd zijn en geen complexe kop- en voetteksten bevatten.

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

Knowledge Base importeren en exporteren

TSV- en XLS-bestanden, uit geëxporteerde Knowledge Bases, kunnen alleen worden gebruikt door de bestanden te importeren vanaf de pagina Instellingen in de QnA Maker-portal. Ze kunnen niet worden gebruikt als gegevensbronnen tijdens het maken van een knowledge base of vanuit de functie + Bestand toevoegen of + URL toevoegen op de Instellingen pagina.

Wanneer u de Knowledge Base importeert via deze TSV- en XLS-bestanden, worden de QnA-paren toegevoegd aan de redactionele bron en niet aan de bronnen waaruit de QnA's zijn geëxtraheerd in de geëxporteerde Knowledge Base.

Volgende stappen

Bekijk een volledige lijst met inhoudstypen en voorbeelden