با Google Chat، Vertex AI و Apps Script به حوادث پاسخ دهید

این آموزش نشان می دهد که چگونه یک برنامه چت گوگل بسازید که به حوادث در زمان واقعی پاسخ می دهد. هنگام پاسخ به یک حادثه، برنامه یک فضای چت ایجاد و پر می کند، حل حادثه را با پیام ها، دستورات اسلش و دیالوگ ها تسهیل می کند و از هوش مصنوعی برای خلاصه کردن پاسخ حادثه در سند Google Docs استفاده می کند.

یک حادثه رویدادی است که برای حل آن نیاز به توجه فوری یک تیم از افراد دارد. نمونه هایی از حوادث عبارتند از:

  • یک مورد حساس به زمان در یک پلتفرم مدیریت ارتباط با مشتری (CRM) ایجاد می‌شود که نیاز به یک تیم خدماتی برای همکاری در یک قطعنامه دارد.
  • سیستمی آفلاین می‌شود و به گروهی از مهندسین قابلیت اطمینان سایت (SRE) هشدار می‌دهد تا بتوانند با همکاری یکدیگر آن را به صورت آنلاین بازگردانند.
  • زمین لرزه ای با شدت بزرگی رخ می دهد و نیروهای اورژانس باید واکنش خود را هماهنگ کنند.

برای اهداف این آموزش، هشدار حادثه زمانی شروع می‌شود که شخصی با کلیک یک دکمه از یک صفحه وب، حادثه را گزارش کند. صفحه وب با درخواست از کاربران برای وارد کردن اطلاعات اولیه حادثه: عنوان، توضیحات و آدرس های ایمیل پاسخ دهندگان، یک حادثه را شبیه سازی می کند.

برنامه چت مدیریت حوادث را در عمل ببینید:

  • وب سایتی که یک حادثه را شروع می کند.
    شکل 1. وب سایتی که در آن شخصی می تواند یک حادثه را گزارش کند.
  • اعلان ایجاد فضای چت حادثه.
    شکل 2. اطلاع رسانی مبنی بر ایجاد فضای چت اتفاقی.
  • پاسخ حادثه فضای چت.
    شکل 3. پاسخ حادثه فضای چت.
  • حل حادثه با دستور اسلش.
    شکل 4. حل حادثه با دستور اسلش.
  • گفتگوی حل حادثه.
    شکل 5. گفتگوی حل حادثه.
  • سند Google Docs وضوح حادثه در فضا به اشتراک گذاشته شده است.
    شکل 6. سند Google Docs تفکیک رخداد به اشتراک گذاشته شده در فضا.
  • حل و فصل اتفاقات خلاصه هوش مصنوعی Google Doc.
    شکل 7. سند Google Docs حل و فصل خلاصه AI.

پیش نیازها

اگر به هر یک از این پیش نیازها برای سازمانتان نیاز دارید، از سرپرست Google Workspace خود بخواهید آنها را روشن کند:

  • یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .
  • برای روشن کردن دایرکتوری (اشتراک‌گذاری مخاطبین) برای Google Workspace. برنامه حادثه از دایرکتوری برای جستجوی اطلاعات تماس پاسخ دهندگان حادثه مانند نام و آدرس ایمیل استفاده می کند. پاسخ دهندگان حادثه باید کاربرانی با حساب Google Chat در سازمان Google Workspace شما باشند.

اهداف

  • یک برنامه چت بسازید که به حوادث پاسخ می دهد.
  • با انجام کارهای زیر به کاربران کمک کنید به حوادث واکنش نشان دهند:
    • ایجاد فضاهای واکنش به حادثه
    • ارسال پیام های خلاصه ای از حوادث و پاسخ ها.
    • پشتیبانی از همکاری با ویژگی های برنامه چت تعاملی.
  • مکالمات و قطعنامه ها را با Vertex AI خلاصه کنید.

معماری

