Anlamsal sıralayıcıyı etkinleştir veya devre dışı bırak

Anlam dereceleyicisi, kullanıma göre faturalanan premium bir özelliktir. Varsayılan olarak, semantik dereceleyici yeni bir faturalanabilir arama hizmetinde etkinleştirilir ve ücretsiz plan için yapılandırılır, ancak Katkıda Bulunan izinleri olan herkes bunu devre dışı bırakabilir veya faturalama planını değiştirebilir. Kimsenin bu özelliği kullanmasını istemiyorsanız yönetim REST API'sini kullanarak hizmet genelinde devre dışı bırakabilirsiniz. Eğer anlam sıralamasını devre dışı bırakırsanız, etkileyici alma işlevini de devre dışı bırakırsınız.

Kullanılabilirliği denetle

Bölgenizde semantik dereceleyicinin kullanılabilir olup olmadığını denetlemek için Bkz . Azure AI Search bölgeleri listesi.

Anlamsal sıralayıcıyı etkinleştir

Anlam dereceleyicisi eski hizmetlerde etkinleştirilmemiş olabilir. Hizmet düzeyinde anlam derecesini etkinleştirmek için bu adımları izleyin. Etkinleştirildikten sonra tüm dizinler tarafından kullanılabilir. Belirli dizinler için bu özelliği açıp kapatamazsınız.

Azure portalı

1. Azure portalında arama hizmetinize gidin.

2. Genel Bakış sayfasında fiyatlandırma katmanının Temel veya daha yüksek olarak ayarlandığından emin olun.

3. Sol gezinti bölmesinde Ayarlar>Premium özellikler'i seçin.

4. Ücretsiz planı (varsayılan) veya Standart planı seçin. Ücretsiz plan ile standart plan arasında istediğiniz zaman geçiş yapabilirsiniz.

   

Ücretsiz planda ayda 1.000 sorgu sınırı vardır. Ücretsiz planda ilk 1.000 sorgudan sonra, bir hata iletisi bir sonraki anlamsal sorguda kotanızı tükettiğinizi gösterir. Kota tükendiğinde, anlam sıralamasını kullanmaya devam etmek için standart plana yükseltebilirsiniz.

REST

Anlam derecesini etkinleştirmek için Hizmetler - Oluştur veya Güncelleştir (REST API) kullanabilirsiniz.

Yönetim REST API çağrılarının kimliği Microsoft Entra Kimliği aracılığıyla doğrulanır. Kimlik doğrulaması hakkında yönergeler için bkz. AZURE AI Arama hizmeti REST API'leriyle yönetme.

• Yönetim REST API'sinin 2023-11-01 veya sonraki bir sürümü yapılandırma özelliğini sağlar.

• Sahip veya Katkıda Bulunan izinleri, özellikleri etkinleştirmek veya devre dışı bırakmak için gereklidir.

Not

Oluşturma veya Güncelleştirme iki HTTP yöntemini destekler: PUT ve PATCH. Hem PUT hem de PATCH mevcut hizmetleri güncelleştirmek için kullanılabilir, ancak yeni bir hizmet oluşturmak için yalnızca PUT kullanılabilir. Put, mevcut bir hizmeti güncelleştirmek için kullanılırsa, istekte belirtilmemişse, hizmetteki tüm özellikleri varsayılanlarıyla değiştirir. PATCH mevcut bir hizmeti güncelleştirmek için kullanıldığında, yalnızca istekte belirtilen özelliklerin yerini alır. Mevcut bir hizmeti güncelleştirmek için PUT kullanırken yanlışlıkla beklenmeyen bir ölçeklendirme veya yapılandırma değişikliğine neden olabilir. Mevcut bir hizmette anlam sıralamasını etkinleştirirken PUT yerine PATCH kullanılması önerilir.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01
    {
      "properties": {
        "semanticSearch": "standard"
      }
    }

REST API kullanarak semantik sıralayıcıyı devre dışı bırakma

Özellik etkinleştirmeyi kapatmak veya yanlışlıkla oluşabilecek kullanımlar ve ücretlendirmelere karşı tam koruma sağlamak için arama hizmetinizde Create or Update Service API'yi kullanarak semantic ranker'ı devre dışı bırakabilirsiniz. Özellik devre dışı bırakıldıktan sonra anlamsal sorgu türünü içeren tüm istekler reddedilir.

Yönetim REST API çağrılarının kimliği Microsoft Entra Kimliği aracılığıyla doğrulanır. Kimlik doğrulaması hakkında yönergeler için bkz. AZURE AI Arama hizmeti REST API'leriyle yönetme.

PATCH https://management.azure.com/subscriptions/{{subscriptionId}}/resourcegroups/{{resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}?api-version=2025-05-01
    {
      "properties": {
        "semanticSearch": "disabled"
      }
    }

Anlam derecesini yeniden etkinleştirmek için önceki isteği yeniden çalıştırın ve Ücretsiz (varsayılan) veya semanticSearch olarak ayarlayın.

Sonraki adım

Anlam dereceleyiciyi yapılandırma