Soru-Cevap Oluşturma için Azure kaynakları

Soru-Cevap Oluşturma, her biri farklı bir amaca sahip olan birkaç Azure kaynağı kullanır. Bunların tek tek nasıl kullanıldığını anlamak, doğru fiyatlandırma katmanını planlamanıza ve seçmenize veya fiyatlandırma katmanınızı ne zaman değiştireceğini bilmenize olanak tanır. Bunların birlikte nasıl kullanıldığını anlamak, ortaya çıkan sorunları bulmanıza ve çözmenize olanak tanır.

Dekont

Soru-Cevap Oluşturma hizmeti 31 Mart 2025'te kullanımdan kaldırılıyor. Soru ve yanıtlama özelliğinin daha yeni bir sürümü artık Azure AI Dili'nin bir parçası olarak kullanılabilir. Dil Hizmeti'nin içindeki soru yanıtlama özellikleri için bkz . soru yanıtlama. 1 Ekim 2022'den itibaren yeni Soru-Cevap Oluşturma kaynakları oluşturamayacaksınız. Mevcut Soru-Cevap Oluşturma bilgi bankası soru yanıtlamaya geçirme hakkında bilgi için geçiş kılavuzuna bakın.

Kaynak planlaması

Bir Soru-Cevap Oluşturma bilgi bankası ilk kez geliştirirken prototip aşamasında hem test hem de üretim için tek bir Soru-Cevap Oluşturma kaynağına sahip olmak yaygın bir durumdur.

Projenin geliştirme aşamasına geçtiğiniz zaman şunları göz önünde bulundurmanız gerekir:

  • bilgi bankası sisteminizin kaç dili barındıracak?
  • bilgi bankası kaç bölgede kullanılabilir olması gerekir?
  • Sisteminizin her etki alanında kaç belge barındıracak?

Tek bir Soru-Cevap Oluşturma kaynağının aynı dile, aynı bölgeye ve aynı konu etki alanı bileşimine sahip tüm bilgi bankası tutmasını planlayın.

Fiyatlandırma katmanı konusunda dikkat edilmesi gerekenler

Genellikle göz önünde bulundurmanız gereken üç parametre vardır:

  • Hizmetten ihtiyacınız olan aktarım hızı:

  • Boyut ve bilgi bankası sayısı: Senaryonuz için uygun Azure arama SKU'sunu seçin. Genellikle, farklı konu etki alanlarının sayısına göre ihtiyacınız olan bilgi bankası sayısına karar verirsiniz. Konu etki alanı (tek bir dil için) tek bir bilgi bankası olmalıdır.

Azure Arama hizmeti kaynağınız Ocak 2019'da oluşturulmuş olmalı ve ücretsiz (paylaşılan) katmanda olamaz. Azure portalında müşteri tarafından yönetilen anahtarları yapılandırma desteği yoktur.

Önemli

N-1 bilgi bankası'leri belirli bir katmanda yayımlayabilirsiniz; burada N, katmanda izin verilen en fazla dizindir. Ayrıca katman başına izin verilen en büyük boyutu ve belge sayısını da denetleyin.

Örneğin, katmanınızda izin verilen 15 dizin varsa, 14 bilgi bankası yayımlayabilirsiniz (yayımlanan bilgi bankası başına bir dizin). On beşinci dizin, yazma ve test için tüm bilgi bankası için kullanılır.

  • Kaynak olarak belge sayısı: Soru-Cevap Oluşturma yönetim hizmetinin ücretsiz SKU'su, portal ve API'ler aracılığıyla yönetebileceğiniz belge sayısını 3 (her biri 1 MB boyutunda) ile sınırlar. Standart SKU'nun yönetebileceğiniz belge sayısıyla ilgili bir sınırı yoktur. Diğer ayrıntıları burada bulabilirsiniz.

Aşağıdaki tablo size bazı üst düzey yönergeler sağlar.