نمودار زیر معماری Google Workspace و منابع Google Cloud را نشان می‌دهد که توسط برنامه واکنش به حادثه Google Chat استفاده می‌شود.

معماری واکنش حادثه برنامه چت Google

این معماری نشان می‌دهد که برنامه چت Google چگونه یک حادثه و حل را پردازش می‌کند.

  1. یک کاربر یک حادثه را از یک وب سایت خارجی که در Apps Script میزبانی شده است شروع می کند.

  2. این وب‌سایت یک درخواست HTTP ناهمزمان را به برنامه چت Google ارسال می‌کند که همچنین در Apps Script میزبانی می‌شود.

  3. پاسخ حادثه برنامه Google Chat این درخواست را پردازش می کند:

    1. سرویس Apps Script Admin SDK اطلاعات اعضای تیم مانند شناسه کاربر و آدرس ایمیل را دریافت می‌کند.

    2. با مجموعه‌ای از درخواست‌های HTTP برای Chat API با استفاده از سرویس Apps Script Advanced Chat، برنامه پاسخ حادثه Google Chat فضای گپ حادثه‌ای ایجاد می‌کند، آن را با اعضای تیم پر می‌کند و پیامی را به فضا ارسال می‌کند.

  4. اعضای تیم در فضای چت درباره این حادثه بحث می کنند.

  5. یکی از اعضای تیم یک فرمان اسلش را فراخوانی می‌کند تا به حل حادثه اشاره کند.

    1. یک تماس HTTP به Chat API با استفاده از سرویس Apps Script Advanced Chat، همه پیام‌های فضای چت را فهرست می‌کند.

    2. Vertex AI پیام های لیست شده را دریافت می کند و یک خلاصه تولید می کند.

    3. سرویس Apps Script DocumentApp یک سند Docs ایجاد می کند و خلاصه Vertex AI را به سند اضافه می کند.

    4. پاسخ حادثه برنامه چت Google Chat API را برای ارسال پیامی که پیوندی به سند خلاصه اسناد را به اشتراک می‌گذارد، فرا می‌خواند.

محیط را آماده کنید

این بخش نحوه ایجاد و پیکربندی یک پروژه Google Cloud را برای برنامه Chat نشان می دهد.

یک پروژه Google Cloud ایجاد کنید

کنسول Google Cloud

  1. در کنسول Google Cloud، به منو > IAM & Admin > ایجاد پروژه بروید.

    به Create a Project بروید

  2. در قسمت Project Name یک نام توصیفی برای پروژه خود وارد کنید.

    اختیاری: برای ویرایش شناسه پروژه ، روی ویرایش کلیک کنید. شناسه پروژه پس از ایجاد پروژه قابل تغییر نیست، بنابراین شناسه ای را انتخاب کنید که نیازهای شما را برای طول عمر پروژه برآورده کند.

  3. در قسمت Location ، روی Browse کلیک کنید تا مکان های احتمالی پروژه شما نمایش داده شود. سپس، روی انتخاب کلیک کنید.
  4. روی ایجاد کلیک کنید. کنسول Google Cloud به صفحه داشبورد می رود و پروژه شما در عرض چند دقیقه ایجاد می شود.

gcloud CLI

در یکی از محیط‌های توسعه زیر، به Google Cloud CLI ( gcloud ) دسترسی پیدا کنید:

  • Cloud Shell : برای استفاده از ترمینال آنلاین با Gcloud CLI که قبلاً راه اندازی شده است، Cloud Shell را فعال کنید.
    Cloud Shell را فعال کنید
  • Local Shell : برای استفاده از یک محیط توسعه محلی، gcloud CLI را نصب و مقداردهی اولیه کنید .
    برای ایجاد یک پروژه Cloud، از دستور gcloud projects create استفاده کنید:
    gcloud projects create PROJECT_ID
     با تنظیم شناسه پروژه ای که می خواهید ایجاد کنید، PROJECT_ID جایگزین کنید.

صورتحساب پروژه Cloud را فعال کنید

