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

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

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

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

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

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

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

إشعار

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

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

إنشاء مورد Text Analytics

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

1. قم بتسجيل الدخول إلى بوابة Azure.

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

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

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

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

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

6. حدد "Review + create".

7. حدد إنشاء.

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

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

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

1. حدد Keys and Endpoint.

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

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

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

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

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

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

2. حدد إنشاء.

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

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

4. حدد "Review + create".

5. حدد إنشاء.

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

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

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

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

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

3. حدد الزر إضافة.

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 وX وواجهة برمجة تطبيقات خدمات Azure الذكاء الاصطناعي.

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

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

2. حدد إضافة.

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

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

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

4. حدد "Review + create".

5. حدد إنشاء.

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

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

   

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

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

الاتصال ب X

أنشئ اتصالا ب X حتى يتمكن تطبيقك من الاستقصاء عن التغريدات الجديدة.

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

2. حدد الرمز X.

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

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

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

5. حدد تسجيل الدخول.

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

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

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

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

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

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

1. حدد خطوة جديدة.

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

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

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

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

5. حدد إنشاء.

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. حدد خطوة جديدة.

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

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

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

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

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

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

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

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

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

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

3. حدد شرط.

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

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

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

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

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

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

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

4. حدد الزر تسجيل الدخول.

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. من حساب X الخاص بك، قم بتغريد النص التالي: أنا أستمتع #my-x-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. حدد الزر حذف.

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

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

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