استخدام الخدمات الإدراكية في تطبيقات اللوحة

مقالة
03/09/2022
قراءة خلال 8 دقائق

يبين لك هذا المقال كيفية إنشاء تطبيق لوحة أساسي يستخدم واجهة برمجة تطبيقات التحليلات النصية في Azure Cognitive Services لتحليل النص. سنوضح لك كيفية إعداد واجهة برمجة تطبيقات التحليلات النصية والاتصال بها باستخدام موصل التحليلات النصية. ثم سنوضح لك كيفية إنشاء تطبيق لوحة يستدعي واجهة برمجة تطبيقات التحليلات النصية.

ملاحظة

إذا لم تكن ملمًا بكيفية إنشاء تطبيقات في Power Apps، فنحن ننصحك بقراءة إنشاء تطبيق من البداية قبل التعمق في هذا المقال.

مقدمة إلى Azure Cognitive Services

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

سنقوم بالتركيز على "فهم اللغة" في هذا المقال، ونعمل مع واجهة برمجة تطبيقات التحليلات النصية. تتيح لك واجهة برمجة تطبيقات التحليلات النصية هذه الكشف عن المشاعر والعبارات الرئيسية والمواضيع واللغة من النص. لنبدأ الآن من خلال تجربة عرض تجريبي لـ API.

المتطلبات الأساسية

قبل البدء في إنشاء تطبيق لوحة باستخدام API للتحليلات النصية، يجب إعداد مورد التحليلات النصية. لمزيد من التفاصيل، انتقل إلى متطلبات API التحليلات النصية.

إنشاء التطبيق وإضافة اتصال

تلميح

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

إنشاء تطبيق فارغ وإضافة اتصال مع موصل التحليلات النصية.

ابدأ بإنشاء تطبيق لوحة فارغباستخدام تخطيط الكمبيوتر اللوحي، واسم مثل "التطبيق التوضيحي مستخدمًا واجهة برمجة تطبيقات التحليلات النصية".
حدد بيانات من الجزء الأيسر.
ابحث عن اتصال التحليلات النصية.
أدخل قيم مفتاح الحساب و عنوان URL للموقع.

يمكن البحث قيم مفتاح الحساب و عنوان URL لموقع الويب من المفتاح و نقطة النهاية باستخدام مدخل Azure.
حدد اتصال.

أصبح تطبيقك الآن متصلا بنوع مورد الخدمات الإدراكية لنوع API الخاص التحليلات النصية في Azure.

تصميم التطبيق

في هذا القسم، سوف تصمم التطبيق التجريبي مع عناصر التحكم المطلوبة للعمل مع API التحليلات النصية. بعد الانتهاء من تصميم التطبيق، ستبدو هذه هي الطريقة:

تطبيق العرض التوضيحي.

ملاحظة

يوضح التطبيق في هذا البرنامج التعليمي كيفية بدء استخدام API للتحليلات النصية في Power Apps. إذا كنت ترغب في تصميم التطبيق من البداية، أو الوفاء بمتطلبات الأعمال الخاصة، يمكنك تخصيص هذا التطبيق التوضيحي، أو إضافة مباشرة، تكوينعناصر التحكم واستخدام إجراءات API للتحليلات النصية بدلا من ذلك.
يتم اقتراح قيم لخصائص المكون مثل المحاذاة والحجم واللون والموضع (X، Y) في هذا البرنامج التعليمي. قد تختلف القيم الفعلية بناء على تخطيط التطبيق الذي تحدده. يمكنك أيضا تغيير هذه القيم المقترحة لتصميم التطبيق حسب المتطلبات الخاصة بك.

تحديد من الجزء الأيسر.
حدد تسمية النص.

قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية	قيمة
نص	"التحليلات النصية"
الحجم	36
اللون	RGBA(255, 255, 255, 1)
ملء	RGBA(56, 96, 178, 1)
محاذاة	Align.Center
X	0
Y	0
العرض	1366
ارتفاع	98

إدراج تسمية نصية.

قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية	قيمة
نص	"أدخل النص الخاص بك، حدد خياراتك، ثم حدد 'تحليل النص'"
الحجم	16
محاذاة	Align.Left
X	24
Y	135
العرض	601
ارتفاع	60

إدراج خانة اختيار.
قم بتغيير خصائص خانة الاختيار من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم chkLanguage

