Format Markdown pris en charge dans le texte de réponse QnA Maker
QnA Maker stocke le texte de réponse au format Markdown. Il existe plusieurs saveurs de Markdown. Pour vérifier que le texte de réponse est retourné et correctement affiché, utilisez cette référence.
Utilisez le tutoriel CommonMark pour valider votre Markdown. Ce tutoriel a une fonctionnalité Essayer pour la validation rapide de copier/coller.
Choisir entre la modification de texte enrichi et Markdown
Modifier le texte enrichi de réponses vous permet, en tant qu’auteur, d’utiliser une barre d’outils de mise en forme pour sélectionner le texte et le mettre en forme rapidement.
Markdown est un outil plus approprié quand vous devez générer automatiquement du contenu pour créer des bases de connaissances à importer dans le cadre d’un pipeline CI/CD ou pour des tests par lots.
Format Markdown pris en charge
Voici la liste des formats Markdown que vous pouvez utiliser dans le texte de réponse de QnA Maker.
Objectif | Format | Exemple de Markdown | Rendu tel qu’il est affiché dans le bot de chat |
---|---|---|---|
Nouvelle ligne entre 2 phrases. | \n\n |
How can I create a bot with \n\n QnA Maker? |
|
En-têtes de H1 à H6. Le nombre de # dénote de quel en-tête il s’agit. 1 # correspond à 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 |
|
Italique | *text* |
How do I create a bot with *QnA Maker*? |
|
Fort (gras) | **text** |
How do I create a bot with **QnA Maker**? |
|
URL du lien | [text](https://www.my.com) |
How do I create a bot with [QnA Maker](https://www.qnamaker.ai)? |
|
*URL pour l’image publique | ![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) |
|
Barré | ~~text~~ |
some ~~questoins~~ questions need to be asked |
|
Gras et italique | ***text*** |
How can I create a ***QnA Maker*** bot? |
|
URL en gras pour le lien | [**text**](https://www.my.com) |
How do I create a bot with [**QnA Maker**](https://www.qnamaker.ai)? |
|
URL en italiques pour le lien | [*text*](https://www.my.com) |
How do I create a bot with [*QnA Maker*](https://www.qnamaker.ai)? |
|
Ajouter un caractère d’échappement devant les symboles Markdown | \*text\* |
How do I create a bot with \*QnA Maker\*? |
|
Liste triée | \n 1. item1 \n 1. item2 |
This is an ordered list: \n 1. List item 1 \n 1. List item 2 L’exemple précédent utilise la numérotation automatique intégrée au Markdown. This is an ordered list: \n 1. List item 1 \n 2. List item 2 L’exemple précédent utilise la numérotation explicite. |
|
Liste non triée | \n * item1 \n * item2 or \n - item1 \n - item2 |
This is an unordered list: \n * List item 1 \n * List item 2 |
|
Listes imbriquées | \n * Parent1 \n\t * Child1 \n\t * Child2 \n * Parent2 \n * Parent1 \n\t 1. Child1 \n\t * Child2 \n 1. Parent2 Vous pouvez imbriquer des listes triées et non triées ensemble. L’onglet, \t , indique le niveau de mise en retrait de l’élément enfant. |
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 |
*QnA Maker ne traite pas du tout l’image. C’est le rôle de l’application cliente d’effectuer le rendu de l’image.
Si vous souhaitez ajouter du contenu à l’aide des API de mise à jour ou de remplacement de la base de connaissances, et si le contenu ou le fichier contiennent des balises HTML, vous pouvez conserver le code HTML de votre fichier en veillant à ce que l’ouverture et la fermeture des balises soient converties au format encodé.
Conserver le code HTML | Représentation de la requête d’API | Représentation dans la base de connaissances |
---|---|---|
Oui | < br> | <br> |
Oui | < h3> header | <h3>header</h3> |
En outre, CR LF (\r\n) est converti en \n dans la base de connaissances. LF (\n) est conservé tel quel. Si vous souhaitez échapper une séquence d’échappement telle que \t ou \n, vous pouvez utiliser la barre oblique inverse, par exemple : « \\r\\n » et « \\t ».
Étapes suivantes
Passez en revue les formats de fichiers des tests par lots.