.qna fájlformátum
A KÖVETKEZŐKRE VONATKOZIK: SDK v4
Megjegyzés:
Az Azure AI QnA Maker 2025. március 31-én megszűnik. 2022. október 1-től nem hozhat létre új QnA Maker-erőforrásokat vagy tudásbázis. A kérdés- és válaszképesség újabb verziója már elérhető az Azure AI Language részeként.
Az Egyéni kérdések megválaszolása, az Azure AI Nyelv egyik funkciója a QnA Maker szolgáltatás frissített verziója. A Bot Framework SDK kérdés-válasz támogatásával kapcsolatos további információkért lásd a természetes nyelv megértését.
A .qna-fájlok Markdown-szerű szövegalapú definíciókat tartalmaznak QnAmaker.ai fogalmakhoz. Ez a cikk a .qna fájlformátumban kifejezett különböző fogalmakat ismerteti.
Megjegyzések hozzáadása
Megjegyzés létrehozásához használható > . Here's an example:
> This is a comment and will be ignored
Kérdés- és válaszpárok
A .qna fájl és elemző támogatja a kérdés- és válaszdefiníciókat.
Egy alapszintű kérdés- és válaszdefiníció szintaxisa:
# ? Question
[list of question variations]
```
Answer
```
Az alábbiakban példákat talál a kérdés- és válaszdefiníciókra:
> # QnA Definitions
### ? who is the ceo?
```
You can change the default message if you use the QnAMakerDialog.
For details, see [Azure AI Bot Service documentation](/articles/adaptive-dialog/adaptive-dialog-prebuilt-actions.md).
```
### ? How do I programmatically update my KB?
```
You can use our REST apis to manage your KB.
\#1. See here for details: https://westus.dev.cognitive.microsoft.com/docs/services/58994a073d9e04097c7ba6fe/operations/58994a073d9e041ad42d9baa
```
Vegye figyelembe, hogy egy markdown típusazonosító answer nem kötelező.
Több kérdés
Több kérdést is hozzáadhat ugyanahhoz a válaszhoz, ha egyszerűen variációkat ad hozzá a kérdésekhez.
### ? Aren't you feeling happy today?
- Feeling cheerful?
```markdown
I'm quite happy, thank you.
```
QnAMaker-szűrők
A QnA Maker szűrői egyszerű kulcs-érték párok, amelyek a keresési eredmények szűkítésére, a válaszok kiemelésére és a környezet tárolására használhatók.
Szűrők hozzáadásához használja az alábbi szintaxist:
***Filters:***
- name = value
- name = value
Íme egy példa a szűrő használatára:
### ? Where can I get coffee?
- I need coffee
**Filters:**
- location = seattle
```markdown
You can get coffee in our Seattle store at 1 pike place, Seattle, WA
```
### ? Where can I get coffee?
- I need coffee
**Filters:**
- location = portland
```markdown
You can get coffee in our Portland store at 52 marine drive, Portland, OR
```
QnA Maker PDF-fájlbetöltés
A QnA Maker a PDF-fájlok betöltését is támogatja a TUDÁSBÁZIS létrehozása során. Az URL-referenciasémával fájlokat adhat hozzá a QnA Makerhez a betöltéshez. Ha az URI tartalomtípusa nem szöveg vagy HTML, akkor az elemző hozzáadja azt a QnA Maker fájlgyűjteményéhez a betöltéshez.
[SurfaceManual.pdf](https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf)
Külső hivatkozások
A külső hivatkozások támogatottak a .qna fájlban, és a Markdown-hivatkozás szintaxisát használják.
Hivatkozás egy másik .qna-fájlra
Hivatkozás egy másik .qna fájlra a használatával [link name](<.qna file name>). A hivatkozások lehetnek abszolút elérési utak vagy relatív elérési utak a .qna fájlt tartalmazó fájlból.
Hivatkozás .qna fájlokat tartalmazó mappára
Más .qna fájlokat tartalmazó mappára való hivatkozás a következőkkel támogatott:
[link name](<.qna file path>/*): .qna fájlokat keres a megadott abszolút vagy relatív elérési út alatt.[link name](<.qna file path>/**): rekurzívan keres .qna fájlokat a megadott abszolút vagy relatív elérési út alatt, beleértve az almappákat is.
HIVATKOZÁS URL-címre
Hivatkozzon a QnAMaker URL-címére, amely a KB létrehozása [link name](<URL>)során betöltendő.
Hivatkozás adott fájlból
Egy adott fájlban meghatározott kimondott szövegekre mutató hivatkozásokat is hozzáadhat egy szándékszakaszban vagy QnA-párként.
[link name](<.lu file path>#<INTENT-NAME>): megkeresi az INTENT-NAME> fájlban <található összes kimondott szöveget a .lu fájlban, és hozzáadja őket azoknak a kérdéseknek a listájához, ahol a hivatkozás meg van adva.[link name](<.lu file path>#*utterances*): megkeresi a .lu fájl összes kimondott szövegét, és hozzáadja azokat a kérdések listájához, ahol a hivatkozás meg van adva.[link name](<.qna file path>#?): megkeresi a .qna fájlban definiált összes QnA-pár kérdéseit, és hozzáadja őket azoknak a kimondott szövegeknek a listájához, ahol ez a hivatkozás meg van adva.[link name](<.qna folder>/*#?): megkeresi a megadott mappában lévő összes .qna-fájl összes kérdését, és hozzáadja őket azoknak a kimondott szövegeknek a listájához, ahol a hivatkozás meg van adva.
Íme egy példa a fenti hivatkozásokra:
> QnA URL reference
[QnaURL](/azure/ai-services/qnamaker/)
> Include all content in ./kb1.qna
[KB1](./kb1.qna)
> Look for all .qna files under a path
[ChitChat](./chitchat/*)
> Recursively look for .qna files under a path including subfolders.
[ChitChat](../chitchat/resources/**)
Modell leírása
A LUIS-alkalmazás vagy a QnA Maker KB konfigurációs adatait a .qna fájlban is megadhatja, hogy az elemző megfelelően kezelje a LU-tartalmat.
Megjegyzés:
A Language Understanding (LUIS) 2025. október 1-jén megszűnik. 2023. április 1-től nem hozhat létre új LUIS-erőforrásokat. Az Azure AI Language részeként már elérhető a nyelvértés újabb verziója.
Az Azure AI Language egyik funkciója, a beszélgetési nyelv megértése (CLU) a LUIS frissített verziója. További információ a Bot Framework SDK nyelvfelismerési támogatásáról: Természetes nyelvfelismerés.
Így adhat hozzá konfigurációs információkat a > következőhöz: !#:
> !# @<property> = <value>
> !# @<scope>-<property> = <value>
> !# @<scope>-<property> = <semicolon-delimited-key-value-pairs>
Vegye figyelembe, hogy a parancssori felület argumentumaival explicit módon átadott információk felülbírálják a .qna fájlban található információkat.
> Parser instruction - this is optional; unless specified, the parser will default to the latest version.
> !# @version = 1.0
> QnA Maker KB description
> !# @kb.name = my qna maker kb name
> Source for a specific QnA pair
> !# @qna.pair.source = <source value>
Többturnos tartalom
A többturnos tartalom .qna formátumban jelenik meg Markdown-hivatkozás jelöléssel. A hivatkozások a következő módon vannak megadva:
- [display text](#<ID or question>)
Opcionálisan megadhat context-only minden olyan kérdést, amely csak kontextusban érhető el egy kérdéshez. Ha többet szeretne megtudni a használatrólcontext, olvassa el azt a szakaszt, amely egy meglévő kérdés- és válaszpárt ad hozzá követő kérdés-válasz párként.
- [tell me a joke](#?joke) `context-only`
Nyomon követési kérdések
A fejlesztők kétféleképpen hozhatnak létre nyomon követési utasításokat: kérdést közvetlenül követési kérdésként, vagy explicit azonosítót rendelnek hozzá egy QnA-párhoz.
Kérdés közvetlen használata
Az első QnA-pár, amely a hivatkozás szövegét question tartalmazza, a rendszer kéri. Ha explicitebb vezérlésre van szüksége, használjon azonosítókat .
Ha közvetlenül egy kérdést használ, használja a Markdown-konvenciók használatát, és cserélje le a szóközöket kötőjelekre (például használjon #?when-is-the-portland-store-open helyett).#?when is the portland store open Az elemző a lehető legjobban meg fogja találni a hivatkozást.
# ?store hours
```
Most our stores are open M-F 9AM-10PM.
```
**Prompts:**
- [Seattle store](#?seattle)
- [Portland store](#?when-is-the-portland-store-open)
# ?seattle
```
The Seattle store is open M-F 9AM-10PM.
```
# ?when is the portland store open
- portland store hours
```
The Portland store is open 24/7.
```
Tipp.
A hivatkozás valójában nem jeleníthető meg választható hivatkozásként a legtöbb Markdown-renderelőben.
Explicit azonosító hozzárendelése QnA-párhoz
Azonosítók hozzárendelése minden egyes kérdéshez számmal. Az alábbi példában látható, hogy az egyes áruházakhoz eltérő numerikus érték lett hozzárendelve.
# ?store hours
```
Most our stores are open M-F 9AM-10PM.
```
**Prompts:**
- [Seattle store](#1)
- [Portland store](#2)
<a id = "1"></a>
# ?seattle
```
The Seattle store is open M-F 9AM-10PM.
```
<a id = "2"></a>
# ?when is the portland store open
- portland store hours
```
The Portland store is open 24/7.
```
További források
- A .lu fájlformátummal kapcsolatos információkért tekintse meg a .lu fájlformátumot.