نص "اللغة‬"

الحجم 16

X 24

Y 228
إدراج خانة اختيار.
قم بتغيير خصائص خانة الاختيار من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم chkSentiment

نص "التوجه"

الحجم 16

X 230

Y 228
إدراج خانة اختيار.
قم بتغيير خصائص خانة الاختيار من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم chkEL

نص "رابط الكيان"

الحجم 16

X 403

Y 228

العرض 200

ارتفاع 50
إدراج خانة اختيار.
قم بتغيير خصائص خانة الاختيار من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم chkPhrases

نص "العبارات الأساسية"

الحجم 16

X 24

Y 286

العرض 193

ارتفاع 50
إدراج خانة اختيار.
قم بتغيير خصائص خانة الاختيار من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم chkNER

نص "تمييز الكيان المسمى"

الحجم 16

X 230

Y 286

العرض 318

ارتفاع 50
قم بإدراج إدخال النص.
قم بتغيير خصائص خانة الاختيار من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم tiTextToAnalyze

نص "أدخل نصًا"

الوضع متعدد الأسطر

الحجم 14

ارتفاع 256

العرض 557

X 24

Y 390
قم بإدراج زر.
قم بتغيير خصائص الزر من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم analyzeText

نص "تحليل النص"

X 189

Y 684

العرض 196

ارتفاع 53

الحجم 16
إدراج تسمية نصية.
قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم dLanguage

نص "اللغة المكتشفة:"

الحجم 16

X 633

Y 135

العرض 665

ارتفاع 48
إدراج تسمية نصية.
قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم sScore

نص "درجة التوجه:"

الحجم 16

X 633

Y 196

العرض 656

ارتفاع 48
حدد إدراج -> معرض -> عمودي فارغ.
قم بتغيير خصائص المعرض من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم gallerySS

التخطيط ‏‫المسمى الوظيفي

X 826

Y 196

العرض 503

ارتفاع 62
حدد رمز السهم داخل المعرض واحذفه.
تغيير الخصائص التالية للصف الأول داخل المعرض.

اسم الخاصية قيمة

X 16

ارتفاع 63
إدراج تسمية نصية.
قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية قيمة

نص "الكيانات المرتبطة:"

الحجم 16

X 633

Y 258

العرض 206

ارتفاع 48
حدد إدراج -> معرض -> عمودي فارغ.
قم بتغيير خصائص المعرض من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم galleryLE

التخطيط العنوان والعنوان الفرعي

X 633

Y 318

العرض 696

ارتفاع 87
حدد رمز السهم داخل المعرض واحذفه.
إدراج تسمية نصية.
قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية قيمة

نص "العبارات الأساسية:"

الحجم 16

X 633

Y 429

العرض 150

ارتفاع 48
حدد إدراج -> معرض -> عمودي فارغ.
قم بتغيير خصائص المعرض من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم galleryKP

التخطيط ‏‫المسمى الوظيفي

X 633

Y 489

العرض 696

ارتفاع 87
حدد رمز السهم داخل المعرض واحذفه.
تغيير الخصائص التالية للصف الأول داخل المعرض.

اسم الخاصية قيمة

X 16

ارتفاع 87
إدراج تسمية نصية.
قم بتغيير خصائص التسمية من خلال التكوين التالي.

اسم الخاصية قيمة

نص "الكيانات المسماة"

الحجم 16

X 633

Y 589

العرض 193

ارتفاع 48
حدد إدراج -> معرض -> عمودي فارغ.
قم بتغيير خصائص المعرض من خلال التكوين التالي.

اسم الخاصية قيمة

الاسم galleryNER

التخطيط ‏‫المسمى الوظيفي

X 633

Y 670

العرض 696

ارتفاع 87
حدد رمز السهم داخل المعرض واحذفه.
تغيير الخصائص التالية للصف الأول داخل المعرض.

اسم الخاصية قيمة

X 16

ارتفاع 87

اسم الخاصية	قيمة
الاسم	chkLanguage
نص	"اللغة‬"
الحجم	16
X	24
Y	228

اسم الخاصية	قيمة
الاسم	chkSentiment
نص	"التوجه"
الحجم	16
X	230
Y	228

اسم الخاصية	قيمة
الاسم	chkEL
نص	"رابط الكيان"
الحجم	16
X	403
Y	228
العرض	200
ارتفاع	50

