تمكين المصنف الدلالي أو تعطيله

Ranker الدلالي هو ميزة متميزة تتم فوترتها حسب الاستخدام. بشكل افتراضي، يتم تعطيل ranker الدلالي على جميع الخدمات.

التحقق من إمكانية التوّفر

تحقق من صفحة المنتجات المتوفرة حسب المنطقة على موقع ويب Azure لمعرفة ما إذا كانت منطقتك مدرجة.

تمكين الترتيب الدلالي

اتبع هذه الخطوات لتمكين المصنف الدلالي على مستوى الخدمة. بمجرد تمكينه، يكون متوفرا لجميع الفهارس. لا يمكنك تشغيله أو إيقاف تشغيله لفهارس معينة.

مدخل Microsoft Azure

1. افتح مدخل Azure.

2. انتقل إلى خدمة البحث. في صفحة نظرة عامة ، تأكد من أن الخدمة هي طبقة قابلة للفوترة، أساسية أو أعلى.

3. في جزء التنقل الأيسر، حدد الترتيب الدلالي.

4. حدد إما الخطة المجانية أو الخطة القياسية. يمكنك التبديل بين الخطة المجانية والخطة القياسية في أي وقت.

   

يتم الحد الأقصى للخطة المجانية عند 1000 استفسار شهريا. بعد أول 1000 استعلام في الخطة المجانية، ستتلقى رسالة خطأ تخبرك بأنك استنفدت الحصة النسبية في المرة التالية التي تصدر فيها استعلاما دلاليا. عند حدوث ذلك، تحتاج إلى الترقية إلى الخطة القياسية للاستمرار في استخدام الترتيب الدلالي.

بقيه

لتمكين الترتيب الدلالي باستخدام واجهة برمجة تطبيقات REST، يمكنك استخدام واجهة برمجة تطبيقات إنشاء الخدمة أو تحديثها.

تتم مصادقة استدعاءات واجهة برمجة تطبيقات REST للإدارة من خلال معرف Microsoft Entra. راجع إدارة الذكاء الاصطناعي خدمة البحث Azure باستخدام واجهات برمجة تطبيقات REST للحصول على إرشادات حول كيفية المصادقة.

• توفر Management REST API الإصدار 2023-11-01 خاصية التكوين.

• أذونات المالك أو المساهم مطلوبة لتمكين الميزات أو تعطيلها.

إشعار

يدعم الإنشاء أو التحديث طريقتين HTTP: PUT و PATCH. يمكن استخدام كل من PUT و PATCH لتحديث الخدمات الموجودة، ولكن يمكن استخدام PUT فقط لإنشاء خدمة جديدة. إذا تم استخدام PUT لتحديث خدمة موجودة، فإنه يستبدل جميع الخصائص في الخدمة بالإعدادات الافتراضية الخاصة بها إذا لم يتم تحديدها في الطلب. عند استخدام PATCH لتحديث خدمة موجودة، فإنه يحل محل الخصائص المحددة في الطلب فقط. عند استخدام PUT لتحديث خدمة موجودة، من الممكن إدخال تغيير غير متوقع في التحجيم أو التكوين عن طريق الخطأ. عند تمكين الترتيب الدلالي على خدمة موجودة، يوصى باستخدام PATCH بدلا من PUT.

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

تعطيل الترتيب الدلالي باستخدام واجهة برمجة تطبيقات REST

لعكس تمكين الميزة، أو للحماية الكاملة من الاستخدام غير المقصود والرسوم، يمكنك تعطيل الترتيب الدلالي باستخدام Create أو Update Service API على خدمة البحث. بعد تعطيل الميزة، سيتم رفض أي طلبات تتضمن نوع الاستعلام الدلالي.

تتم مصادقة استدعاءات واجهة برمجة تطبيقات REST للإدارة من خلال معرف Microsoft Entra. راجع إدارة الذكاء الاصطناعي خدمة البحث Azure باستخدام واجهات برمجة تطبيقات REST للحصول على إرشادات حول كيفية المصادقة.

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

لإعادة تمكين الترتيب الدلالي، أعد تشغيل الطلب أعلاه، مع تعيين "semanticSearch" إما إلى "مجاني" (افتراضي) أو "قياسي".

الخطوات التالية

قم بتكوين الترتيب الدلالي بحيث يمكنك اختبار الترتيب الدلالي على المحتوى الخاص بك.