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

1- مقدمة

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

يستدعي المستخدم أمرًا يبدأ بشرطة مائلة /summarize ويُدخل النص المطلوب تلخيصه. بعد ذلك، يستدعي تطبيق Slack دالة Cloud المرتبطة التي تقبل النص وتستدعي PaLM API لإجراء التلخيص. ثم يتم إرجاع النص الملخّص إلى أمر Slack الذي يبدأ بشرطة مائلة وعرضه كردّ في تطبيق Slack.

. فيما يلي قائمة بخدمات Google Cloud المستخدَمة:

  1. وظائف السحابة الإلكترونية
  2. ‫Vertex AI PaLM API
  3. Cloud Logging

ما ستنشئه

ستنشئ

  • دالة Cloud تستدعي PaLM API لتلخيص النص الوارد من Slack باستخدام الأمر الذي يبدأ بشرطة مائلة
  • تطبيق Slack يستدعي دالة Cloud أعلاه لإجراء التلخيص.

2. المتطلبات

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

3- قبل البدء

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

4. نشر دالة Cloud

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

  1. استنسِخ الرمز من المستودع https://github.com/rominirani/genai-apptemplates-googlecloud من خلال تنفيذ الأمر التالي في Cloud Shell:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
  1. سيؤدي هذا الأمر إلى استنساخ محتويات المستودع في المجلد genai-templates-googlecloud.
  2. انتقِل إلى مجلد المشروع الذي يهمّنا من خلال تنفيذ الأمر التالي من Cloud Shell Terminal:
cd genai-apptemplates-googlecloud/summarization-slack
  1. يجب أن يظهر لك الملفان main.py وrequirements.txt في مجلد summarization-slack إما من خلال تنفيذ الأمر dir أو من خلال الانتقال إلى Cloud Shell Editor.
  2. لنشر دالة Cloud، شغِّل الأمر gcloud functions deploy:
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 الذي يبدأ بشرطة مائلة.

5. إنشاء أمر Slack الذي يبدأ بشرطة مائلة

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

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

  1. انتقِل إلى api.slack.com/apps.
  2. انقر على إنشاء تطبيق جديد (Create New App).
  3. في نافذة إنشاء تطبيق (Create an app) ، اختَر الخيار من البداية (From scratch).
  4. أدخِل اسمًا لتطبيقك. على سبيل المثال، Summarization Slack Application. اختَر مساحة عمل Slack لتطوير تطبيقك.
  5. انقر على إنشاء تطبيق (Create App). ستُفتح صفحة الإعدادات (Settings).
  6. في صفحة الإعدادات (Settings) ، انقر على المعلومات الأساسية (Basic Information) > الأوامر التي تبدأ بشرطة مائلة (Slash Commands). انقر على إنشاء أمر جديد (Create New Command).
  7. في نموذج إنشاء أمر جديد (Create New Command) ، أدخِل القيم التالية:
  • الأمر (Command): أدخِل أمرًا يبدأ بشرطة مائلة. على سبيل المثال، /summarize.
  • عنوان URL للطلب (Request URL): أدخِل عنوان URL الكامل لدالة Cloud التي نشرناها. على سبيل المثال، https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
  • أدخِل وصفًا قصيرًا وتلميحًا حول الاستخدام، ثم انقر على "حفظ".
  1. ارجِع إلى الإعدادات (Settings) > المعلومات الأساسية (Basic Information). انقر على تثبيت تطبيقك (Install your app) ، ثم انقر على التثبيت في مساحة العمل (Install to Workspace). تم تثبيت التطبيق في مساحة عملك.

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

6. اختبار الأمر الذي يبدأ بشرطة مائلة

  1. انتقِل إلى مساحة عمل Slack حيث ثبَّت تطبيق Summarization Slack Application:

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

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

bcb511e5909709db.png

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

a62b223f30bb163e.png

7. إخلاء مساحة

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

  1. في Google Cloud Console، انتقِل إلى صفحة إدارة الموارد.
  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف (Delete).
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف (Shut down) لحذف المشروع.
  4. إذا أردت الاحتفاظ بمشروعك، يمكنك تخطّي الخطوات أعلاه وحذف دالة Cloud من خلال الانتقال إلى Cloud Functions، ومن قائمة الدوال، ضَع علامة في المربّع بجانب الدالة التي تريد حذفها وانقر على "حذف".

8. تهانينا

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