اسم الخاصية	قيمة
الاسم	chkPhrases
نص	"العبارات الأساسية"
الحجم	16
X	24
Y	286
العرض	193
ارتفاع	50

اسم الخاصية	قيمة
الاسم	chkNER
نص	"تمييز الكيان المسمى"
الحجم	16
X	230
Y	286
العرض	318
ارتفاع	50

اسم الخاصية	قيمة
الاسم	tiTextToAnalyze
نص	"أدخل نصًا"
الوضع	متعدد الأسطر
الحجم	14
ارتفاع	256
العرض	557
X	24
Y	390

اسم الخاصية	قيمة
الاسم	analyzeText
نص	"تحليل النص"
X	189
Y	684
العرض	196
ارتفاع	53
الحجم	16

اسم الخاصية	قيمة
الاسم	dLanguage
نص	"اللغة المكتشفة:"
الحجم	16
X	633
Y	135
العرض	665
ارتفاع	48

اسم الخاصية	قيمة
الاسم	sScore
نص	"درجة التوجه:"
الحجم	16
X	633
Y	196
العرض	656
ارتفاع	48

اسم الخاصية	قيمة
الاسم	gallerySS
التخطيط	‏‫المسمى الوظيفي
X	826
Y	196
العرض	503
ارتفاع	62

اسم الخاصية	قيمة
X	16
ارتفاع	63

اسم الخاصية	قيمة
نص	"الكيانات المرتبطة:"
الحجم	16
X	633
Y	258
العرض	206
ارتفاع	48

اسم الخاصية	قيمة
الاسم	galleryLE
التخطيط	العنوان والعنوان الفرعي
X	633
Y	318
العرض	696
ارتفاع	87

اسم الخاصية	قيمة
نص	"العبارات الأساسية:"
الحجم	16
X	633
Y	429
العرض	150
ارتفاع	48

اسم الخاصية	قيمة
الاسم	galleryKP
التخطيط	‏‫المسمى الوظيفي
X	633
Y	489
العرض	696
ارتفاع	87

اسم الخاصية	قيمة
X	16
ارتفاع	87

اسم الخاصية	قيمة
نص	"الكيانات المسماة"
الحجم	16
X	633
Y	589
العرض	193
ارتفاع	48

اسم الخاصية	قيمة
الاسم	galleryNER
التخطيط	‏‫المسمى الوظيفي
X	633
Y	670
العرض	696
ارتفاع	87

اسم الخاصية	قيمة
X	16
ارتفاع	87

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

تصميم التطبيق.

إضافة منطق إلى التطبيق

الآن، وقد قمت بإنشاء بنية أساسية للتطبيق مع التصميم المتوقع، لنضيف منطقا إلى التطبيق حتى يمكننا استخدام الخدمات الإدراكية في Power Apps.

ملاحظة

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

نسخ الصيغة التالية ولصقها كقيمة خاصية OnSelect للزر analyzeText.

ClearCollect( languageInfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", countryHint: "US", text: tiTextToAnalyze.Text } );
TextAnalytics.LanguagesV3(languageInfo);
If( chkLanguage.Value=true,
    ClearCollect( languageCollect,
        TextAnalytics.LanguagesV3(languageInfo).documents.detectedLanguage
    )
);
ClearCollect( phrasesInfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } );
If( chkPhrases.Value = true,
    ClearCollect( phrasesCollect,
        TextAnalytics.KeyPhraseV3(phrasesInfo).documents.keyPhrases
    )
);
ClearCollect( sentimentInfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } );
If( chkSentiment.Value = true,
    ClearCollect( sentimentCollect,
        TextAnalytics.SentimentV3(sentimentInfo).documents.confidenceScores
    )
);      
ClearCollect( nerinfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } );
If( chkNER.Value = true,
    ClearCollect( nerCollect,
        TextAnalytics.EntitiesRecognitionGeneralV3(nerinfo).documents.entities
    )
);
ClearCollect( elinfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } );
If( chkEL.Value = true,
    ClearCollect( elCollect,
        TextAnalytics.EntitiesLinkingV3(elinfo).documents.entities
    )
);

في هذه الخطوة، تستخدم الصيغة الوظائف التالية.

