Richtlijnen voor aangepaste vraagantwoorden opmaken

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

Overwegingen voor opmaak

Nadat u een bestand of URL hebt geïmporteerd, worden aangepaste vragen die beantwoorden, geconverteerd en opgeslagen 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 projectinhoud te beheren.

Als u inhoud rechtstreeks aan uw project 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. Aangepaste vraagantwoorden ondersteunen 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.

Basisdocumentopmaak

Aangepaste vraagantwoorden 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 aangepaste vragen beantwoorden 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 project

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 vraagantwoordparen 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 ervan 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 project

Notitie

QnA-paren worden niet geëxtraheerd op het tabblad Bronnen bewerken voor ongestructureerde bronnen.

Belangrijk

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

Gestructureerd aangepast antwoorddocument voor aangepaste vragen

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 gestructureerde aangepaste vraag die word-document beantwoordt:

Structured custom question answering document example for a project

Gestructureerde TXT-, TSV- en XLS-bestanden

Aangepaste vraagantwoorden in de vorm van gestructureerde .txt-, .tsv- of .xls-bestanden kunnen ook worden geüpload naar aangepaste vraagantwoorden om een project te maken of te verbeteren. Dit kan tekst zonder opmaak zijn of kan inhoud bevatten in RTF of HTML. Vraag-antwoordparen hebben een optioneel metagegevensveld dat kan worden gebruikt om vraagantwoordparen 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.

Gestructureerde gegevensindeling via importeren

Als u een project importeert, wordt de inhoud van het bestaande project vervangen. Importeren vereist een gestructureerd .tsv-bestand dat gegevensbrongegevens bevat. Met deze informatie kunt u de vraag-antwoordparen groeperen en deze aan een bepaalde gegevensbron toewijzen. Vraag-antwoordparen hebben een optioneel metagegevensveld dat kan worden gebruikt om vraagantwoordparen te groeperen in categorieën. De importindeling moet vergelijkbaar zijn met de geëxporteerde KnowledgeBase-indeling.

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

Documentopmaak met meerdere draaiing

  • Gebruik koppen en subkoppen om de hiërarchie aan te geven. U kunt bijvoorbeeld h1 om het antwoord van de bovenliggende vraag aan te geven en h2 om het vraagantwoord aan te geven dat 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. Bij aangepaste vragen beantwoorden worden de prompts met meerdere keren niet geëxtraheerd.
  • 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

Aangepaste vragen beantwoorden 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.

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 project

Dit type veelgestelde vragen heeft een pagina Onderwerpen waarin elk onderwerp is gekoppeld aan een bijbehorende set vragen en antwoorden op een andere pagina. Vraagantwoord 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 project

Ondersteunings-URL's

Aangepaste vraagantwoorden kunnen semi-gestructureerde ondersteuningswebpagina's verwerken, zoals webartikelen die beschrijven hoe een bepaalde taak moet worden uitgevoerd, hoe een bepaald probleem kan worden vastgesteld en opgelost, 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.

Project importeren en exporteren

TSV- en XLS-bestanden, uit geëxporteerde projecten, kunnen alleen worden gebruikt door de bestanden te importeren van de pagina Instellingen in Language Studio. Ze kunnen niet worden gebruikt als gegevensbronnen tijdens het maken van projecten of vanuit de functie + Bestand toevoegen of + URL toevoegen op de Instellingen pagina.

Wanneer u het project importeert via deze TSV- en XLS-bestanden, worden de vraagantwoordparen toegevoegd aan de redactionele bron en niet aan de bronnen waaruit de vraag en antwoorden zijn geëxtraheerd in het geëxporteerde project.

Volgende stappen