البرنامج التعليمي: إنشاء دالة للتكامل مع تطبيقات Azure Logic

تتكامل Azure Functions مع تطبيقات Azure Logic في Logic Apps Designer. يتيح لك هذا التكامل استخدام القوة الحاسوبية للدوال في عمليات متناغمة مع خدمات Azure الأخرى وخدمات الجهات الخارجية.

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

ستتعلم في هذا البرنامج التعليمي ما يلي:

• إنشاء مورد واجهة برمجة تطبيقات لخدمات الذكاء الاصطناعي Azure.
• قم بإنشاء دالة تصنف مشاعر التغريد.
• قم بإنشاء تطبيق Logic يتصل بـ Twitter.
• أضف اكتشاف المشاعر إلى تطبيق Logic.
• قم بتوصيل تطبيق Logic بالدالة.
• أرسل بريدًا إلكترونيًّا بناءً على استجابة الدالة.

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

• حساب Twitter نشط.
• حساب Outlook.com (لإرسال الإعلامات).

ملاحظة

إذا كنت ترغب في استخدام موصل Gmail، يمكن فقط لحسابات الأعمال G-Suite استخدام هذا الموصل دون قيود في تطبيقات Logic. إذا كان لديك حساب عميل Gmail، فيمكنك استخدام موصل Gmail مع تطبيقات وخدمات معينة معتمدة من Google فقط، أو يمكنك إنشاء تطبيق عميل Google لاستخدامه للمصادقة في موصل Gmail.

لمزيد من المعلومات، راجع نُهج الخصوصية وأمان البيانات لموصلات Google في تطبيقات Azure Logic.

إنشاء مورد Text Analytics

تتوفر واجهات برمجة تطبيقات خدمات الذكاء الاصطناعي Azure في Azure كموارد فردية. استخدم واجهة برمجة تطبيقات Text Analytics لاكتشاف مشاعر التغريدات المنشورة.

1. تسجيل الدخول إلى ⁧مدخل Microsoft Azure⁧.

2. حدد Create a resource في الزاوية العلوية اليسرى من مدخل Microsoft Azure.

3. في Categories حدد AI + التعلم الآلي

4. ضمن Text Analytics، حدد Create.

5. أدخل القيم التالية في شاشة Create Text Analytics.

   إعداد	القيمة	الملاحظات
   الاشتراك	اسم اشتراك Azure خاصتك
   resourceGroup	إنشاء مجموعة موارد جديدة باسم tweet-sentiment-tutorial	لاحقًا، ستحذف resourceGroup هذه لإزالة كافة الموارد التي تم إنشاؤها أثناء هذا البرنامج التعليمي.
   المنطقة	اختر أقرب منطقة إليك
   الاسم	TweetSentimentApp
   مستوى الأسعار	حدد Free F0

6. حدد Review + create.

7. حدد Create.

8. بمجرد اكتمال النشر، حدد Go to Resource.

الحصول على إعدادات Text Analytics

مع إنشاء مورد تحليلات النص، ستقوم بنسخ بعض الإعدادات وتعيينها جانبًا لاستخدامها لاحقًا.

1. حدد Keys and Endpoint.

2. انسخ Key 1 بالنقر فوق الرمز الموجود في نهاية مربع الإدخال.

3. ألصق القيمة في محرر نصوص.

4. انسخ Endpointبالنقر فوق الأيقونة الموجودة في نهاية مربع الإدخال.

5. ألصق القيمة في محرر نصوص.

إنشاء تطبيق الدالة

1. من مربع البحث العلوي، ابحث عن Function app وحدده.

2. حدد Create.

3. أدخِل القيم الآتية.

   الإعداد	القيم المقترحة	الملاحظات
   الاشتراك	اسم اشتراك Azure خاصتك
   resourceGroup	tweet-sentiment-tutorial	استخدم نفس اسم resourceGroup خلال هذا البرنامج التعليمي.
   اسم تطبيق الوظائف	TweetSentimentAPI + لاحقة فريدة	أسماء تطبيقات الوظائف فريدة من نوعها على مستوى العالم. الأحرف الصالحة هي ⁧a-z (غير حساسة لحالة الأحرف)، و⁧0-9، و⁧-.
   نشر	رمز
   مكدس وقت التشغيل	.NET	رمز الدالة المقدم لك موجود في #C.
   إصدار	حدد رقم الإصدار الأخير
   المنطقة	اختر أقرب منطقة إليك

4. حدد Review + create.

5. حدد Create.

6. بمجرد اكتمال النشر، حدد Go to Resource.

إنشاء وظيفة تم تشغيلها في بروتوكول نقل نص تشعبي

