Slack Command Automation

1. مقدمه

در این کد لبه، می‌توانید دستورالعمل‌هایی را برای ایجاد یک سرویس خلاصه‌سازی در یک فضای کاری Slack با ارائه یکپارچگی با دستور Slack Slash پیدا کنید.

کاربر یک دستور Slash /summarize فراخوانی می کند و متنی را که قرار است خلاصه شود وارد می کند. سپس برنامه Slack تابع Cloud مربوطه را فراخوانی می کند که متن را می پذیرد و API palm را برای خلاصه سازی فراخوانی می کند. سپس متن خلاصه شده به دستور Slack Slash برمی گردد و به عنوان پاسخ در برنامه Slack نمایش داده می شود.

. لیست سرویس های Google Cloud مورد استفاده عبارتند از:

  1. توابع ابری
  2. Vertex AI PalM API
  3. ثبت ابر

چیزی که خواهی ساخت

شما ایجاد خواهید کرد

  • یک تابع Cloud که با استفاده از دستور Slash، API palm را برای خلاصه کردن متن روی متنی که از Slack می‌آید فراخوانی می‌کند.
  • برنامه Slack که تابع Cloud فوق را برای خلاصه سازی فراخوانی می کند.

2. الزامات

  • مرورگری مانند کروم یا فایرفاکس
  • یک پروژه Google Cloud با فعال کردن صورت‌حساب

3. قبل از شروع

  1. در Google Cloud Console ، در صفحه انتخاب پروژه، یک پروژه Google Cloud را انتخاب یا ایجاد کنید
  2. مطمئن شوید که صورتحساب برای پروژه Google Cloud شما فعال است. با نحوه بررسی فعال بودن صورت‌حساب در پروژه آشنا شوید
  3. مطمئن شوید که Cloud Functions API و Vertex AI API فعال هستند.
  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. با اجرای دستور زیر در ترمینال Cloud Shell خود، کد را از repo https://github.com/rominirani/genai-apptemplates-googlecloud کلون کنید: 
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 و requires.txt را در پوشه summarization-slack یا با اجرای دستور dir یا با رفتن به Cloud Shell Editor ببینید.
  2. برای استقرار تابع Cloud، دستور deploy توابع 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 نمایش داده می شود. URL در قالب زیر است:

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

به URL نمایش داده شده توجه کنید، برای ایجاد دستور Slack Slash لازم است.

5. دستور Slack Slash را ایجاد کنید

بیایید یک دستور Slash سفارشی در Slack ایجاد کنیم. این دستور سفارشی /summarize تابع Cloud را که در بخش قبلی به کار گرفته‌ایم فراخوانی می‌کند.

برای ایجاد یک دستور اسلش مراحل زیر را انجام دهید:

  1. به api.slack.com/apps بروید.
  2. روی ایجاد برنامه جدید کلیک کنید.
  3. در پنجره Create an app ، گزینه From scratch را انتخاب کنید.
  4. یک نام برای برنامه خود وارد کنید. به عنوان مثال، Summarization Slack Application. Slack Workspace را برای توسعه برنامه خود انتخاب کنید.
  5. روی ایجاد برنامه کلیک کنید. صفحه تنظیمات باز می شود.
  6. در صفحه تنظیمات ، روی اطلاعات پایه > دستورات اسلش کلیک کنید. روی Create New Command کلیک کنید.
  7. در فرم Create New Command مقادیر زیر را وارد کنید:
  • دستور : دستور اسلش بدهید. برای مثال /summarize.
  • درخواست URL : نشانی اینترنتی کامل تابع Cloud را که ما مستقر کرده‌ایم ارائه دهید. برای مثال، https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
  • توضیحات کوتاه، راهنمایی استفاده را وارد کنید و ذخیره کنید.
  1. به تنظیمات > اطلاعات پایه برگردید. روی Install your app و سپس Install to Workspace کلیک کنید. برنامه در فضای کاری شما نصب شده است.

این کار ایجاد برنامه Slack سفارشی را تکمیل می کند که اکنون در Slack Workspace شما نصب شده است و دارای یک دستور Slash سفارشی ( /summarize ) است که به کاربر کمک می کند متنی را که در پیام ارائه می دهد خلاصه کند.

6. دستور Slash را تست کنید

  1. به فضای کاری Slack بروید که در آن برنامه Summarization Slack را نصب کرده اید:

به https://slack.com/intl/en-in/workspace-signin بروید و «Find your workspaces» را وارد کنید تا نام فضای کاری خود را پیدا کنید. آن را انتخاب کنید.

  1. در چت، متنی که با دستور اسلش " /summarize " پیشوند شده است را وارد کنید. یک فراخوان نمونه در زیر نشان داده شده است:

bcb511e5909709db.png

  1. بر روی دکمه Send کلیک کنید تا تابع Cloud را فراخوانی کنید و پاسخ خلاصه را مطابق شکل زیر نمایش دهید:

a62b223f30bb163e.png

7. پاکسازی کنید

برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این پست، این مراحل را دنبال کنید:

  1. در کنسول Google Cloud، به صفحه مدیریت منابع بروید.
  2. در لیست پروژه، پروژه ای را که می خواهید حذف کنید انتخاب کنید و سپس روی Delete کلیک کنید.
  3. در محاوره، شناسه پروژه را تایپ کنید و سپس روی Shut down کلیک کنید تا پروژه حذف شود.
  4. اگر می‌خواهید پروژه خود را حفظ کنید، مراحل بالا را رد کنید و با رفتن به Cloud Function، تابع Cloud را حذف کنید و از لیست توابع، موردی را که می‌خواهید حذف کنید را علامت بزنید و روی DELETE کلیک کنید.

8. تبریک می گویم

تبریک می گویم! شما با موفقیت یک سرویس خلاصه سازی متن را در برنامه Slack ایجاد کردید.