کنسول Google Cloud

  1. در کنسول Google Cloud، به Billing بروید. > صورت‌حساب > پروژه‌های من کلیک کنید.

    به Billing for My Projects بروید

  2. در انتخاب سازمان ، سازمان مرتبط با پروژه Google Cloud خود را انتخاب کنید.
  3. در ردیف پروژه، منوی Actions ( ) را باز کنید، روی Change billing کلیک کنید و حساب Cloud Billing را انتخاب کنید.
  4. روی تنظیم حساب کلیک کنید.

gcloud CLI

  1. برای فهرست کردن حساب‌های صورت‌حساب موجود، اجرا کنید: 
    gcloud billing accounts list
  2. پیوند یک حساب صورت‌حساب با پروژه Google Cloud:
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    موارد زیر را جایگزین کنید:

    • PROJECT_ID شناسه پروژه برای پروژه Cloud است که می‌خواهید صورت‌حساب را برای آن فعال کنید.
    • BILLING_ACCOUNT_ID شناسه حساب صورت‌حساب برای پیوند با پروژه Google Cloud است.

API ها را فعال کنید

کنسول Google Cloud

  1. در کنسول Google Cloud، Google Chat API، Google Docs API، Admin SDK API و Vertex AI API را فعال کنید.

    API ها را فعال کنید

  2. تأیید کنید که APIها را در پروژه Cloud صحیح فعال می‌کنید، سپس روی Next کلیک کنید.

  3. تأیید کنید که API های صحیح را فعال می کنید، سپس روی فعال کردن کلیک کنید.

gcloud CLI

  1. در صورت لزوم، پروژه فعلی Cloud را روی پروژه ای که با دستور gcloud config set project ایجاد کرده اید، تنظیم کنید:

    gcloud config set project PROJECT_ID

    PROJECT_ID با Project ID پروژه Cloud که ایجاد کردید جایگزین کنید.

  2. Google Chat API، Google Docs API، Admin SDK API و Vertex AI API را با دستور gcloud services enable فعال کنید:

    gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com

احراز هویت و مجوز را تنظیم کنید

احراز هویت و مجوز به برنامه Chat اجازه می‌دهد به منابع موجود در Google Workspace و Google Cloud برای پردازش پاسخ حادثه دسترسی داشته باشد.

