إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
إذا تمت كتابة رمز الترتيب الدلالي مقابل واجهات برمجة التطبيقات للمعاينة المبكرة، فإن هذه المقالة تحدد تغييرات التعليمات البرمجية اللازمة للترحيل إلى إصدارات واجهة برمجة التطبيقات الأحدث. تقتصر التغييرات العاجلة للمرتب الدلالي على منطق الاستعلام في واجهات برمجة التطبيقات الأخيرة، ولكن إذا تمت كتابة التعليمات البرمجية الخاصة بك مقابل إصدار المعاينة الأولية، فقد تحتاج إلى تغيير التكوين الدلالي أيضا.
التغييرات الجذرية
هناك تغييران فاصلان للمرتب الدلالي عبر إصدارات REST API:
-
searchFieldsتم استبدالهsemanticConfigurationفي 2021-04-30-preview -
queryLanguageتم تجاهله بدءا من 2023-07-01-preview، ولكن تمت إعادة كتابته للاستعلام في 2024-11-01-preview
تتعلق التحديثات الأخرى الخاصة بالإصدار بقدرات جديدة، ولكنها لا تكسر التعليمات البرمجية الموجودة وبالتالي لا تكسر التغييرات.
إذا كنت تستخدم Azure SDKs، فقد تمت إعادة تسمية واجهات برمجة التطبيقات المتعددة بمرور الوقت. توفر سجلات تغيير SDK التفاصيل.
إصدارات واجهة برمجة التطبيقات التي توفر الترتيب الدلالي
تحقق من التعليمات البرمجية لإصدار REST API أو إصدار حزمة SDK لتأكيد الترتيب الدلالي. تحتوي إصدارات واجهة برمجة التطبيقات التالية على مستوى من الدعم للتصنيف الدلالي.
| نوع الإصدار | إصدار واجهة برمجة تطبيقات REST | تحديثات الرتب الدلالية |
|---|---|---|
| الاولي | 2020-06-30-معاينة | يضيف queryType=semantic إلى مستندات البحث. |
| Preview | معاينة |
تضيف semanticConfiguration لإنشاء أو تحديث الفهرس. |
| Preview | 2023-07-01-معاينة | التحديثات semanticConfiguration. بدءا من 14 يوليو 2023، تم إجراء تحديثات على النماذج الدلالية المستضافة من Microsoft على لغة التصنيف الدلالي، مما يؤدي إلى إيقاف تشغيل queryLanguage الخاصية بشكل فعال للتصنيف الدلالي. لا يوجد تغيير كسر في التعليمات البرمجية، ولكن يتم تجاهل الخاصية. تم نصح العملاء بإزالة هذه الخاصية من التعليمات البرمجية. |
| Preview | معاينة |
semanticQuery يضيف لإرسال استعلام يستخدم فقط لأغراض إعادة الإرسال. |
| مستقرة | 2023-11-01 | متوفر بشكل عام. قدم تغييرات على semanticConfiguration ذلك التقدم إلى الإصدار المستقر. إذا كانت التعليمات البرمجية تستهدف هذا الإصدار أو الإصدارات الأحدث، فهي متوافقة مع إصدارات واجهة برمجة التطبيقات الأحدث ما لم تعتمد ميزات معاينة جديدة. |
| Preview | معاينة 2024-05-01 | لا يوجد تغيير. |
| مستقرة | 2024-07-01 | لا يوجد تغيير. |
| Preview | معاينة 2024-09-01 | لا يوجد تغيير. |
| Preview | معاينة 2024-11-01 | إضافة إعادة كتابة الاستعلام. الخاصية queryLanguage مطلوبة الآن إذا كنت تستخدم إعادة كتابة الاستعلام (معاينة). |
| Preview | معاينة 2025-03-01 | إضافة الاشتراك إلى إصدارات الإصدارات التجريبية من النماذج الدلالية. |
| Preview | معاينة 2025-05-01 | لا توجد تحديثات لواجهة برمجة التطبيقات في هذه المعاينة، ولكن الترتيب الدلالي الآن لديه تكامل أفضل مع ملفات تعريف تسجيل النقاط. |
| Preview | 2025-08-01-معاينة | لا يوجد تغيير. |
| مستقرة | 2025-09-01 | لا يوجد تغيير. |
| Preview | 2025-11-01-معاينة | متوفر على المستويات المجانية. |
| مستقرة | 2026-04-01 | يفصل بين موافقة الفوترة على التصنيف الدلالي والاسترجاع الوكيل.
semanticSearch الآن يتحكم فقط في فوترة التصنيف الدلالي. قبل الترقية، إذا كان لديك semanticSearch=standard، يجب عليك أيضا تعيين knowledgeRetrieval=standard. لمزيد من المعلومات، راجع تمكين أو تعطيل الفوترة الدلالية للتصنيف. |
| Preview | معاينة 2026-05-01 | لا يوجد تغيير. |
تغيير سجلات Azure SDKs
لتحديد الميزات الدلالية المتاحة في حزمة Azure SDK المحددة وما إذا كانت هناك واجهات برمجة تطبيقات قد تم إعادة تسميتها، راجع سجل التغييرات في SDK:
- Azure SDK لسجل تغيير .NET
- Azure SDK لسجل تغيير Python
- Azure SDK لسجل تغيير Java
- سجل تغيير Azure SDK ل JavaScript
معاينة 2024-11-01
- إضافة إعادة كتابة الاستعلام إلى البحث في المستندات.
-
queryLanguageيتطلب الاستعلام إعادة كتابة أحمال العمل. للحصول على قائمة بالقيم الصالحة، راجع واجهة برمجة تطبيقات REST.
معاينة 2024-09-01
لا توجد تغييرات على بناء جملة الترتيب الدلالي من الإصدار المستقر 2024-07-01.
2024-07-01
لا توجد تغييرات على بناء جملة الترتيب الدلالي من الإصدار 2024-05-01-preview.
لا تستخدم إصدار واجهة برمجة التطبيقات هذا. ينفذ بناء جملة استعلام متجه غير متوافق مع أي إصدار أحدث من واجهة برمجة التطبيقات.
معاينة 2024-05-01
لا توجد تغييرات على بناء جملة الترتيب الدلالي من الإصدار 2024-03-01-preview.
معاينة 2024-03-01
لا توجد تغييرات على بناء جملة الترتيب الدلالي من إصدار معاينة 2023-10-01، ولكن يتم تقديم استعلامات المتجهات. ينطبق الترتيب الدلالي الآن على الاستجابات من الاستعلامات المختلطة والمتجهة. يمكنك تطبيق إعادة التشغيل على أي حقول نصية يمكن للبشر قراءتها في الاستجابة، على افتراض أن الحقول مدرجة في prioritizedFields.
2023-11-01
-
SemanticDebugيستبعد وsemanticQuery، وإلا نفس الإصدار 2023-10-01-preview.
معاينة 2023-10-01
- يضيف
semanticQuery
معاينة 2023-07-01
-
semanticErrorHandlingيضيف ،semanticMaxWaitInMilliseconds. - يضيف العديد من الحقول ذات الصلة بالدلالة إلى الاستجابة، مثل
SemanticDebugوSemanticErrorMode. - يتجاهل
queryLanguage، لم يعد يستخدم في الترتيب الدلالي.
بدءا من 14 يوليو 2023، يعد ترتيب الدلالي غير محدد اللغة. في إصدارات المعاينة، سيؤدي الترتيب الدلالي إلى إلغاء فرز النتائج التي تختلف عن querylanguage المحددة بواسطة محلل الحقول. ومع ذلك، لا تزال الخاصية queryLanguage قابلة للتطبيق على التصحيح الإملائي وقائمة اللغات القصيرة التي تدعمها هذه الميزة.
معاينة 2021-04-30
- يتم الدعم الدلالي من خلال البحث في المستندات وإنشاء أو تحديث استدعاءات واجهة برمجة تطبيقات معاينة الفهرس .
-
semanticConfigurationإضافة إلى فهرس بحث. يحتوي التكوين الدلالي على اسم وقائمة حقول ذات أولوية. - يضيف ''الحقول ذات الأولوية'.
searchFields لم تعد الخاصية تستخدم لتحديد أولويات الحقول. في جميع الإصدارات للمضي قدما، semanticConfiguration.prioritizedFields يستبدل searchFields كآلية لتحديد الحقول التي يجب استخدامها لترتيب L2.
معاينة 2020-06-30
- يتم الدعم الدلالي من خلال استدعاء واجهة برمجة تطبيقات معاينة مستندات البحث .
-
queryType=semanticإضافة إلى طلب الاستعلام. -
searchFieldsيتكيف بحيث إذا كان نوع الاستعلام دلاليا،searchFieldsتحدد الخاصية ترتيب أولوية إدخالات الحقول إلى المصنف الدلالي. -
captionsيضيف وanswersوhighlightsإلى استجابة الاستعلام.
الخطوات التالية
اختبر ترحيل التكوين الدلالي عن طريق تشغيل استعلام دلالي.