Soru-Cevap Oluşturma Yönetimi App Service Azure AI Arama Sınırlamalar
Deneme Ücretsiz SKU Ücretsiz Katmanı Ücretsiz Katmanı En fazla 2 MB, 50 MB boyutunda yayımlama
Geliştirme/Test Ortamı Standart SKU Paylaşılan Temel En fazla 14 KB, 2 GB boyutunda yayımlama
Üretim Ortamı Standart SKU Temel Standart 49 GB'a kadar yayımlama, 25 GB boyutu
Hedef QPS App Service Azure AI Arama
3 S1, bir Çoğaltma S1, bir Çoğaltma
50 S3, 10 Çoğaltmalar S1, 12 Çoğaltmalar
80 S3, 10 Çoğaltmalar S3, 12 Çoğaltmalar
Kategori 100 P3V2, 10 Çoğaltma S3, 12 Çoğaltma, 3 Bölüm
200 - 250 P3V2, 20 Çoğaltmalar S3, 12 Çoğaltma, 3 Bölüm

Fiyatlandırma katmanı ne zaman değiştirilir?

Yükseltme Nedeni
Soru-Cevap Oluşturma yönetimi SKU'su yükseltme bilgi bankası daha fazla Soru-Cevap çifti veya belge kaynağı olmasını istiyorsunuz.
App Service SKU'yu yükseltin ve Azure AI Arama katmanını denetleyin ve Bilişsel Arama çoğaltmaları oluşturun bilgi bankası, sohbet botu gibi istemci uygulamanızdan daha fazla istek göndermesi gerekir.
Azure AI Arama hizmeti'i yükseltme Birçok bilgi bankası olmasını planlıyorsunuz.

Azure portalında App Service'inizi güncelleştirerek en son çalışma zamanı güncelleştirmelerini alın.

Soru-Cevap Oluşturma'daki anahtarlar

Soru-Cevap Oluşturma hizmetiniz iki tür anahtarla ilgilenir: Yazma anahtarları ve App service'te barındırılan çalışma zamanıyla kullanılan sorgu uç noktası anahtarları .

API'ler aracılığıyla hizmete istekte bulunurken bu anahtarları kullanın.

Key management

Adı Konum Amaç
Yazma/Abonelik anahtarı Azure portalı Bu anahtarlar Soru-Cevap Oluşturma yönetim hizmeti API'lerine erişmek için kullanılır. Bu API'ler, bilgi bankası soru ve yanıtlarınızı düzenlemenize ve bilgi bankası yayımlamanıza olanak verir. Bu anahtarlar, yeni bir Soru-Cevap Oluşturma hizmeti oluşturduğunuzda oluşturulur.

Bu anahtarları Anahtarlar ve Uç Nokta sayfasındaki Azure AI hizmetleri kaynağında bulabilirsiniz.
Sorgu uç noktası anahtarı Soru-Cevap Oluşturma portalı Bu anahtarlar, bir kullanıcı sorusuna yanıt almak üzere yayımlanan bilgi bankası uç noktasını sorgulamak için kullanılır. Bu sorgu uç noktasını genellikle sohbet botunuzda veya Soru-Cevap Oluşturma hizmetine bağlanan istemci uygulama kodunda kullanırsınız. Soru-Cevap Oluşturma bilgi bankası yayımladığınızda bu anahtarlar oluşturulur.

Bu anahtarları Hizmet ayarları sayfasında bulabilirsiniz. Bu sayfayı, açılan menüde sayfanın sağ üst kısmındaki kullanıcının menüsünde bulabilirsiniz.

Azure portalında yazma anahtarlarını bulma

Yazma anahtarlarınızı Soru-Cevap Oluşturma kaynağını oluşturduğunuz Azure portalından görüntüleyebilir ve sıfırlayabilirsiniz.

  1. Azure portalında Soru-Cevap Oluşturma kaynağına gidin ve Azure AI hizmetleri türüne sahip kaynağı seçin:

    QnA Maker resource list

  2. Anahtarlar ve Uç Nokta'ya gidin:

    QnA Maker managed (Preview) Subscription key