در این آموزش، شما برنامه را به صورت داخلی منتشر می‌کنید، بنابراین استفاده از اطلاعات مکان‌دار مشکلی ندارد. قبل از انتشار برنامه به صورت خارجی، اطلاعات مکان‌نما را با اطلاعات واقعی برای صفحه رضایت جایگزین کنید.

  1. در کنسول Google Cloud، به > بروید > برندسازی

    به برندینگ بروید

  2. اگر قبلاً آن را پیکربندی کرده اید، می توانید تنظیمات صفحه رضایت OAuth زیر را در نام تجاری ، مخاطب و دسترسی به داده پیکربندی کنید. اگر پیامی دیدید که می گوید هنوز پیکربندی نشده است ، روی شروع کلیک کنید:

    1. در قسمت اطلاعات برنامه ، در نام برنامه ، Incident Management تایپ کنید.
    2. در ایمیل پشتیبانی کاربر ، آدرس ایمیل یا یک گروه Google مناسب را انتخاب کنید.
    3. روی Next کلیک کنید.
    4. در قسمت Audience ، Internal را انتخاب کنید. اگر نمی توانید Internal را انتخاب کنید، External را انتخاب کنید.
    5. روی Next کلیک کنید.
    6. در قسمت اطلاعات تماس ، آدرس ایمیلی را وارد کنید که در آن می‌توانید از هرگونه تغییر در پروژه خود مطلع شوید.
    7. روی Next کلیک کنید.
    8. در قسمت پایان ، خط‌مشی داده‌های کاربر سرویس‌های API Google را مرور کنید و در صورت موافقت، من با خدمات Google API موافقم: خط‌مشی داده‌های کاربر را انتخاب کنید.
    9. روی Continue کلیک کنید.
    10. روی ایجاد کلیک کنید.
    11. اگر خارجی را برای نوع کاربر انتخاب کرده اید، کاربران آزمایشی را اضافه کنید:
      1. روی مخاطب کلیک کنید.
      2. در بخش تست کاربران ، روی افزودن کاربران کلیک کنید.
      3. آدرس ایمیل خود و سایر کاربران آزمایشی مجاز را وارد کنید، سپس روی ذخیره کلیک کنید.

  3. روی Access Data > Add or Remove Scopes کلیک کنید. یک پانل با لیستی از محدوده‌ها برای هر API که در پروژه Google Cloud خود فعال کرده‌اید ظاهر می‌شود.

    1. در بخش افزودن دستی دامنه‌ها ، دامنه‌های زیر را جای‌گذاری کنید:

      • https://www.googleapis.com/auth/chat.spaces.create
      • https://www.googleapis.com/auth/chat.memberships
      • https://www.googleapis.com/auth/chat.memberships.app
      • https://www.googleapis.com/auth/chat.messages
      • https://www.googleapis.com/auth/documents
      • https://www.googleapis.com/auth/admin.directory.user.readonly
      • https://www.googleapis.com/auth/script.external_request
      • https://www.googleapis.com/auth/userinfo.email
      • https://www.googleapis.com/auth/cloud-platform

    2. روی افزودن به جدول کلیک کنید.

    3. روی Update کلیک کنید.

    4. پس از انتخاب محدوده های مورد نیاز برنامه خود، در صفحه دسترسی به داده ، روی ذخیره کلیک کنید.

برنامه Chat را ایجاد و اجرا کنید

در بخش زیر، کل پروژه Apps Script را کپی کرده و به‌روزرسانی می‌کنید که حاوی تمام کدهای برنامه مورد نیاز برای برنامه چت شما است، بنابراین نیازی به کپی و جای‌گذاری هر فایل نیست.

برخی از توابع شامل زیرخط در انتهای نام خود هستند، مانند processSlashCommand_() از ChatApp.gs . زیرخط، وقتی که در مرورگر باز است، عملکرد را از صفحه وب اولیه حادثه پنهان می کند. برای اطلاعات بیشتر، توابع خصوصی را ببینید.

Apps Script از دو نوع فایل پشتیبانی می‌کند، اسکریپت‌های .gs و فایل‌های .html . برای رعایت این پشتیبانی، جاوا اسکریپت سمت سرویس گیرنده برنامه در تگ های

Stylesheet.html

CSS برای وب سایت اولیه حادثه. این تابع در Index.html توسط تابع include سفارشی در WebController.gs گنجانده شده است.

مشاهده کد Stylesheet.html

apps-script/incident-response/Stylesheet.html

شماره و شناسه پروژه Cloud خود را پیدا کنید

  1. در کنسول Google Cloud، به پروژه Cloud خود بروید.

    به کنسول Google Cloud بروید

  2. روی Settings and Utilities > تنظیمات پروژه کلیک کنید.

  3. به مقادیر موجود در قسمت Project number و Project ID توجه کنید. شما از آنها در بخش های زیر استفاده می کنید.

پروژه Apps Script را ایجاد کنید

برای ایجاد یک پروژه Apps Script و اتصال آن به پروژه Cloud:

  1. روی دکمه زیر کلیک کنید تا پروژه پاسخ به حوادث با Google Chat Apps Script باز شود.
    پروژه را باز کنید
  2. نمای کلی کلیک کنید.
  3. در صفحه نمای کلی، کلیک کنید نماد ایجاد یک کپی یک کپی تهیه کنید .

  4. کپی پروژه Apps Script خود را نام ببرید:

    1. روی «کپی پاسخ به حوادث با Google Chat» کلیک کنید.

    2. در عنوان پروژه ، Incident Management Chat app تایپ کنید.

    3. روی تغییر نام کلیک کنید.

  5. در کپی پروژه Apps Script خود، به فایل Consts.gs بروید و YOUR_PROJECT_ID با شناسه پروژه Cloud خود جایگزین کنید.

