مشاركة عبر

الترحيل إلى أحدث إصدار من Azure الذكاء الاصطناعي Language

  • مقالة

تلميح

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

إذا كانت تطبيقاتك لا تزال تستخدم واجهة برمجة تطبيقات تحليلات النص، أو مكتبة العميل (قبل الإصدار 5.1.0 الثابت)، فستساعدك هذه المقالة على ترقية تطبيقاتك لاستخدام أحدث إصدار من ميزات لغة Azure الذكاء الاصطناعي .

نقطة نهاية اللغة الموحدة (REST API)

ينطبق هذا القسم على التطبيقات المُستخدِمة لتنسيق نقطة النهاية الأقدم /text/analytics/... في استدعاءات REST API. على سبيل المثال:

https://<your-custom-subdomain>.cognitiveservices.azure.com/text/analytics/<version>/<feature>

إذا كان تطبيقك يستخدم تنسيق نقطة النهاية أعلاه، فقد تغيرت نقطة نهاية REST API لميزات خدمة اللغة التالية:

توفر خدمة Language الآن نقطة نهاية موحدة لإرسال طلبات REST API إلى هذه الميزات. إذا كان تطبيقك يستخدم REST API، فقم بتحديث نقطة نهاية الطلب الخاصة به لاستخدام نقطة النهاية الحالية:

https://<your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01

بالإضافة إلى ذلك، تم تغيير تنسيق نص طلب JSON. ستحتاج إلى تحديث بنية الطلب التي يرسلها تطبيقك إلى «واجهة برمجة التطبيقات»، على سبيل المثال نص JSON التالي للتعرف على الكيان:

{
    "kind": "EntityRecognition",
    "parameters": {
        "modelVersion": "latest"
    },
    "analysisInput":{
        "documents":[
            {
                "id":"1",
                "language": "en",
                "text": "I had a wonderful trip to Seattle last week."
            }
        ]
    }
}

استخدم قوالب التشغيل السريع المرتبطة أعلاه لرؤية المثال الحالي لاستدعاءات واجهة برمجة تطبيقات REST عن الميزة (الميزات) التي تستخدمها، وإخراج «واجهة برمجة التطبيقات» المقترنة.

مكتبات العملاء

لاستخدام أحدث إصدار من مكتبة العميل، ستحتاج إلى تنزيل أحدث حزمة برامج في مساحة الاسم Azure.AI.TextAnalytics. راجع مقالات التشغيل السريع المرتبطة أعلاه على سبيل المثال التعليمات البرمجية والإرشادات لاستخدام مكتبة العميل بلغتك المفضلة.

تغييرات وظائف الإصدار 2.1

إذا كنت تقوم بترحيل تطبيق من الإصدار 2.1 من واجهة برمجة التطبيقات، فهناك العديد من التغييرات على وظيفة الميزة التي يجب أن تكون على معرفة بها.

تحليل التوجه الإصدار 2.1

تحليل التوجيه في الإصدار 2.1 يعرض درجات المشاعر بين 0 و1 لكل مستند يتم إرساله إلى API، حيث تشير الدرجات الأقرب إلى 1 إلى شعور أكثر إيجابية. يعرض الإصدار الحالي من هذه الميزة تسميات المشاعر (مثل "إيجابي" أو "سلبي") لكل من الجمل والمستند ككل، ودرجات الثقة المرتبطة بها.

NER، و PII، والعنصر الذي يربط الإصدار 2.1

في الإصدار 2.1، استخدمت واجهة برمجة تطبيقات Text Analytics نقطة نهاية واحدة «للتعرف على رموز الأحرف» (NER) وربط العنصر. يوفر الإصدار الحالي من هذه الميزة اكتشاف موسع لرموز الأحرف، ويستخدم نقاط نهاية منفصلة لطلبات NER و ربط العناصر. بالإضافة إلى ذلك، يمكنك استخدام ميزة أخرى معروضة في خدمة اللغة تتيح لك اكتشاف كشف المعلومات الشخصية (pii) والحالة (phi).

ستحتاج أيضاً إلى تحديث تطبيقك لاستخدام فئات العناصر المعروضة في استجابة واجهة برمجة التطبيقات.

فئات العناصر في الإصدار 2.1

يسرد الجدول التالي فئات العناصر التي تم إرجاعها لـ NER v2.1.

الفئة الوصف
الشخص أسماء الأشخاص.
‏‏الموقع المعالم الطبيعية والاصطناعية، والبُنى، والمعالم الجغرافية، والكيانات الجيوسياسية
المؤسسة الشركات والمجموعات السياسية والفرق الموسيقية والنوادي الرياضية والهيئات الحكومية والمنظمات العامة. ولا تدرج الجنسيات والديانات في هذا النوع من الكيانات.
PhoneNumber أرقام الهواتف (أرقام هواتف الولايات المتحدة والاتحاد الأوروبي فقط).
بريد إلكتروني عناوين البريد الإلكتروني.
عنوان URL عناوين URL لمواقع الويب.
عنوان IP عناوين IP للشبكة.
التاريخ والوقت التواريخ والأوقات من اليوم.
التاريخ تواريخ Calender.
الوقت أوقات اليوم
المدى الزمني نطاقات التواريخ.
المدى الزمني النطاقات الزمنية.
المدة المُدد.
تعيين تعيين، مرات متكررة.
كميه الأرقام والكميات الرقمية.
الهاتف الأرقام.
النسبة المئوية النسب المئوية.
العدد الترتيبي الأعداد الترتيبية.
العمر الأعمار.
العملة العملات.
البعد الأبعاد والقياسات.
درجة الحرارة درجات الحرارة.

الكشف عن اللغة الإصدار v2.1

تم تغيير إخراج ميزة اكتشاف اللغة في الإصدار الحالي. ستتضمن استجابة JSON ConfidenceScore بدلاً من score. يعرض الإصدار الحالي أيضًا لغة واحدة فقط لكل مستند.

استخراج العبارة الرئيسية في الإصدار v2.1

لم تتغير وظيفة ميزة استخراج العبارة الرئيسية حاليًا خارج نقطة النهاية وتنسيق الطلب.

راجع أيضًا