Soru-Cevap Oluşturma portalında sorgu uç noktası anahtarlarını bulma

Uç nokta anahtarları bilgi bankası çağrı yapmak için kullanıldığından uç nokta kaynakla aynı bölgededir.

Uç nokta anahtarları Soru-Cevap Oluşturma portalından yönetilebilir.

  1. Soru-Cevap Oluşturma portalında oturum açın, profilinize gidin ve Hizmet ayarları'nı seçin:

    Endpoint key

  2. Anahtarlarınızı görüntüleyin veya sıfırlayın:

    Endpoint key manager

    Dekont

    Ele geçirildiğini düşünüyorsanız anahtarlarınızı yenileyin. Bunun için istemci uygulamanızda veya bot kodunuzda ilgili değişiklikler yapılması gerekebilir.

Yönetim hizmeti bölgesi

Soru-Cevap Oluşturma'nın yönetim hizmeti yalnızca Soru-Cevap Oluşturma portalı ve ilk veri işleme için kullanılır. Bu hizmet yalnızca Batı ABD bölgesinde kullanılabilir. Bu Batı ABD hizmetinde hiçbir müşteri verisi depolanmaz.

Kaynak adlandırma konusunda dikkat edilmesi gerekenler

Soru-Cevap Oluşturma kaynağının kaynak adı , gibi qna-westus-f0-bdiğer kaynakları adlandırmak için de kullanılır.

Azure portalı oluşturma penceresi bir Soru-Cevap Oluşturma kaynağı oluşturmanıza ve diğer kaynaklar için fiyatlandırma katmanlarını seçmenize olanak tanır.

Screenshot of Azure portal for QnA Maker resource creation

Kaynaklar oluşturulduktan sonra, ada karakter ekleyen isteğe bağlı Application Analizler kaynağı dışında aynı ada sahiptir.

Screenshot of Azure portal resource listing

Bahşiş

Soru-Cevap Oluşturma kaynağı oluştururken yeni bir kaynak grubu oluşturun. Bu, kaynak grubuna göre arama yaparken Soru-Cevap Oluşturma kaynağıyla ilişkili tüm kaynakları görmenizi sağlar.

Bahşiş

Kaynak veya kaynak grubu adı içindeki fiyatlandırma katmanlarını belirtmek için bir adlandırma kuralı kullanın. Yeni bir bilgi bankası oluşturma veya yeni belgeler ekleme hataları aldığınızda Bilişsel Arama fiyatlandırma katmanı sınırı yaygın bir sorundur.

Kaynak amaçları

Soru-Cevap Oluşturma ile oluşturulan her Azure kaynağının belirli bir amacı vardır:

  • Soru-Cevap Oluşturma kaynağı
  • Bilişsel Arama kaynağı
  • App Service
  • Uygulama Planı Hizmeti
  • Uygulama Analizler Hizmeti

Soru-Cevap Oluşturma kaynağı

Soru-Cevap Oluşturma kaynağı, yazma ve yayımlama API'lerine erişim sağlar.

Soru-Cevap Oluşturma kaynak yapılandırma ayarları

Soru-Cevap Oluşturma portalında yeni bir bilgi bankası oluşturduğunuzda, kaynak düzeyinde uygulanan tek ayar Dil ayarıdır. Kaynak için ilk bilgi bankası oluştururken dili seçersiniz.

Bilişsel Arama kaynağı