ClearCollect - ينشئ مجموعات لكل خيار (خانات اختيار) لاستخدامها مع الخدمات الإدراكية. هناك مجموعتين مستخدمتين. أولا لتجميع المعلومات من إدخال النص ( tiTextToAnalyze). وبعد ذلك، مجموعة ثانية لتخزين نتائج استدعاءات API ذات الصلة بالتحليلات النصية.
إجراءات API للتحليلات النصية للخدمات الإدراكية - تستخدم في الصيغة لتخزين تفاصيل التحليل في المجموعات المحلية. الإجراءات المستخدمة: اكتشاف اللغة (V3.0) (الإصدار الأولي)، التوجه (V3.0) (الإصدار الأولي)، ربط الكيان (V3.0) (الإصدار الأولي)، العبارات الرئيسية (V3.0) (الإصدار الأولي)، تمييز الكيان المسمى (V3.0) (الإصدار الأولي)

نسخ الصيغة التالية ولصقها كقيمة خاصية Text للزر dLanguage.
```
"Detected language: " & First(languageCollect.detectedLanguage).detectedLanguage.name
```
في هذه الخطوة، تستخدم الصيغة الوظيفة الأولى لإرجاع اللغة المحددة من خلال API التحليلات النصية وعرضها.
حدد مصدر البيانات gallerySS باعتباره sentimentCollect.
حدد الصف الأول داخل معرض gallerySS. وبعد ذلك، قم بنسخ الصيغة التالية لـ خاصية النص ولصقها.
```
"Positive: " & ThisItem.confidenceScores.positive &" Neutral: " & ThisItem.confidenceScores.neutral & " Negative: " & ThisItem.confidenceScores.negative
```
وفي هذه الخطوة، تستخدم الصيغة نقاط دقة محللة بواسطة API للتحليلات النصية من أجل عرضها في المعرض.
حدد مصدر بيانات galleryLE باعتباره elCollect.
حدد الصف الثاني داخل معرض galleryLE. وبعد ذلك، قم بنسخ الصيغة التالية لـ خاصية النص ولصقها.
```
Concat(ThisItem.entities.url,url,", ")
```
في هذه الخطوة، يتم استخدام الدالة Concat لإرجاع سلسلة مفردة مفصولة ب فاصلات مع عناوين URL للكيانات المدرجة التي تم تعريفها بواسطة API التحليلات النصية.
حدد الصف الأول داخل معرض galleryLE. وبعد ذلك، قم بنسخ الصيغة التالية لـ خاصية النص ولصقها.
```
Concat(ThisItem.entities.name,name,", ")
```
في هذه الخطوة، يتم استخدام الدالة Concat لإرجاع سلسلة مفردة مفصولة ب فاصلات للكيانات المحددة بواسطة API التحليلات النصية.
حدد مصدر بيانات galleryKP باعتباره phrasesCollect.
حدد الصف الأول داخل معرض galleryKP. وبعد ذلك، قم بنسخ الصيغة التالية لـ خاصية النص ولصقها.
```
Concat(ThisItem.keyPhrases.Value, Value, ", ")
```
في هذه الخطوة، يتم استخدام الدالة Concat لإرجاع سلسلة مفردة مفصولة ب فاصلات بعبارات رئيسية محددة بواسطة API التحليلات النصية.
حدد مصدر بيانات galleryNER باعتباره nerCollect.
حدد الصف الأول داخل معرض galleryNER. وبعد ذلك، قم بنسخ الصيغة التالية لـ خاصية النص ولصقها.
```
Concat(ThisItem.entities.text,text,", ")
```
في هذه الخطوة، يتم استخدام الدالة Concat لإرجاع سلسلة مفردة مفصولة ب فاصلات بكيانات محددة بواسطة API التحليلات النصية.
حفظ التطبيق ونشره.

تشغيل التطبيق واختباره

معاينة التطبيق، أو اضغط على F5 على لوحة المفاتيح.
أدخل نموذج نص، مثل ما يلي.

Cognitive Services brings AI within reach of every developer—without requiring machine-learning expertise. All it takes is an API call to embed the ability to see, hear, speak, search, understand, and accelerate decision-making into your apps. Enable developers of all skill levels to easily add AI capabilities to their apps with modern application development.
حدد كافة خانات الاختيار الخمس.
تحديد تحليل النص.
يرجى مراجعة المخرج.