پروژه Cloud پروژه Apps Script را تنظیم کنید

  1. در پروژه Apps Script خود، کلیک کنید نماد تنظیمات پروژه تنظیمات پروژه
  2. در پروژه Google Cloud Platform (GCP) ، روی تغییر پروژه کلیک کنید.
  3. در شماره پروژه GCP ، شماره پروژه پروژه Cloud خود را جای‌گذاری کنید.
  4. روی تنظیم پروژه کلیک کنید. پروژه Cloud و پروژه Apps Script اکنون متصل هستند.

یک استقرار اسکریپت Apps ایجاد کنید

اکنون که همه کدها در جای خود هستند، پروژه Apps Script را اجرا کنید. وقتی برنامه Chat را در Google Cloud پیکربندی می‌کنید، از شناسه استقرار استفاده می‌کنید.

  1. در Apps Script، پروژه برنامه پاسخ به حادثه را باز کنید.

    به Apps Script بروید

  2. روی Deploy > New Deployment کلیک کنید.

  3. اگر افزونه و برنامه وب قبلاً انتخاب نشده‌اند، در کنار انتخاب نوع ، روی انواع استقرار کلیک کنید نماد تنظیمات پروژه و Add-on and Web app را انتخاب کنید.

  4. در توضیحات ، توضیحاتی را برای این نسخه وارد کنید، مانند Complete version of incident management app .

  5. در Execute as ، User accessing the web app را انتخاب کنید

  6. در چه کسی دسترسی دارد ، هر فردی را در سازمان Workspace خود انتخاب کنید، جایی که «سازمان Workspace شما» نام سازمان Google Workspace شما است.

  7. روی Deploy کلیک کنید. Apps Script استقرار موفقیت آمیز را گزارش می دهد و یک شناسه استقرار و یک URL برای صفحه وب اولیه سازی حادثه ارائه می دهد.

  8. URL برنامه وب را یادداشت کنید تا بعداً هنگام شروع یک حادثه از آن بازدید کنید. شناسه استقرار را کپی کنید. هنگام پیکربندی برنامه Chat در کنسول Google Cloud از این شناسه استفاده می‌کنید.

  9. روی Done کلیک کنید.

برنامه چت را در کنسول Google Cloud پیکربندی کنید

این بخش نحوه پیکربندی Google Chat API را در کنسول Google Cloud با اطلاعاتی درباره برنامه Chat خود، از جمله شناسه پیاده‌سازی که به تازگی از پروژه Apps Script خود ایجاد کرده‌اید، نشان می‌دهد.

  1. در کنسول Google Cloud، > محصولات بیشتر > Google Workspace > کتابخانه محصول > Google Chat API > مدیریت > پیکربندی کلیک کنید.

    به تنظیمات Chat API بروید

  2. در نام برنامه ، Incident Management تایپ کنید.

  3. در URL آواتار ، https://developers.google.com/chat/images/quickstart-app-avatar.png را تایپ کنید.

  4. در توضیحات ، Responds to incidents. .

  5. روی گزینه فعال کردن ویژگی های تعاملی در موقعیت روشن کلیک کنید.

  6. در بخش عملکرد ، دریافت پیام های 1:1 ، پیوستن به فضاها و مکالمات گروهی را انتخاب کنید.

  7. در قسمت تنظیمات اتصال ، Apps Script را انتخاب کنید.

  8. در Deployment ID ، Apps Script Deployment ID را که قبلاً از استقرار پروژه Apps Script کپی کرده‌اید، جای‌گذاری کنید.

  9. یک دستور اسلش را ثبت کنید که برنامه Chat کاملاً پیاده‌سازی شده از آن استفاده می‌کند:

    1. در زیر دستورات اسلش ، روی افزودن دستور اسلش کلیک کنید.

    2. در Name ، Close incident تایپ کنید.

    3. در Command ID 1 را تایپ کنید.

    4. در توضیحات ، Closes the incident being discussed in the space.

    5. در قسمت Command type ، دستور Slash را انتخاب کنید.

    6. در نام دستور اسلش ، /closeIncident تایپ کنید.

    7. باز کردن یک گفتگو را انتخاب کنید.

    8. روی Done کلیک کنید. دستور اسلش ثبت و فهرست شده است.

  10. در قسمت Visibility ، این برنامه چت را برای افراد و گروه‌های خاصی در دامنه کاری خود در دسترس قرار دهید، انتخاب کنید و آدرس ایمیل خود را وارد کنید.

  11. در زیر گزارش‌ها ، Log errors to Logging را انتخاب کنید.

  12. روی ذخیره کلیک کنید. یک پیام ذخیره شده پیکربندی ظاهر می شود، به این معنی که برنامه آماده آزمایش است.