Bilişsel Arama kaynağı aşağıdakiler için kullanılır:

  • Soru-Cevap çiftlerini depolama
  • Çalışma zamanında Soru-Cevap çiftlerinin ilk derecelendirmesini (ranker #1) sağlayın

Dizin kullanımı

Kaynak, test dizini olarak hareket etmek için bir dizin tutar ve kalan dizinler her biri bilgi bankası yayımlanan bir dizinle ilişkilendirir.

15 dizini barındırmak için fiyatlanan bir kaynak, 14 yayımlanmış bilgi bankası barındıracak ve tüm bilgi bankası test etmek için bir dizin kullanılır. Bu test dizini, etkileşimli test bölmesini kullanan bir sorgunun test dizinini kullanması ancak yalnızca belirli bir bilgi bankası ilişkili bölümden sonuçları döndürmesi için bilgi bankası bölümlenir.

Dil kullanımı

Soru-Cevap Oluşturma kaynağında oluşturulan ilk bilgi bankası, Bilişsel Arama kaynağı ve tüm dizinleri için tek dil kümesini belirlemek için kullanılır. Soru-Cevap Oluşturma hizmeti için yalnızca bir dil kümeniz olabilir.

Tek bir Bilişsel Arama hizmeti kullanma

Portal aracılığıyla bir Soru-Cevap hizmeti ve bağımlılıkları (Arama gibi) oluşturursanız, sizin için bir Arama hizmeti oluşturulur ve Soru-Cevap Oluşturma hizmetine bağlanır. Bu kaynaklar oluşturulduktan sonra App Service ayarını daha önce var olan bir Arama hizmeti kullanacak şekilde güncelleştirebilir ve yeni oluşturduğunuzu kaldırabilirsiniz.

Soru-Cevap Oluşturma'nın Soru-Cevap Oluşturma kaynak oluşturma işleminin bir parçası olarak oluşturulan kaynaktan farklı bir Azure AI hizmeti kaynağı kullanacak şekilde nasıl yapılandıracağınızı öğrenin.

App Service ve App service planı

App service, istemci uygulamanız tarafından yayımlanan bilgi bankası çalışma zamanı uç noktası üzerinden erişmek için kullanılır. App Service, çalışma zamanında Soru-Cevap çiftlerinin doğal dil işleme (NLP) tabanlı ikinci derecelendirme katmanını (ranker #2) içerir. İkinci derecelendirme meta verileri ve izleme istemlerini içerebilen akıllı filtreler uygular.

Yayımlanan bilgi bankası sorgulamak için, yayımlanan tüm bilgi bankası aynı URL uç noktasını kullanır, ancak yol içinde bilgi bankası kimliğini belirtin.

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application Insights

Uygulama Analizler, sohbet günlüklerini ve telemetri verilerini toplamak için kullanılır. Hizmetiniz hakkında bilgi için ortak Kusto sorgularını gözden geçirin.

Soru-Cevap Oluşturma ile hizmetleri paylaşma

Soru-Cevap Oluşturma birkaç Azure kaynağı oluşturur. Yönetimi azaltmak ve maliyet paylaşımından yararlanmak için, neler paylaşıp paylaşamazsınız anlamak için aşağıdaki tabloyu kullanın:

Servis Paylaş Nedeni
Azure yapay zeka hizmetleri X Tasarım gereği mümkün değil
App Service planı App Service planı için ayrılan disk alanı düzeltildi. Aynı App Service planını paylaşan diğer uygulamalar önemli disk alanı kullanıyorsa, QnAMaker App Service örneği sorunlarla karşılaşır.
App Service X Tasarım gereği mümkün değil
Application Insights Paylaşılabilir
Arama hizmeti 1. testkb Soru-Cevap Oluşturma hizmeti için ayrılmış bir addır; başkaları tarafından kullanılamaz.
2. Adıyla synonym-map eş anlamlı eşlem, QnAMaker hizmeti için ayrılmıştır.
3. Yayımlanan bilgi bankası sayısı Arama hizmeti katmanla sınırlıdır. Kullanılabilir ücretsiz dizinler varsa, diğer hizmetler bunları kullanabilir.

Sonraki adımlar