التشغيل الآلي لطلبات Slack

1. مقدمة

في هذا الدرس التطبيقي حول الترميز، يمكنك العثور على تعليمات لإنشاء خدمة تلخيص في Slack Workspace من خلال توفير التكامل مع أمر Slack Slash.

يستدعي المستخدم أمر Slash Command /summarize ويدخل النص لتلخيصه. بعد ذلك، يستدعي تطبيق Slack دالة السحابة الإلكترونية المرتبطة التي تقبل النص ويستدعي PaLM API للتلخيص. بعد ذلك، يتم إرجاع النص الموجز مرة أخرى إلى أمر Slack Slash ويتم عرضه كاستجابة في تطبيق Slack.

. قائمة خدمات Google Cloud المستخدمة هي:

  1. وظائف السحابة الإلكترونية
  2. واجهة برمجة تطبيقات Vertex AI PaLM
  3. Cloud Logging

ما الذي ستقوم ببنائه

ستقوم بإنشاء

  • يشير ذلك المصطلح إلى دالة سحابية تستدعي واجهة برمجة التطبيقات PaLM لتلخيص النص في النص الوارد من Slack باستخدام أمر Slash Command.
  • تطبيق Slack الذي يستدعي دالة السحابة الإلكترونية المذكورة أعلاه للتلخيص

2. المتطلبات

  • متصفح، مثل Chrome أو Firefox
  • مشروع على Google Cloud تم تفعيل الفوترة فيه

3- قبل البدء

  1. في Google Cloud Console، ضمن صفحة أداة اختيار المشاريع، اختَر مشروعًا على Google Cloud أو أنشئه.
  2. تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. التعرُّف على كيفية التحقّق مما إذا كانت الفوترة مفعّلة في مشروع
  3. تأكَّد من تفعيل Cloud Functions API وواجهات Vertex AI.
  4. تفعيل Cloud Shell من وحدة تحكُّم Google Cloud من خلال اتّباع التعليمات الواردة هنا
  5. إذا لم يتم ضبط مشروعك، استخدِم الأمر التالي لضبطه:
gcloud config set project <YOUR_PROJECT_ID>
  1. في Cloud Shell، اضبط متغيّرات البيئة التالية:
export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1

4. نشر دالة السحابة

لإنشاء دوال Cloud ونشرها، يُرجى اتّباع الخطوات التالية:

  1. يمكنك نسخ الرمز من مستودع https://github.com/rominirani/genai-apptemplates-googlecloud من خلال تنفيذ الأمر التالي في الوحدة الطرفية في Cloud Shell:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
  1. سيؤدي هذا الأمر إلى استنساخ محتوى مستودع repo في المجلد genai-templates-googlecloud.
  2. انتقِل إلى مجلد المشروع الذي يهمّنا من خلال تنفيذ الأمر التالي من Cloud Shell Terminal:
cd genai-apptemplates-googlecloud/summarization-slack
  1. من المفترض أن يظهر لك الملفان main.py وrequirements.txt في مجلد summarization-slack إما من خلال تنفيذ الأمر dir أو الانتقال إلى "محرِّر Cloud Shell".
  2. لتفعيل ميزة Cloud Function، يمكنك تشغيل الأمر gcloud function browse (نشر وظائف gcloud:)
gcloud functions deploy summarizeText \
--gen2 \
--runtime=python311 \
--source=. \
--region=$GCP_REGION \
--project=$GCP_PROJECT \
--entry-point=summarizeText \
--trigger-http \
--set-env-vars=GCP_PROJECT=$GCP_PROJECT,GCP_REGION=$GCP_REGION \
--max-instances=1

بعد نشر دالة Cloud، يتم عرض عنوان URL لدالة Cloud التي تم نشرها على Cloud Shell Terminal. عنوان URL بالتنسيق التالي:

https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText

لاحظ عنوان URL الذي تم عرضه، سيُطلب منه إنشاء أمر Slack Slash Command.

5- إنشاء أمر Slack Slash

لنُنشئ أمر Slash Command مخصص في Slack. يستدعي هذا الأمر المخصص /summarize دالة Cloud التي نشرناها في القسم السابق.

لإنشاء أمر Slash ، اتّبِع الخطوات التالية:

  1. انتقِل إلى api.slack.com/apps.
  2. انقر على إنشاء تطبيق جديد.
  3. في نافذة إنشاء تطبيق، اختَر من البداية.
  4. أدخِل اسمًا لتطبيقك. على سبيل المثال، Summarization Slack Application. اختَر Slack Workspace لتطوير تطبيقك.
  5. انقر على إنشاء تطبيق. ستفتح صفحة الإعدادات.
  6. في صفحة الإعدادات، انقر على معلومات أساسية > الأوامر التي تبدأ بشرطة مائلة: انقر على إنشاء أمر جديد.
  7. في نموذج إنشاء أمر جديد، أدخِل القيم التالية:
  • الأمر: وجِّه أمرًا بشرطة مائلة. على سبيل المثال: /summarize.
  • عنوان URL للطلب: عليك تقديم عنوان URL الكامل لوظيفة السحابة الإلكترونية التي نشرناها. على سبيل المثال: https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
  • أدخل وصفًا موجزًا وتلميحًا للاستخدام واحفظ.
  1. ارجع إلى الإعدادات > المعلومات الأساسية: انقر على تثبيت تطبيقك، ثم انقر على تثبيت على Workspace. تثبيت التطبيق في مساحة العمل

يؤدي ذلك إلى إكمال عملية إنشاء تطبيق Slack المخصّص الذي تم تثبيته الآن في Slack Workspace ويحتوي على أمر Slash مخصّص (/summarize) يساعد المستخدم في تلخيص النص الذي يقدّمه في الرسالة.

6- اختبار الأمر Slash

  1. انتقِل إلى Slack Workspace حيث تم تثبيت تطبيق Summarization Slack:

انتقِل إلى https://slack.com/intl/en-in/workspace-signin وأدخِل "العثور على مساحات العمل". لتحديد اسم مساحة العمل. حدد ذلك.

  1. في المحادثة، أدخِل النص الذي يبدأ بالأمر الشرطة المائلة "/summarize ". في ما يلي نموذج من طلبات الاستدعاء:

bcb511e5909709db.png

  1. انقر على الزر إرسال لاستدعاء وظيفة السحابة الإلكترونية وعرض رد التلخيص كما هو موضّح أدناه:

a62b223f30bb163e.png

7. تَنظيم

لتجنُّب تحصيل رسوم من حسابك على Google Cloud مقابل الموارد المُستخدَمة في هذه المشاركة، يُرجى اتّباع الخطوات التالية:

  1. في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد.
  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف.
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف التشغيل لحذف المشروع.
  4. إذا أردت الاحتفاظ بمشروعك، تخطّي الخطوات أعلاه وحذف "دالة السحابة الإلكترونية" من خلال الانتقال إلى Cloud Functions ومن قائمة الدوال، حدِّد الوظيفة التي تريد حذفها وانقر على "حذف".

8. تهانينا

تهانينا لقد أنشأت خدمة تلخيص النصوص في تطبيق Slack بنجاح.