Dil - Soru Yanıtlama
Dil - Soru Yanıtlama API'si, özel soru yanıtlama projelerine veya ham metne karşı yanıtlar oluşturmak için son teknoloji transformatör modelleriyle gelişmiş doğal dil işleme sağlayan bulut tabanlı bir hizmettir. Soru yanıtlama, Dil hizmetindeki, yapılandırılmamış belgeler için destek ve kesin yanıt gibi ek özelliklerle Soru-Cevap Oluşturma hizmetinden geliştirilmiş bir özelliktir.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - 21Vianet tarafından işletilen Çin Bulutu |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Çin bölgeleri |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - 21Vianet tarafından işletilen Çin Bulutu |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - 21Vianet tarafından işletilen Çin Bulutu |
| İletişim | |
|---|---|
| İsim | Soru Yanıtlama Desteği |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| E-posta | qnamakersupport@microsoft.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Microsot |
| Web sitesi | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| Gizlilik ilkesi | https://privacy.microsoft.com/en-us/privacystatement |
| Kategoriler | AI; Web sitesi |
Dil - Soru Yanıtlama Bağlayıcısı, Herhangi bir Power uygulamasını Dil hizmetindeki yeni Soru Yanıtlama özelliğimizle tümleştirmeye yönelik bir bağlayıcıdır. Bu bağlayıcı ile kullanıcılar artık yeniye ve Soru Yanıtlama'nın gelişmiş özelliklerine bağlanabilir. Bu bağlayıcıda kullanıcıların
- Projeden yanıtlar oluşturma
- Proje meta verilerini alma
- Belirli bir süre boyunca sağlanan metinlerden yanıtlar oluşturarak müşterilerimize daha fazla işlev sunmak için daha fazla eylem sunacağız.
Önkoşullar
Özel soru yanıtlama projesi oluşturmak için buradaki yönergeleri izleyin.
Kimlik bilgilerini alma
- Projenizi dağıtdıktan sonra "Tahmin URL'sini Al" seçeneğine tıklayın.
- Tahmin URL'sinin ana bilgisayar adından Site URL'nizi ve Ocp-Apim-Subscription-Key olan Hesap anahtarınızı alın.
- Hesap Anahtarınızı ve Site URL'nizi kullanarak bir bağlantı oluşturun.
Bağlayıcınızı kullanmaya başlama
Bağlayıcıyı akışta kullanma
-
Microsoft Power Automate'e gidin ve Oluştur'a tıklayın ve "Anlık Bulut akışı" öğesini seçin.
- Bu bağlayıcıyı test için "Akışı el ile tetikle" seçeneğine ve öğesine
Createtıklayabilirsiniz.
- "Yeni Adım"a tıklayın ve "Dil – Soru Yanıtlama" araması yapın ve üç eylem arasından seçim yapın.
Eylemler:
Projeden Yanıt Oluştur
- Bu eylem, projenizdeki bilgi bankanızı kullanarak belirtilen soruyu yanıtlamaya yardımcı olur.
- "Sample-project"
Projeden için bu sorguyu verebilirsiniz - İstek gövdesi hakkında buradan daha fazla bilgi edinin: Soru Yanıtlama - Yanıt Alma - REST API (Azure Bilişsel Hizmetler) | Microsoft Docs
Proje Meta Verilerini Alma
- Bu eylem, projenizin tüm meta verilerini almaya yardımcı olur.
- Projenizin meta verilerini almak için projenizin adını verin.
Sağlanan metinden yanıt oluşturma
- Bu eylem, sağlanan metni kullanarak belirtilen sorunun yanıtlanmasında yardımcı olur. Yalnızca bu eylemi kullanmak için Dil kaynağında Özel Soru Yanıtlama'nın etkinleştirilmemesi gerekir.
- Bu eylem, Özel Soru Yanıtlama Projesi gerektirmez. Yalnızca bir Dil kaynağı gerekir. Bir dil kaynağı oluşturabilir ve Azure portalındaki Anahtarlar ve Uç Nokta bölümünde sırasıyla Site URL'si ve Hesap Anahtarı'na uç noktanızı ve anahtarınızı kopyalayabilirsiniz.
- Sorgu " surface'ı şarj etmek ne kadar sürer? " yazın: " Güç ve şarj. Surface Pro 4 pilinin boş bir durumdan tamamen şarj olması iki ila dört saat sürer. Surface'ınızı oyun veya video akışı gibi yoğun güç kullanımlı etkinlikler için kullanırken "
- İstek gövdesi hakkında buradan daha fazla bilgi edinin: Soru Yanıtlama - Metinden Yanıt Alma - REST API (Azure Bilişsel Hizmetler) | Microsoft Docs
Yanıt
Projeden Yanıt Oluştur
"Erişilebilirlik" sorusu için "Örnek projenizden" bir yanıt döndürür. Bu eylemin yanıt nesnesi hakkında daha fazla bilgi edinmek için Soru Yanıtlama - Yanıt Alma - REST API (Azure Bilişsel Hizmetler) | Microsoft Docs
Sağlanan metinden Yanıt Oluştur
Verilen metinden sorunuza verilen yanıtı ayıklar. Yanıt nesnesi hakkında daha fazla bilgi edinmek için Soru Yanıtlama - Metinden Yanıt Alma - REST API (Azure Bilişsel Hizmetler) | Microsoft Docs .
Proje Meta Verilerini Alma
İstenen projenin meta verilerini alır. Yanıt nesnesi hakkında daha fazla bilgi edinmek için Soru Yanıtlama Projeleri - Proje Ayrıntılarını Alma - REST API (Azure Bilişsel Hizmetler) | Microsoft Docs .
Bilinen sorunlar ve sınırlamalar
Biz herhangi bir bulunamadı, herhangi bir bulursanız lütfen bize ulaşın qnamakersupport@microsoft.com
Yaygın hatalar ve çözümler
Lütfen şu belgelere bakın: https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
FAQ
Lütfen şu belgelere bakın: https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
Bağlantı oluşturma
Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:
| Api Anahtarı | API Anahtarı | Tüm bölgeler | Paylaşılabilir |
| Azure AD Tümleşik | Azure Blob Depolamanıza erişmek için Azure Active Directory'yi kullanın. | Tüm bölgeler | Paylaşılamaz |
| Varsayılan [KULLANIM DIŞI] | Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır. | Tüm bölgeler | Paylaşılamaz |
Api Anahtarı
Kimlik Doğrulaması Kimliği: keyBasedAuth
Geçerli: Tüm bölgeler
API Anahtarı
Bu, paylaşılabilir bir bağlantıdır. Power app başka bir kullanıcıyla paylaşılıyorsa, bağlantı da paylaşılır. Daha fazla bilgi için bkz . Tuval uygulamaları için bağlayıcılara genel bakış - Power Apps | Microsoft Docs
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| Hesap Anahtarı | securestring | Azure portalından kopyalanacak dil kaynağınızın uç nokta anahtarı | Doğru |
| Site URL’si | String | Azure portalından kopyalanacak dil kaynağınızın ana bilgisayar adı | Doğru |
Azure AD Tümleşik
Kimlik Doğrulama Kimliği: tokenBasedAuth
Geçerli: Tüm bölgeler
Azure Blob Depolamanıza erişmek için Azure Active Directory'yi kullanın.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| Site URL’si | String | Azure portalından kopyalanacak dil kaynağınızın ana bilgisayar adı | Doğru |
Varsayılan [KULLANIM DIŞI]
Geçerli: Tüm bölgeler
Bu seçenek yalnızca açık kimlik doğrulama türü olmayan eski bağlantılar içindir ve yalnızca geriye dönük uyumluluk için sağlanır.
Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.
| İsim | Türü | Description | Gerekli |
|---|---|---|---|
| Hesap Anahtarı | securestring | Azure portalından kopyalanacak dil kaynağınızın uç nokta anahtarı | Doğru |
| Site URL’si | String | Azure portalından kopyalanacak dil kaynağınızın ana bilgisayar adı | Doğru |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Proje Meta Verilerini Alma |
Bu eylem, projenizin tüm meta verilerini almaya yardımcı olur. |
| Project'ten yanıt oluşturma |
Bu eylem, projenizdeki bilgi bankanızı kullanarak belirtilen soruyu yanıtlamaya yardımcı olur. |
| Sağlanan metinden yanıt oluşturma |
Bu eylem, sağlanan metni kullanarak belirtilen sorunun yanıtlanmasında yardımcı olur. |
Proje Meta Verilerini Alma
Bu eylem, projenizin tüm meta verilerini almaya yardımcı olur.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Proje Adı
|
ProjectNamePathParameter | True | string |
Kullanılacak projenin adı. |
|
API Sürümü
|
api-version | True | string |
Bu, İstemci API'sinin sürümüdür. |
Döndürülenler
Projeyi temsil eder.
- Body
- ProjectMetadata
Project'ten yanıt oluşturma
Bu eylem, projenizdeki bilgi bankanızı kullanarak belirtilen soruyu yanıtlamaya yardımcı olur.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Proje Adı
|
projectName | True | string |
Bu, kullanmak istediğiniz Proje adıdır. |
|
Question
|
question | True | string |
Projeye karşı sorguya yönelik kullanıcı sorusu. |
|
Kullanıcı kimliği
|
userId | string |
Kullanıcının benzersiz tanımlayıcısı. |
|
|
Sayfanın Üstü #
|
top | integer |
Soru için döndürülecek en fazla yanıt sayısı. |
|
|
Güvenilirlik Eşiği
|
confidenceScoreThreshold | float |
Yanıtlar için minimum eşik puanı. Değer 0 ile 1 arasında değişir. |
|
|
Dereceleyici türü
|
rankerType | string |
Kullanılacak dereceleyicinin türü. |
|
|
Soru-Cevap Kimliği
|
qnaId | string |
Bu, projeden getirilmeye tam soru-cevap kimliğidir. |
|
|
Önceki Soru-Cevap Kimliği
|
previousQnaId | integer |
Önceki sıra üst yanıt sonucu Soru-Cevap Kimliği. |
|
|
Önceki Kullanıcı Sorgusu
|
previousUserQuery | string |
Önceki kullanıcı sorgusu. |
|
|
key
|
key | string |
Soru-Cevap'ta kullanılan Meta Veri sözlüğünden Meta Veri Anahtarı. |
|
|
value
|
value | string |
Soru-Cevap'ta kullanılan Meta Veri sözlüğünden Meta Veri Değeri. |
|
|
Ile Meta Verileri Birleştirme
|
logicalOperation | string |
Meta veri filtreleri için karşılık gelen mantıksal işlem için 'OR' veya 'AND' ayarlayın. |
|
|
Kaynak Filtresi
|
sourceFilter | string |
Projedeki belirli kaynak listelerinden herhangi biriyle ilişkili Soru-Cevap'ları bulun. |
|
|
Birleştirme Filtreleri ile
|
logicalOperation | string |
Meta veri filtresini kaynak filtreyle birleştirmek için kullanılan mantıksal işlem. |
|
|
Kesin yanıtı etkinleştirme
|
enable | boolean |
Answer Span tahminlerini etkinleştirin veya devre dışı bırakın. |
|
|
Güvenilirlik Eşiği
|
confidenceScoreThreshold | float |
Kesin bir yanıt eklemek için gereken minimum eşik puanı, değer 0 ile 1 arasında değişir. |
|
|
Sayfanın Üstü #
|
topAnswersWithSpan | integer |
1 ile 10 tam yanıt tahmini için dikkate alınması gereken en önemli yanıt sayısı. |
|
|
Yapılandırılmamış Kaynakları Dahil Et
|
includeUnstructuredSources | boolean |
Yapılandırılmamış kaynaklar üzerinde sorguyu etkinleştirmek için bayrak ekleyin. |
|
|
Dağıtım Adı
|
deploymentName | True | string |
Bu, kullanmak istediğiniz projenin özel dağıtımıdır. |
|
API Sürümü
|
api-version | True | string |
Bu, İstemci API'sinin sürümüdür. |
Döndürülenler
Soru Yanıtlarının Listesini temsil eder.
- Body
- AnswersResult
Sağlanan metinden yanıt oluşturma
Bu eylem, sağlanan metni kullanarak belirtilen sorunun yanıtlanmasında yardımcı olur.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Question
|
question | True | string |
Verilen metin kayıtlarında sorgulamak için kullanıcı sorusu. |
|
kimlik
|
id | True | string |
Metin kaydı için benzersiz tanımlayıcı. |
|
Başka bir metin sağlanmadığı için, verilen metne dayalı bir çeviri yapmam mümkün değil. Lütfen çevirilecek metni belirtin.
|
text | True | string |
Kaydın metin içeriği. |
|
Language
|
language | string |
Metin kayıtlarının dili. Bu, bir dilin BCP-47 gösterimidir. |
|
|
Dize Dizin Türü
|
stringIndexType | string |
Dize uzaklıklarını yorumlamak için kullanılan yöntemi belirtir. Unicode v8.0.0'a göre varsayılan olarak Metin Öğeleri 'ni (Graphemes) kullanır. Ek bilgi için bkz. https://aka.ms/text-analytics-offsets. |
|
|
API Sürümü
|
api-version | True | string |
Bu, İstemci API'sinin sürümüdür. |
Döndürülenler
Yanıt sonuçlarını temsil eder.
Tanımlar
ProjectMetadata
Projeyi temsil eder.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
projectName
|
projectName | string |
Projenin adı. |
|
açıklama
|
description | string |
Projenin açıklaması. |
|
Language
|
language | Language |
Metin kayıtlarının dili. Bu, bir dilin BCP-47 gösterimidir. |
|
defaultAnswer
|
settings.defaultAnswer | string |
Bilgi Bankası'nda iyi bir eşleşme bulunamazsa varsayılan Yanıt yanıtı. |
|
multilingualResource
|
multilingualResource | boolean |
Projeler arasında birden çok dil için etkinleştirilen veya etkinleştirilmeyen kaynak. |
|
oluşturulmaTarihiSaati
|
createdDateTime | date-time |
Proje oluşturma tarih-saati. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
Projenin son değiştirme tarihi-saatini temsil eder. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
Projenin son dağıtım tarih-saatini temsil eder. |
Language
Metin kayıtlarının dili. Bu, bir dilin BCP-47 gösterimidir.
Metin kayıtlarının dili. Bu, bir dilin BCP-47 gösterimidir.
- Language
- string
AnswersResult
Soru Yanıtlarının Listesini temsil eder.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
yanıtlar
|
answers | array of KnowledgeBaseAnswer |
Yanıt Sonucu listesini temsil eder. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
Kullanıcının sorusu belirsizse boole değeri döndürür. |
KnowledgeBaseAnswer
Proje yanıtlarını temsil eder.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Soru
|
questions | array of string |
Yanıtla ilişkili soruların listesi. |
|
cevap
|
answer | string |
Yanıt metni. |
|
Güvenilirlik Eşiği
|
confidenceScore | float |
Yanıt güven puanı, değer 0 ile 1 arasında değişir. |
|
Soru-Cevap Kimliği
|
id | integer |
Soru-Cevap sonucunun kimliği. |
|
kaynak
|
source | string |
Soru-Cevap sonucunun kaynağı. |
|
metadata
|
metadata | object |
Yanıtla ilişkili meta veriler, soru yanıtlarını kategorilere ayırmak veya filtrelemek için kullanışlıdır. |
|
Diyalog
|
dialog | KnowledgeBaseAnswerDialog |
Answer ile ilişkilendirilmiş iletişim kutusu. |
|
answerSpan
|
answerSpan | AnswerSpan |
Soru-Cevap'ın answer span nesnesi. |
KnowledgeBaseAnswerDialog
Answer ile ilişkilendirilmiş iletişim kutusu.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
İstemin yalnızca önceki bir soruyla ilgili olup olmadığını işaretlemek için. True ise, bağlamı olmayan sorgular için arama sonucu olarak bu Soru-Cevap'ı eklemeyin; aksi takdirde false ise bağlamı yoksayar ve bu Soru-Cevap değerini arama sonucuna ekler. |
|
Ister
|
prompts | array of KnowledgeBaseAnswerPrompt |
Yanıtla ilişkili istemlerin listesi. |
KnowledgeBaseAnswerPrompt
Bir yanıt iste.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
İstem dizini - istemlerin sırasına göre kullanılır. |
|
qnaId
|
qnaId | integer |
soru işaretine karşılık gelen Soru-Cevap Kimliği. |
|
displayText
|
displayText | string |
İzleme sorusu istemini temsil etmek için görüntülenen metin. |
AnswerSpan
Soru-Cevap'ın answer span nesnesi.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Başka bir metin sağlanmadığı için, verilen metne dayalı bir çeviri yapmam mümkün değil. Lütfen çevirilecek metni belirtin.
|
text | string |
Kesin yanıtın tahmin edilen metni. |
|
Güvenilirlik Eşiği
|
confidenceScore | float |
Kesin yanıtın tahmini puanı, değer 0 ile 1 arasında değişir. |
|
offset
|
offset | integer |
Yanıtın başlangıcından itibaren hassas yanıt uzaklığı. |
|
length
|
length | integer |
Kesin yanıtın uzunluğu. |
AnswersFromTextResult
Yanıt sonuçlarını temsil eder.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
yanıtlar
|
answers | array of TextAnswer |
Yanıt sonuçlarını temsil eder. |
TextAnswer
Yanıt sonucunu temsil eder.
| Name | Yol | Tür | Description |
|---|---|---|---|
|
cevap
|
answer | string |
Yanıt Metni. |
|
Güvenilirlik Eşiği
|
confidenceScore | float |
Yanıt güven puanı, değer 0 ile 1 arasında değişir. |
|
kimlik
|
id | string |
Kayıt Kimliği. |
|
answerSpan
|
answerSpan | AnswerSpan |
Soru-Cevap'ın answer span nesnesi. |
|
offset
|
offset | integer |
Belgenin başından itibaren tümce uzaklığı. |
|
length
|
length | integer |
Cümlenin uzunluğu. |