1. من القائمة اليمنى لنافذة Functions، حدد Functions.

2. حدد Addمن القائمة العلوية وأدخل القيم التالية.

   إعداد	القيمة	الملاحظات
   بيئة التطوير	Develop in portal
   قالب	مشغل HTTP
   دالة جديدة	TweetSentimentFunction	هذا هو اسم دالتك.
   مستوى التخويل	وظيفة

3. حدد الزر Add.

4. حدد الزر Code + Test.

5. قم بلصق التعليمة البرمجية التالية في نافذة محرر التعليمة البرمجية.

   #r "Newtonsoft.Json"
   
   using System;
   using System.Net;
   using Microsoft.AspNetCore.Mvc;
   using Microsoft.Extensions.Logging;
   using Microsoft.Extensions.Primitives;
   using Newtonsoft.Json;
   
   public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
   {
   
       string requestBody = String.Empty;
       using (StreamReader streamReader =  new  StreamReader(req.Body))
       {
           requestBody = await streamReader.ReadToEndAsync();
       }
   
       dynamic score = JsonConvert.DeserializeObject(requestBody);
       string value = "Positive";
   
       if(score < .3)
       {
           value = "Negative";
       }
       else if (score < .6) 
       {
           value = "Neutral";
       }
   
       return requestBody != null
           ? (ActionResult)new OkObjectResult(value)
          : new BadRequestObjectResult("Pass a sentiment score in the request body.");
   }
   

   يتم تمرير درجة المشاعر إلى الدالة، والتي تُرجع اسم فئة للقيمة.

6. حدد الزر Save على شريط الأدوات لحفظ التغييرات.

   ملاحظة

   لاختبار الدالة، حدد Test/Runمن القائمة العلوية. في علامة التبويب Input، أدخل قيمة 0.9 في مربع الإدخال Body، ثم حدد Run. تحقق من إرجاع قيمة موجبة في المربع HTTP response content في قسم Output.

بعد ذلك، قم بإنشاء تطبيق منطقي يتكامل مع Azure Functions وTwitter وواجهة برمجة تطبيقات خدمات azure الذكاء الاصطناعي.

إنشاء تطبيق منطق

1. من مربع البحث العلوي، ابحث عن Logic Apps وحددها.

2. حدد ⁧إضافة⁧.

3. حدد Consumption وأدخل القيم التالية.

   إعداد	القيم المقترحة
   الاشتراك	اسم اشتراك Azure خاصتك
   resourceGroup	tweet-sentiment-tutorial
   ⁧اسم تطبيق المنطق⁧	TweetSentimentApp
   المنطقة	حدد المنطقة الأقرب إليك، ويفضل أن تكون نفس المنطقة التي حددتها في الخطوات السابقة.

   اقبل القيم الافتراضية لجميع الإعدادات الأخرى.

4. حدد Review + create.

5. حدد Create.

6. بمجرد اكتمال النشر، حدد Go to Resource.

7. حدد الزر Blank Logic App.

   

8. حدد الزر Save على شريط الأدوات لحفظ تقدمك.

يمكنك الآن استخدام Logic Apps Designer لإضافة خدمات ومشغلات إلى تطبيقك.

الاتصال بتويتر

قم بإنشاء اتصال بتويتر حتى يتمكن تطبيقك من التصويت على التغريدات الجديدة.

1. ابحث عن Twitter في مربع البحث العلوي.

2. حدد أيقونة Twitter.

3. حدد مشغل When a new tweet is posted.

4. أدخل القيم التالية لإعداد الاتصال.

   إعداد	القيمة
   Connection name	MyTwitterConnection
   نوع المصادقة	استخدام التطبيق الافتراضي المشترك

5. حدد "Sign in".

6. اتبع المطالبات في النافذة المنبثقة لإكمال تسجيل الدخول إلى Twitter.

7. بعد ذلك، أدخل القيم التالية في المربع When a new tweet is posted.

   إعداد	القيمة
   نص البحث	#my-twitter-tutorial
   كم مرة تريد التحقق من العناصر؟	1 في مربع النص، و ساعة في القائمة المنسدلة. يمكنك إدخال قيم مختلفة ولكن تأكد من مراجعة القيود الحالية لموصل Twitter.

8. حدد الزر Save على شريط الأدوات لحفظ تقدمك.

بعد ذلك، اتصل بـ Text Analytics لاكتشاف مشاعر التغريدات التي تم جمعها.

إضافة الكشف عن المشاعر في text analytics

1. حدد New step.

2. ابحث عن Text Analytics في مربع البحث.

3. حدد أيقونة Text Analytics.

