يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق Google Chat للاستجابة للحوادث في الوقت الفعلي. عند الاستجابة لحادث ما، فإن التطبيق إنشاء "مساحة Chat" وتعبئتها، ما يسهّل وقوع الحوادث التي تتضمّن الرسائل وأوامر الشرطة المائلة ومربّعات الحوار وتستخدم الذكاء الاصطناعي لتلخيص الرد على الحادث في مستند مستندات Google.
الحادثة هي حدث يتطلب اهتمامًا فوريًا من فريق الأشخاص لحلها. تشمل أمثلة الحوادث ما يلي:
- يتم إنشاء حالة حساسة للوقت في إدارة العلاقات مع العملاء (CRM) وتتطلب من فريق خدمة التعاون في إيجاد حل لها.
- انقطاع اتصال النظام بالإنترنت لتنبيه مجموعة من مهندسي موثوقية المواقع الإلكترونية (SRE) لكي يتمكّنوا من العمل معًا لإعادة عرضها على الإنترنت.
- يحدث زلزال قوي ويحتاج عمال الطوارئ لتنسيق ردودهم.
لأغراض هذا البرنامج التعليمي، يبدأ التنبيه بشأن الحادث عندما ويبلغ عن الحادث بنقرة زر من إحدى صفحات الويب. تحاكي صفحة الويب لحادث من خلال مطالبة المستخدمين بإدخال معلومات أساسية عن الحادثة: العنوان، ووصفها وعناوين بريدها الإلكتروني للمجيبين.
الاطّلاع على طريقة عمل تطبيق Chat لإدارة الحوادث:
-
الشكل 1. الموقع الإلكتروني الذي يمكن فيه الإبلاغ عن حادثة. -
الشكل 2. إشعار بأنّه تم إنشاء "مساحة Chat" للحادثة. -
الشكل 3. الاستجابة للحادثة في "مساحة Chat" -
الشكل 4 حل المشكلة باستخدام أمر شرطة مائلة. -
الشكل 5 مربّع حوار حلّ الحادثة -
الشكل 6. تحليل الحادثة التي تمت مشاركتها في مستند "مستندات Google" في مساحة -
الشكل 7 مستند حل حادثة ملخّص الذكاء الاصطناعي في "مستندات Google"
المتطلبات الأساسية
في حال الحاجة إلى تفعيل أي من هذه المتطلبات الأساسية لمؤسستك، اطلب لتفعيلها، يمكن لمشرف Google Workspace:
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- من أجل الدليل تم تفعيل (مشاركة جهات الاتصال) في Google Workspace. يستخدم تطبيق العرقلة الدليل للبحث عن جهات الاستجابة للحوادث معلومات الاتصال، مثل الاسم وعنوان بريدك الإلكتروني. يجب أن يكون المجيبون على الحوادث من مستخدمي تطبيق Google Chat. في مؤسسة Google Workspace.
الأهداف
- إنشاء تطبيق في Chat للاستجابة للحوادث
- ساعِد المستخدمين على التعامل مع الحوادث من خلال اتّباع الخطوات التالية:
- إنشاء مساحات للاستجابة للحوادث
- نشر رسائل تلخّص الحوادث والردود
- دعم التعاون من خلال ميزات تطبيق Chat.
- تلخيص المحادثات والحلول باستخدام Vertex AI
البنية
يوضح الرسم التخطيطي التالي بنية Google Workspace موارد Google Cloud التي تم استخدامها في الاستجابة لمحاولات الاختراق الأمني تطبيق Google Chat
توضح البنية كيفية الاستجابة للحوادث يعالج تطبيق Google Chat إحدى الحوادث وحلولاً لها.
بدء مستخدم حادثة من موقع إلكتروني خارجي تتم استضافته على برمجة التطبيقات.
يرسل الموقع الإلكتروني طلب HTTP غير متزامن إلى تطبيق Google Chat، مستضاف أيضًا على "برمجة التطبيقات".
يعالج تطبيق Google Chat للاستجابة للحوادث الطلب:
تحصل خدمة SDK لمشرف "برمجة التطبيقات" على عضو في الفريق معلومات، مثل رقم تعريف المستخدم وعنوان البريد الإلكتروني.
مع مجموعة من طلبات HTTP إلى Chat API باستخدام خدمة الدردشة المتقدّمة لبرمجة التطبيقات، الاستجابة للحادث واجه تطبيق Google Chat حادثة في Chat المساحة، وتعبئتها بأعضاء الفريق، وإرسال رسالة إلى المساحة.
يناقش أعضاء الفريق الحادث في "مساحة Chat".
يستدعي أحد أعضاء الفريق أمر الشرطة المائلة للإشارة إلى حل حادثة.
طلب HTTP إلى Chat API باستخدام "برمجة تطبيقات Google" تسرد خدمة الدردشة المتقدمة جميع ميزات Chat رسائل المساحة.
يتلقّى Vertex AI الرسائل المُدرجة وينشئ ملخّصًا.
تنشئ خدمة "برمجة تطبيقات Google"
DocumentApp
إضافة ملخص Vertex AI إلى جلسة المراجعة.الاستجابة للحوادث في تطبيق Google Chat Chat API لإرسال رسالة تشارك رابطًا يؤدي إلى الملخّص مستند في "مستندات Google"
تحضير البيئة
يعرض هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده من أجل تطبيق Chat
إنشاء مشروع على Google Cloud
وحدة التحكّم في Google Cloud
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول و المشرف > إنشاء مشروع. .
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع. بعد إنشاء المشروع، لذا اختر رقم تعريف يلبي احتياجاتك طوال مشروعك.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة. مشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل Google Cloud Console إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك. في غضون بضع دقائق.
واجهة سطر الأوامر gcloud
في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud واجهة سطر الأوامر (`gcloud`):
-
Cloud Shell: لاستخدام وحدة طرفية على الإنترنت مع gcloud CLI
سبق أن تم إعداده، يُرجى تفعيل Cloud Shell.
تفعيل Cloud Shell -
Local Shell: لاستخدام بيئة تطوير محلية،
تثبيت
الإعداد
واجهة سطر الأوامر gcloud.
لإنشاء مشروع على السحابة الإلكترونية، استخدِم الأمر `gcloud project create`:gcloud projects create PROJECT_ID
تفعيل الفوترة للمشروع على Google Cloud
وحدة التحكّم في Google Cloud
- في وحدة تحكُّم Google Cloud، انتقِل إلى الفوترة. (يُرجى النقر.) قائمة الطعام > الفوترة > مشاريعي.
- في القسم اختيار مؤسسة، اختَر المؤسسة المرتبطة مشروعك على Google Cloud
- في صف المشروع، افتح قائمة الإجراءات. ( ), انقر على تغيير الفوترة، واختر حساب فوترة Cloud.
- انقر على ضبط الحساب.
واجهة سطر الأوامر gcloud
- لسرد حسابات الفوترة المتاحة، شغِّل:
gcloud billing accounts list
- ربط حساب فوترة بمشروع على Google Cloud:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
استبدِل ما يلي:
PROJECT_ID
هو رقم تعريف المشروع المشروع على السحابة الإلكترونية الذي تريد تفعيل الفوترة لهBILLING_ACCOUNT_ID
هو رقم تعريف حساب الفوترة المطلوب الربط به. لمشروع Google Cloud.
تفعيل واجهات برمجة التطبيقات
وحدة التحكّم في Google Cloud
في Google Cloud Console، فعِّل Google Chat API وGoogle Docs API واجهة برمجة التطبيقات Admin SDK API وVertex AI API
تأكَّد من تفعيل واجهات برمجة التطبيقات بالشكل الصحيح مشروع على Google Cloud، ثم انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
واجهة سطر الأوامر gcloud
إذا لزم الأمر، اضبط المشروع الحالي على السحابة الإلكترونية على المشروع الذي أنشأته. باستخدام الأمر
gcloud config set project
:gcloud config set project PROJECT_ID
استبدِل PROJECT_ID برقم تعريف المشروع المشروع الذي أنشأته على السحابة الإلكترونية
تفعيل 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 لمعالجة أي حادثة.
في هذا الدليل التوجيهي، ستنشر التطبيق داخليًا ليكون بإمكانك استخدام العنصر النائب المعلومات. قبل نشر التطبيق خارجيًا، استبدِل العنصر النائب ومعلومات حقيقية عن شاشة الموافقة.
في وحدة التحكّم في Google Cloud، انتقِل إلى قائمة الطعام > واجهات برمجة التطبيقات و الخدمات > شاشة موافقة OAuth:
ضمن نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
في اسم التطبيق، اكتب
Incident Management
.في البريد الإلكتروني المخصّص لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google.
ضمن معلومات الاتصال بالمطوِّر، أدخِل عنوان بريدك الإلكتروني.
انقر على حفظ ومتابعة.
انقر على إضافة نطاقات أو إزالتها. تظهر لوحة تحتوي على قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعَّلتها في مشروعك على Google Cloud.
ضمن إضافة النطاقات يدويًا، الصِق النطاقات التالية:
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
انقر على إضافة إلى الجدول.
انقر على تعديل.
انقر على حفظ ومتابعة.
راجِع ملخّص تسجيل التطبيق، ثم انقر على الرجوع إلى لوحة البيانات.
إنشاء تطبيق Chat ونشره
في القسم التالي، يمكنك نسخ وتحديث كامل مشروع "برمجة تطبيقات Google" الذي يحتوي على جميع التطبيقات المطلوبة رمز تطبيق في Google Chat، لذلك ليست هناك حاجة إلى نسخ ولصق كل ملف.
تتضمن بعض الدوال شرطات سفلية في نهاية أسمائها، مثل
processSlashCommand_()
من ChatApp.gs
. تخفي الشرطة السفلية الدالة
من صفحة الويب الخاصة بتهيئة الحادث عندما تكون مفتوحة في متصفّح. لمزيد من المعلومات،
المعلومات، راجع
الوظائف الخاصة:
تتوافق "برمجة تطبيقات Google" مع نوعَي من الملفات، هما .gs
نص برمجي و.html
.
الملفات. للالتزام بهذا الدعم، يتم تضمين JavaScript من جهة العميل للتطبيق.
داخل علامات <script />
ويتم تضمين خدمة مقارنة الأسعار (CSS) الخاصة به ضمن علامات <style />
ملف HTML.
يمكنك اختياريًا عرض المشروع بالكامل على GitHub.
في ما يلي نظرة عامة على كل ملف:
Consts.gs
لتحديد الثوابت المشار إليها في ملفات التعليمات البرمجية الأخرى، بما في ذلك رقم تعريف مشروعك على Google Cloud ومعرّف موقع Vertex AI معرّف أمر شرطة مائلة لإغلاق حادثة.
عرض رمز
Consts.gs
ChatApp.gs
التعامل مع أحداث التفاعل في Chat، بما في ذلك الرسائل، والنقرات على البطاقة، والأوامر التي تبدأ بشرطة مائلة، ومربّعات الحوار. يستجيب إلى طلب
/closeIncident
بشرطة مائلة من خلال فتح مربّع حوار لجمع معلومات عن الحادثة تفاصيل الحل. يقرأ الرسائل في المساحة من خلال استدعاء طريقة واحدة (spaces.messages.list
) في Chat API. الحصول على أرقام تعريف المستخدمين باستخدام خدمة "دليل SDK للمشرف" في برمجة التطبيقات.عرض رمز
ChatApp.gs
ChatSpaceCreator.gs
تلقي بيانات النموذج التي يدخلها المستخدمون حول الحادث صفحة الويب الخاصة بالتهيئة وتستخدمها لإعداد Chat من خلال إنشائها وملؤها، ثم نشر رسالة حول حادثة.
عرض رمز
ChatSpaceCreator.gs
DocsApi.gs
استدعاء واجهة برمجة تطبيقات مستندات Google لإنشاء مستند مستندات Google في حساب Google Drive الخاص بالمستخدم ويكتب ملخصًا عن معلومات الحادث، تم إنشاؤه في
VertexAiApi.gs
بالمستند.عرض رمز
DocsApi.gs
VertexAiApi.gs
تلخيص المحادثة في Chat إلى الفضاء باستخدام Vertex AI تم نشر هذا الملخص في ملف تم إنشاؤه بشكل خاص مستند في
DocsAPI.gs
.عرض رمز
VertexAiApi.gs
WebController.gs
عرض الموقع الإلكتروني الخاص بتهيئة العرقلة
عرض رمز
WebController.gs
Index.html
محتوى HTML الذي يتألف من الموقع الإلكتروني الخاص بتهيئة الحادثة
عرض رمز
Index.html
JavaScript.html
الأسماء المعرِّفة لسلوك النموذج، بما في ذلك عمليات الإرسال وإصلاح الأخطاء في الموقع الإلكتروني الخاص بتهيئة العرقلة. مضمَّن إلى
Index.html
بواسطة الدالةinclude
المخصصة فيWebController.gs
.عرض رمز
JavaScript.html
Stylesheet.html
خدمة مقارنة الأسعار (CSS) للموقع الإلكتروني الخاص بتهيئة العرقلة من المهم تم تضمينه في
Index.html
من خلال الدالةinclude
المخصصة فيWebController.gs
عرض رمز
Stylesheet.html
البحث عن رقم مشروعك على Google Cloud ورقم تعريفه
في وحدة التحكّم في Google Cloud، انتقِل إلى مشروعك على Google Cloud.
انقر على "الإعدادات والأدوات المساعدة" > إعدادات المشروع.
دوِّن القيم في حقلَي رقم المشروع ورقم تعريف المشروع. إِنْتَ كيفية استخدامها في الأقسام التالية.
إنشاء مشروع "برمجة تطبيقات Google"
لإنشاء مشروع "برمجة تطبيقات Google" وربطه المشروع على السحابة الإلكترونية:
- انقر على الزر التالي لفتح مشروع الردّ على الحوادث باستخدام Google Chat في "برمجة تطبيقات Google".
فتح المشروع - انقر على رمز نظرة عامة.
- في صفحة النظرة العامة، انقر على
إنشاء نسخة.
تسمية نسختك من مشروع برمجة التطبيقات:
انقر على نسخة من "الرد على الحوادث باستخدام Google Chat".
في عنوان المشروع، اكتب
Incident Management Chat app
.انقر على إعادة تسمية.
في نسختك من مشروع "برمجة التطبيقات"، انتقِل إلى
Consts.gs
. واستبدلYOUR_PROJECT_ID
بمعرّف ملف المشروع على السحابة الإلكترونية.
إعداد مشروع "برمجة تطبيقات Google" على السحابة الإلكترونية
- في مشروع "برمجة تطبيقات Google"،
انقر على
إعدادات المشروع.
- ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
- في رقم مشروع Google Cloud Platform، الصِق رقم مشروع مشروعك على Google Cloud.
- انقر على ضبط المشروع. المشروع على السحابة الإلكترونية و"برمجة تطبيقات Google" يرتبط بها مشروعك الآن.
إنشاء عملية نشر "برمجة تطبيقات Google"
الآن وبعد أن أصبحت جميع الرموز في مكانها الصحيح، انشر النص البرمجي لـ Apps مشروعك. يمكنك استخدام معرّف النشر عند ضبط تطبيق Chat في Google Cloud.
في "برمجة تطبيقات Google"، افتح مشروع تطبيق الاستجابة للحوادث.
انقر على نشر > عملية نشر جديدة:
إذا لم يتم تحديد الإضافة وتطبيق الويب من قبل، بجانب اختَر النوع، وانقر على أنواع النشر
ثم اختَر إضافة وتطبيق ويب.
في الوصف، أدخِل وصفًا لهذا الإصدار، مثل
Complete version of incident management app
في تنفيذ باسم، اختَر مستخدم يصل إلى تطبيق الويب.
في القسم من لديه إذن الوصول، اختَر أي شخص داخل مؤسستك على Workspace، حيث تظهر عبارة "مؤسستك على Workspace" هو اسم Google Workspace.
انقر على نشر. تم بنجاح إعداد تقارير "برمجة تطبيقات Google" النشر وتوفير رقم تعريف نشر وعنوان URL للحادثة صفحة الويب الخاصة بالتهيئة.
دوِّن عنوان URL لتطبيق الويب للرجوع إليه لاحقًا عند بدء حادثة. انسخ رقم تعريف النشر. وتستخدم هذا المعرّف أثناء إعداد تطبيق Chat في Google Cloud Console
انقر على تم.
ضبط تطبيق Chat في وحدة تحكّم Google Cloud
يعرض هذا القسم كيفية ضبط Google Chat API في وحدة تحكّم Google Cloud. بمعلومات عن تطبيق Chat، بما في ذلك رقم تعريف عملية النشر التي أنشأتها للتو من "برمجة تطبيقات Google" مشروعك.
في وحدة تحكُّم Google Cloud، انقر على القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعداد.
في اسم التطبيق، اكتب
Incident Management
.في عنوان URL للصورة الرمزية، اكتب
https://developers.google.com/chat/images/quickstart-app-avatar.png
.في الوصف، اكتب
Responds to incidents.
.انقر على مفتاح التبديل تفعيل الميزات التفاعلية لتفعيله.
ضمن الوظائف، اختَر تلقّي الرسائل بين شخصين، الانضمام إلى المساحات والمحادثات الجماعية.
ضمن إعدادات الربط، اختَر مشروع برمجة التطبيقات.
في رقم تعريف النشر، الصِق رقم تعريف نشر برمجة التطبيقات الذي نسخته سابقًا من مشروع "برمجة التطبيقات" النشر.
سجِّل أمرًا شرطة مائلة تريد يستخدم تطبيق Chat الذي تم تنفيذه بالكامل ما يلي:
ضمن أوامر الشرطة المائلة، انقر على إضافة أمر شرطة مائلة.
في الاسم، اكتب
/closeIncident
.في رقم تعريف الطلب، اكتب
1
.في الوصف، اكتب
Closes the incident being discussed in the space.
انقر على فتح مربّع حوار.
انقر على تم. تم تسجيل الأمر slash وإدراجه.
ضمن مستوى الرؤية، اختَر إتاحة تطبيق Chat هذا لمستخدمين محدّدين ومجموعات محدّدة في Workspace Domain وأدخِل عنوان بريدك الإلكتروني.
ضمن السجلات، اختَر تسجيل الأخطاء في التسجيل.
انقر على حفظ. تظهر رسالة محفوظة للإعدادات، ما يعني أن التطبيق وجاهزة للاختبار.
اختبار تطبيق Chat
لاختبار تطبيق Chat لإدارة الحوادث، عليك بدء حادثة من صفحة الويب وتحقَّق من أن تطبيق Chat على النحو المتوقع:
انتقِل إلى عنوان URL لتطبيق الويب لنشر "برمجة التطبيقات".
عندما تطلب "برمجة التطبيقات" الإذن بالوصول إلى بياناتك، انقر على مراجعة الأذونات، ثم سجِّل الدخول باستخدام حساب Google مناسب. في نطاق Google Workspace، ثم انقر على السماح.
يتم فتح صفحة الويب الخاصة بتهيئة الحادثة. أدخِل معلومات الاختبار:
- في عنوان الحادثة، اكتب
The First Incident
. - أدخِل عناوين البريد الإلكتروني لكل من المجيبين على الحوادث، إذا أردت ذلك زملائك من المستجيبين للحوادث. يجب أن يكونوا من المستخدمين الذين لديهم حساب Google Chat في مؤسستك على Google Workspace فشل إنشاء مساحة. لا تدخل عنوان بريدك الإلكتروني لأنه تلقائيًا.
- في الرسالة الأولية، اكتب
Testing the incident management Chat app.
.
- في عنوان الحادثة، اكتب
انقر على إنشاء مساحة Chat. ستظهر رسالة
creating space
.بعد إنشاء المساحة، تظهر رسالة
Space created!
. (يُرجى النقر.) فتح المساحة: يؤدي هذا الإجراء إلى فتح المساحة في Chat في علامة تبويب جديدة.يمكنك، إذا أردت، أنت والجهات الأخرى المستجيبة للحوادث إرسال رسائل من خلال مساحة. يلخص التطبيق هذه الرسائل باستخدام Vertex AI ويشارك وثيقة جلسة مراجعة.
لإنهاء الاستجابة للحادث وبدء عملية الحل، في مساحة Chat، اكتب
/closeIncident
. إدارة الحوادث يفتح مربع حوارفي إغلاق الحادثة، أدخِل وصفًا لحل الحادث، مثل
Test complete
.انقر على إغلاق الحادثة.
يسرد تطبيق "إدارة الحوادث" الرسائل في المساحة ويلخصها باستخدام Vertex AI، يلصق الملخّص في مستند على "مستندات Google" ويشارك الوثيقة في المساحة.
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
- الإجابة عن الأسئلة استنادًا إلى المحادثات مع تطبيق Gemini AI Chat
- إدارة المشاريع باستخدام Google Chat وVertex AI وFirestore
- يعمل تطبيق الاستجابة للحوادث على المصادقة باستخدام بيانات اعتماد المستخدم لطلب واجهات برمجة التطبيقات.
واستدعاء خدمات Google Cloud، مثل Chat API وVertex AI API.
هذا يعني أن المستخدم الذي يقوم بإعداد الحادثة يجب أن يكون لديه حق الوصول إلى هذه
لجعل التطبيق أكثر فعالية، ننصحك بطلب واجهة برمجة تطبيقات Vertex AI
باستخدام حساب خدمة بدلاً من بيانات اعتماد المستخدم لاستدعاء
أمر الشرطة المائلة
/closeIncident
. للحصول على مساعدة في إعداد حساب خدمة عن theVertex AI API، يُرجى الاطّلاع على استخدام حساب خدمة مخصّص