برنامه چت را تست کنید

برای آزمایش برنامه Chat مدیریت رویداد، یک حادثه را از صفحه وب شروع کنید و بررسی کنید که برنامه Chat همانطور که انتظار می رود کار می کند:

  1. به URL برنامه وب استقرار Apps Script بروید.

  2. وقتی Apps Script برای دسترسی به داده‌های شما اجازه می‌خواهد، روی بررسی مجوزها کلیک کنید، با یک حساب Google مناسب در دامنه Google Workspace خود وارد شوید و روی Allow کلیک کنید.

  3. صفحه وب اولیه سازی حادثه باز می شود. اطلاعات آزمون را وارد کنید:

    1. در عنوان Incident ، The First Incident تایپ کنید.
    2. به صورت اختیاری، در Incident Responders ، آدرس ایمیل سایر پاسخ دهندگان حادثه را وارد کنید. آنها باید کاربرانی با حساب Google Chat در سازمان Google Workspace شما باشند، در غیر این صورت ایجاد فضا انجام نمی‌شود. آدرس ایمیل خود را وارد نکنید زیرا به صورت خودکار درج شده است.
    3. در پیام اولیه ، Testing the incident management Chat app.

  4. روی ایجاد فضای چت کلیک کنید. یک پیام creating space ظاهر می شود.

  5. پس از ایجاد فضا، یک Space created! پیام ظاهر می شود. روی Open space کلیک کنید، که فضای Chat را در یک برگه جدید باز می‌کند.

  6. در صورت تمایل، شما و سایر پاسخ دهندگان حادثه می توانید پیام هایی را در فضا ارسال کنید. این برنامه با استفاده از Vertex AI این پیام ها را خلاصه می کند و یک سند گذشته نگر را به اشتراک می گذارد.

  7. برای پایان دادن به پاسخ حادثه و شروع فرآیند حل، در فضای چت، /closeIncident تایپ کنید. یک گفتگوی مدیریت حادثه باز می شود.

  8. در Close event ، توضیحی را برای حل حادثه وارد کنید، مانند Test complete .

  9. روی Close Incident کلیک کنید.

برنامه مدیریت حادثه پیام‌های موجود در فضا را فهرست می‌کند، آنها را با Vertex AI خلاصه می‌کند، خلاصه را در سند Google Docs جای‌گذاری می‌کند و سند را در فضا به اشتراک می‌گذارد.

پاک کن

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

  1. در کنسول Google Cloud، به صفحه مدیریت منابع بروید. > IAM & Admin > Manage Resources کلیک کنید.

    به Resource Manager بروید

  2. در لیست پروژه، پروژه ای را که می خواهید حذف کنید انتخاب کنید و سپس روی حذف کلیک کنید.
  3. در گفتگو، ID پروژه را تایپ کنید و سپس بر روی Shut down کلیک کنید تا پروژه حذف شود.