4. حدد Detect Sentiment وأدخل القيم التالية.

   إعداد	القيمة
   Connection name	TextAnalyticsConnection
   ‏‏مفتاح الحساب	ألصق مفتاح حساب Text Analytics الذي وضعته جانبًا في وقت سابق.
   عنوان URL للموقع	ألصق نقطة نهاية Text Analytics التي وضعتها جانبًا في وقت سابق.

5. حدد Create.

6. انقر داخل المربع Add new parameter، وحدد المربع بجوار documents الذي يظهر في النافذة المنبثقة.

7. انقر داخل مربع نص documents Id - 1 لفتح النافذة المنبثقة للمحتوى الديناميكي.

8. في مربع البحث dynamic content، ابحث عن id، وانقر على Tweet id.

9. انقر داخل مربع نص documents Text - 1 لفتح النافذة المنبثقة للمحتوى الديناميكي.

10. في مربع البحث dynamic content، ابحث عن text، وانقر على Tweet text.

11. في Choose an action، اكتب Text Analytics، ثم انقر على الإجراء Detect sentiment.

12. حدد الزر Save على شريط الأدوات لحفظ تقدمك.

يجب أن يبدو مربع Detect Sentimentمثل لقطة الشاشة التالية.

قم بتوصيل إخراج المشاعر بنقطة نهاية الدالة

1. حدد New step.

2. ابحث عن Azure Functions في مربع البحث.

3. حدد أيقونة Azure Functions.

4. ابحث عن اسم دالتك في مربع البحث. إذا اتبعت الإرشادات أعلاه، فسيبدأ اسم دالتك بـ TweetSentimentAPI.

5. حدد أيقونة الدالة.

6. حدد العنصر TweetSentimentFunction.

7. انقر داخل مربع Request Body، وحدد عنصر Detect Sentimentscoreمن النافذة المنبثقة.

8. حدد الزر Save على شريط الأدوات لحفظ تقدمك.

أضف خطوة شرطية

1. حدد الزر Add an action.

2. انقر داخل مربع Control، وابحث عن وحدد Control في النافذة المنبثقة.

3. حدد Condition.

4. انقر داخل المربع Choose a value، وحدد العنصر TweetSentimentFunctionBodyمن النافذة المنبثقة.

5. أدخل Positive في المربع Choose a value.

6. حدد الزر Save على شريط الأدوات لحفظ تقدمك.

أضف إخطارات البريد الإلكتروني

1. ضمن المربع True، حدد الزر Add an action.

2. ابحث عن وحدد Office 365 Outlook في مربع النص.

3. ابحث عن Send وحدد Send an email في مربع النص.

4. حدد الزر Sign in.

5. اتبع المطالبات في النافذة المنبثقة لإكمال تسجيل الدخول إلى Office 365 Outlook.

6. أدخل عنوان بريدك الإلكتروني في المربع To.

7. انقر داخل مربع Subject وانقر على عنصر Body ضمن TweetSentimentFunction. إذا لم يظهر عنصر Body في القائمة، فانقر فوق الرابط See more لتوسيع قائمة الخيارات.

8. بعد عنصر Body في Subject، أدخل النص Tweet from: .

9. بعد النص Tweet from: ، انقر فوق المربع مرة أخرى وحدد User nameمن قائمة الخيارات When a new tweet is posted.

10. انقر داخل مربع Body وحدد Tweet text ضمن قائمة الخيارات عند نشر تغريدة جديدة. إذا لم يظهر عنصر Tweet text في القائمة، فانقر فوق الرابط See more لتوسيع قائمة الخيارات.

11. حدد الزر Save على شريط الأدوات لحفظ تقدمك.

يجب أن يبدو صندوق البريد الإلكتروني الآن مثل لقطة الشاشة هذه.

تشغيل سير العمل

1. من حسابك على Twitter، غرد بالنص التالي: I'm enjoying #my-twitter-tutorial.

2. ارجع إلى Logic Apps Designer وحدد الزر Run.

3. تحقق من بريدك الإلكتروني بحثًا عن رسالة من سير العمل.

تنظيف الموارد

لتنظيف جميع خدمات وحسابات Azure التي تم إنشاؤها أثناء هذا البرنامج التعليمي، احذف resourceGroup.

1. ابحث عن Resource groups في مربع البحث العلوي.

2. حدد tweet-sentiment-tutorial.

3. حدد Delete resource group

4. أدخل tweet-sentiment-tutorial في مربع النص.

5. حدد زر Delete.

اختياريًّا، قد ترغب في العودة إلى حساب Twitter الخاص بك وحذف أي تغريدات اختبارية من خلاصتك.

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

إنشاء واجهة برمجة تطبيقات بلا خادم باستخدام Azure Functions