.qna dosya biçimi
ŞUNLAR IÇIN GEÇERLIDIR: SDK v4
Dekont
Azure Yapay Zeka Soru-Cevap Oluşturma 31 Mart 2025 tarihinde kullanımdan kaldırılacaktır. 1 Ekim 2022 tarihinden itibaren yeni QnA Maker kaynakları veya bilgi bankası makaleleri oluşturamazsınız. Soru ve yanıtlama özelliğinin daha yeni bir sürümü artık Azure AI Dili'nin bir parçası olarak kullanılabilir.
Azure AI Dili'nin bir özelliği olan özel soru yanıtlama, Soru-Cevap Oluşturma hizmetinin güncelleştirilmiş sürümüdür. Bot Framework SDK'sında soru-cevap desteği hakkında daha fazla bilgi için bkz . Doğal dil anlama.
.qna dosyaları, QnAmaker.ai kavramları için Markdown benzeri metin tabanlı tanımlar içerir. Bu makale, .qna dosya biçimiyle ifade edilen çeşitli kavramları kapsar.
Açıklama ekleme
Açıklama oluşturmak için kullanın > . Bir örnek aşağıda verilmiştir:
> This is a comment and will be ignored
Soru ve Yanıt çiftleri
.qna dosyası ve ayrıştırıcı soru ve yanıt tanımlarını destekler.
Temel bir soru ve yanıt tanımının söz dizimi aşağıdadır:
# ? Question
[list of question variations]
```
Answer
```
Soru ve yanıt tanımlarının örnekleri aşağıda verilmiştir:
> # 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
```
için tür tanımlayıcısının markdownanswer isteğe bağlı olduğunu unutmayın.
Birden çok soru
Yalnızca sorulara çeşitlemeler ekleyerek aynı yanıta birden çok soru ekleyebilirsiniz.
### ? Aren't you feeling happy today?
- Feeling cheerful?
```markdown
I'm quite happy, thank you.
```
Soru-Cevap Oluşturma Filtreleri
Soru-Cevap Oluşturma'daki filtreler, arama sonuçlarını daraltmak, yanıtları artırmak ve bağlamı depolamak için kullanılabilen basit anahtar-değer çiftleridir.
Filtre eklemek için aşağıdaki söz dizimini kullanın:
***Filters:***
- name = value
- name = value
Bir filtrenin nasıl kullanılabileceğini gösteren bir örnek aşağıda verilmişti:
### ? 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
```
Soru-Cevap Oluşturma PDF dosyası alımı
Soru-Cevap Oluşturma, KB oluşturma sırasında PDF dosyalarının alımını da destekler. URL başvuru düzenini kullanarak Soru-Cevap Oluşturma'nın alma işlemine yönelik dosyalar ekleyebilirsiniz. URI'nin içerik türü metin veya HTML değilse, ayrıştırıcı bunu Soru-Cevap Oluşturma'nın alacağı dosya koleksiyonuna ekler.
[SurfaceManual.pdf](https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf)
Harici referanslar
Dış başvurular .qna dosyasında desteklenir ve Markdown bağlantı söz dizimini kullanır.
Başka bir .qna dosyasına başvurma
kullanarak [link name](<.qna file name>)başka bir .qna dosyasına başvuru. Başvurular, mutlak bir yol veya içeren .qna dosyasından göreli bir yol olabilir.
.qna dosyalarını içeren bir klasöre başvuru
Diğer .qna dosyalarına sahip bir klasöre başvuru şu şekilde desteklenir:
[link name](<.qna file path>/*): belirtilen mutlak veya göreli yol altında .qna dosyalarını arar.[link name](<.qna file path>/**): alt klasörler de dahil olmak üzere belirtilen mutlak veya göreli yol altında .qna dosyalarını özyinelemeli olarak arar.
URL'ye başvurma
aracılığıyla [link name](<URL>)KB oluşturma sırasında almak üzere QnAMaker URL'sine başvurun.
Belirli bir dosyadan başvuru
Ayrıca, amaç bölümü altında veya Soru-Cevap çiftleri olarak belirli bir dosyada tanımlanan ifadelere başvurular ekleyebilirsiniz.
[link name](<.lu file path>#<INTENT-NAME>): .lu dosyasında INTENT-NAME> altında <bulunan tüm ifadeleri bulur ve başvurunun belirtildiği soru listesine ekler.[link name](<.lu file path>#*utterances*): .lu dosyasındaki tüm konuşmaları bulur ve başvurunun belirtildiği sorular listesine ekler.[link name](<.qna file path>#?): .qna dosyasında tanımlanan tüm Soru-Cevap çiftlerinin sorularını bulur ve bunları bu başvurunun belirtildiği konuşmalar listesine ekler.[link name](<.qna folder>/*#?): belirtilen klasördeki tüm .qna dosyalarındaki tüm soruları bulur ve bunları bu başvurunun belirtildiği konuşmalar listesine ekler.
Yukarıdaki başvurulara bir örnek aşağıda verilmiştir:
> 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/**)
Model açıklaması
Ayrıştırıcıyı LU içeriğini doğru işlemeye yönlendirmeye yardımcı olmak için .qna dosyasına LUIS uygulamanızın veya Soru-Cevap Oluşturma KB'sinin yapılandırma bilgilerini ekleyebilirsiniz.
Dekont
Language Understanding (LUIS) 1 Ekim 2025'te kullanımdan kaldırılacaktır. 1 Nisan 2023'e kadar yeni LUIS kaynakları oluşturamayacaksınız. Dil anlamanın daha yeni bir sürümü artık Azure AI Dili'nin bir parçası olarak kullanılabilir.
Azure AI Dili'nin bir özelliği olan konuşma dili anlama (CLU), LUIS'in güncelleştirilmiş sürümüdür. Bot Framework SDK'sında dil anlama desteği hakkında daha fazla bilgi için bkz . Doğal dil anlama.
Yapılandırma bilgilerinin nasıl ekleneceği burada anlatılmıştır > !#:
> !# @<property> = <value>
> !# @<scope>-<property> = <value>
> !# @<scope>-<property> = <semicolon-delimited-key-value-pairs>
CLI bağımsız değişkenleri aracılığıyla açıkça geçirilen tüm bilgilerin .qna dosyasındaki bilgileri geçersiz kılacağını unutmayın.
> 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>
Çok kanallı içerik
Çok kanallı içerik Markdown bağlantı gösterimi kullanılarak .qna biçiminde temsil edilir. Bağlantılar aşağıdaki şekilde belirtilir:
- [display text](#<ID or question>)
İsteğe bağlı olarak yalnızca bir soru için bağlamsal olarak kullanılabilen tüm istemleri ekleyebilirsiniz context-only . kullanımı contexthakkında daha fazla bilgi edinmek için mevcut soru-cevap çiftini izleme istemi olarak ekleme hakkındaki bölümü okuyun.
- [tell me a joke](#?joke) `context-only`
İzleme istemleri
Geliştiricilerin izleme istemleri oluşturmak için iki seçeneği vardır: bir soruyu doğrudan izleme istemi olarak kullanma veya soru-cevap çiftine açık kimlik atama.
Doğrudan soru kullanma
Bağlantı metninin olduğu question ilk Soru-Cevap çifti, istem olarak eklenir. Daha açık bir denetime ihtiyacınız varsa, bunun yerine kimlikleri kullanın.
Doğrudan bir soru kullanırken Markdown kuralını kullanın ve boşlukları kısa çizgilerle değiştirin (örneğin, yerine #?when is the portland store openkullanın#?when-is-the-portland-store-open). Ayrıştırıcı bağlantıyı bulmak için en iyisini yapar.
# ?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.
```
Bahşiş
Bu bağlantı çoğu Markdown işleyicisinde seçilebilir bağlantı olarak işlenmez.
Soru-Cevap çiftine açık kimlik atama
Her istem için bir sayı ile kimlikler atayın. Aşağıdaki örnekte her depoya farklı bir sayısal değer atandığını görebilirsiniz.
# ?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.
```
Ek Kaynaklar
- .lu dosya biçimi hakkında bilgi için bkz. .lu dosya biçimi.