A QnA Maker válaszszövegében támogatott Markdown-formátum

A QnA Maker markdownként tárolja a válaszszöveget. A markdownnak számos íze van. A válasz szövegének helyes visszaadásához és helyes megjelenítéséhez használja ezt a hivatkozást.

A Markdown ellenőrzéséhez használja a CommonMark oktatóanyagot. Az oktatóanyag egy Kipróbálás funkcióval rendelkezik a gyors másolás/beillesztés ellenőrzéséhez.

Mikor érdemes rich-text szerkesztést használni a markdown helyett?

A válaszok rich-text szerkesztése lehetővé teszi, hogy a szerző egy formázási eszköztár használatával gyorsan kijelölje és formázza a szöveget.

A Markdown jobb eszköz, ha automatikusan létre kell hoznia a tartalmat a CI/CD-folyamat részeként importálandó tudásbázis létrehozásához vagy kötegelt teszteléshez.

Támogatott markdown formátum

Az alábbiakban felsoroljuk a QnA Maker válaszszövegében használható markdown-formátumokat.

Cél Format Markdown-példa Rendering
a Csevegőrobotban látható módon
Egy új sor 2 mondat között. \n\n How can I create a bot with \n\n QnA Maker? format new line between two sentences
Fejlécek a h1-től a h6-osig, a fejlécek száma # . 1 # a h1. \n# text \n## text \n### text \n####text \n#####text ## Creating a bot \n ...text.... \n### Important news\n ...text... \n### Related Information\n ....text...

\n# my h1 \n## my h2\n### my h3 \n#### my h4 \n##### my h5
format with markdown headers
format with markdown headers H1 to H5
Dőlt *text* How do I create a bot with *QnA Maker*? format with italics
Erős (félkövér) **text** How do I create a bot with **QnA Maker**? format with strong marking for bold
Hivatkozás URL-címe [text](https://www.my.com) How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? format for URL (hyperlink)
*Nyilvános rendszerkép URL-címe ![text](https://www.my.com/image.png) How can I create a bot with ![QnAMaker](https://review.learn.microsoft.com/azure/ai-services/qnamaker/media/qnamaker-how-to-key-management/qnamaker-resource-list.png) format for public image URL
Áthúzott ~~text~~ some ~~questoins~~ questions need to be asked format for strikethrough
Félkövér és dőlt ***text*** How can I create a ***QnA Maker*** bot? format for bold and italics
Félkövér URL-cím a hivatkozáshoz [**text**](https://www.my.com) How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? format for bold URL
Dőlt URL-cím a hivatkozáshoz [*text*](https://www.my.com) How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? format for italics URL
Escape markdown szimbólumok \*text\* How do I create a bot with \*QnA Maker\*? Format for escape markdown symbols.
Rendezett lista \n 1. item1 \n 1. item2 This is an ordered list: \n 1. List item 1 \n 1. List item 2
Az előző példa a markdownba beépített automatikus számozást használja.
This is an ordered list: \n 1. List item 1 \n 2. List item 2
Az előző példa explicit számozást használ.
format for ordered list
Rendezetlen listák \n * item1 \n * item2
vagy
\n - item1 \n - item2
This is an unordered list: \n * List item 1 \n * List item 2 format for unordered list
Beágyazott listák \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2

\n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2

A rendezett és rendezetlen listákat egymásba ágyazhatja. A tabulátor \ta gyermekelem behúzási szintjét jelzi.
This is an unordered list: \n * List item 1 \n\t * Child1 \n\t * Child2 \n * List item 2

This is an ordered nested list: \n 1. Parent1 \n\t 1. Child1 \n\t 1. Child2 \n 1. Parent2
format for nested unordered list
format for nested ordered list

*A QnA Maker semmilyen módon nem dolgozza fel a képet. A rendszerkép megjelenítéséhez az ügyfélalkalmazás feladata.

Ha tudásbázis API-k frissítésével/cseréjével szeretne tartalmat hozzáadni, és a tartalom/fájl HTML-címkéket tartalmaz, a html-kódot megőrizheti a fájlban úgy, hogy a címkék megnyitása és bezárása kódolt formátumban lesz konvertálva.

HTML megőrzése Reprezentáció az API-kérelemben Reprezentáció KB-ban
Igen < br> <Br>
Igen < h3> fejléc <h3>fejléc</h3>

Emellett a CR LF(\r\n) a KB-ban \n-re lesz konvertálva. Az LF(\n) a jelenlegi módon van megtartva. Ha meg szeretne szabadulni bármilyen menekülési sorozattól, például \t vagy \n, használhat fordított perjelet, például: "\\r\\n" és "\\\t"

További lépések

A kötegtesztelési fájlformátumok áttekintése.