أدِر المشاريع باستخدام Google Chat وVertex AI وFirestore

يوضّح هذا البرنامج التعليمي كيفية إنشاء تطبيق Google Chat يمكن لفريق استخدامه لمحاولة إدارة المشاريع في الوقت الفعلي. يستخدم تطبيق Chat Vertex AI لمساعدة الفِرق في كتابة قصص المستخدمين (التي تمثّل ميزات نظام البرامج من وجهة نظر المستخدم ليتمكّن الفريق من تطويرها) ويحفظ القصص في قاعدة بيانات Firestore.

  • عند ذكر تطبيق إدارة المشاريع، يقدّم التطبيق المساعدة.
    الشكل 1. يناقش "شارلي" مع فريقه تطوير الميزات في مساحة Chat. عند الإشارة إلى تطبيق Chat لإدارة المشاريع، سيقدّم تطبيق Chat المساعدة.
  • استخدام الأمر /createUserStory الذي يبدأ بشرطة مائلة لإنشاء قصة
    الشكل 2. باستخدام الأمر /createUserStory الذي يبدأ بشرطة مائلة، أنشأت شيرين قصة.
  • يستخدم تطبيق Chat لإدارة المشاريع Vertex AI لكتابة وصف القصة.
    الشكل 3. يستخدم تطبيق Chat لإدارة المشاريع Vertex AI لكتابة وصف القصة، ثم يشارك القصة في المساحة.
  • يُنهي "شارلي" تفاصيل القصة.
    الشكل 4. ينقر "شارلي" على تعديل لإكمال تفاصيل القصة. وصف الذكاء الاصطناعي دقيق، ولكن يريد "شارلي" الحصول على مزيد من التفاصيل، لذلك ينقر على توسيع لإضافة متطلبات إلى وصف القصة باستخدام Vertex AI. يحدّد "شارلي" القصة لنفسه، ويضبط الحالة على "مُبدوءة"، ويختار الأولوية والحجم المناسبَين، ثمّ ينقر على حفظ.
  • إدارة جميع قصص المستخدمين الخاصة بالفريق
    الشكل 5. يمكن لـ "شارلي" في أي وقت الاطّلاع على جميع قصص المستخدمين للفريق وإدارتها باستخدام /manageUserStories الأمر الذي يبدأ بشرطة مائلة.

المتطلبات الأساسية

الأهداف

  • أنشئ تطبيق Chat يدير مشاريع البرامج المتغيّرة باستمرار.
  • يمكنك مساعدة المستخدمين في كتابة قصصهم باستخدام أدوات كتابة القصص المستندة إلى الذكاء الاصطناعي التوليدي والمزوّدة بخدمة Vertex AI:
    • إنشاء أوصاف القصص وإعادة إنشائها
    • وسِّع أوصاف القصص من الملاحظات لإكمال المتطلبات.
    • تصحيح الأخطاء النحوية
  • يمكنك الاحتفاظ بآخر المعلومات من خلال الكتابة إلى قاعدة بيانات Firestore والقراءة منها.
  • تسهيل التعاون في مساحة Chat من خلال السماح للمستخدمين ب إنشاء القصص وتعديلها وتحديدها وبدءها مباشرةً من المحادثة

المنتجات المستخدَمة

يستخدم تطبيق إدارة المشاريع منتجات Google Workspace و Google Cloud التالية:

  • Chat API: واجهة برمجة تطبيقات لتطوير تطبيقات Google Chat التي تتلقّى ويتفاعل معها أحداث التفاعل في Chat، مثل الرسائل يستخدم تطبيق Google Chat المخصّص لإدارة المشاريع واجهة برمجة التطبيقات Chat API لتلقّي أحداث التفاعل المُرسَلة من Chat والردّ عليها، وضبط السمات التي تحدّد كيفية ظهورها في Chat، مثل الاسم وصورة الصورة الرمزية.
  • ‫Vertex AI API: منصّة للذكاء الاصطناعي التوليدي يستخدم تطبيق Google Chat المخصّص لإدارة المشاريع واجهة برمجة التطبيقات Vertex AI API لكتابة عناوين القصص المخصّصة للمستخدمين ووصفاتها.
  • Firestore: قاعدة بيانات مستندات لا تستخدِم خادمًا يستخدم تطبيق Google Chat المخصّص لإدارة المشاريع Firebase لتخزين البيانات حول قصص المستخدمين.

  • Cloud Functions: هي خدمة حوسبة بدون خادم خفيفة الوزن تتيح لك إنشاء functions مستقلة ومخصّصة لغرض واحد يمكنها الاستجابة لأحداث تفاعل Chat بدون الحاجة إلى إدارة خادم أو بيئة وقت التشغيل. يستخدم تطبيق Google Chat لإدارة المشاريع وظائف Cloud ل استضافة نقطة نهاية HTTP التي تُرسِل إليها Chat أحداث التفاعل، وكمنصّة معالجة لتشغيل المنطق الذي يعالج هذه الأحداث ويستجيب لها.

    تستخدِم Cloud Functions منتجات Google Cloud التالية لإنشاء أحداث التفاعل ومعالجتها واستضافة موارد الحوسبة:

    • Cloud Build: منصّة تكامل وتسليم ونشر مستمر مُدارة بالكامل تُشغِّل عمليات الإنشاء المبرمَجة.
    • Pub/Sub: خدمة رسائل غير متزامنة وقابلة للتطوير تفصل بين الخدمات التي تُنشئ الرسائل والخدمات التي تعالج هذه الرسائل.
    • Cloud Run Admin API: بيئة مُدارة بالكامل لتشغيل التطبيقات المُنشأة في حاويات

الهندسة المعمارية

تتلقّى بنية تطبيق Google Chat لإدارة المشاريع أحداث تفاعل Chat ومعالجتها في نقطة نهاية HTTP، وتستخدِم Vertex AI للمساعدة في كتابة قصص المستخدمين، وتخزِّن تفاصيل قصص المستخدمين في قاعدة بيانات Firestore. يوضّح الرسم البياني التالي بنية موارد Google Workspace و Google Cloud المستخدَمة.

مخطّط بياني للبنية لتطبيق Google Chat لإدارة المشاريع

يعمل تطبيق Google Chat لإدارة المشاريع على النحو التالي:

  1. يرسل أحد المستخدمين رسالة في Chat ويشغّل تطبيق Google Chat لإدارة المشاريع إما من خلال إرسال رسالة إليه مباشرةً أو ذكره في مساحة أو إدخال أمر الشرطة المائلة.

  2. تُرسِل Chat طلب HTTP متزامنًا إلى نقطة نهاية HTTP في Cloud Function.

  3. يعالج تطبيق Google Chat لإدارة المشاريع طلب HTTP:

    1. تساعد Vertex AI في كتابة قصة مستخدم أو تعديلها.

    2. تخزِّن قاعدة بيانات Firestore بيانات قصة المستخدم أو تسترجعها أو تعدّلها أو تحذفها.

  4. تُعرِض Cloud Functions ردّ HTTP إلى Chat الذي يعرضه للمستخدم إما كرسالة أو مربّع حوار.

إعداد البيئة

يوضّح هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده لتطبيق Chat.

إنشاء مشروع على Google Cloud

Google Cloud Console

  1. في Google Cloud Console، انتقِل إلى القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إنشاء مشروع.

    الانتقال إلى "إنشاء مشروع"

  2. في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.

    اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير معرّف المشروع بعد إنشاء المشروع، لذا اختَر معرّفًا يلبي احتياجاتك طوال مدّة المشروع.

  3. في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتملة لمشروعك. بعد ذلك، انقر على اختيار.
  4. انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك خلال بضع دقائق.

gcloud CLI

في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud CLI (gcloud):

  • Cloud Shell: لاستخدام وحدة طرفية على الإنترنت تم إعداد واجهة سطر أوامر gcloud CLI عليها، فعِّل Cloud Shell.
    تفعيل Cloud Shell
  • Shell المحلي: لاستخدام بيئة تطوير محلية، ثبِّت افتح أداة gcloud CLI.
    لإنشاء مشروع على Cloud، استخدِم الأمر gcloud projects create: 
    gcloud projects create PROJECT_ID
     استبدِل PROJECT_ID بتحديد رقم تعريف المشروع الذي تريد إنشاؤه.

تفعيل الفوترة لمشروع Cloud

Google Cloud Console

  1. في Google Cloud Console، انتقِل إلى الفوترة. انقر على القائمة > الفوترة > مشاريعي.

    الانتقال إلى "الفوترة لمشاريعي"

  2. في اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على Google Cloud.
  3. في صف المشروع، افتح قائمة الإجراءات ()، وانقر على تغيير الفوترة، واختَر حساب "الفوترة في السحابة الإلكترونية".
  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.

تفعيل واجهات برمجة التطبيقات

Google Cloud Console

  1. في Google Cloud Console، فعِّل Google Chat API وVertex AI API وCloud Functions API وFirestore API وCloud Build API وPub/Sub API وCloud Run Admin API.

    تفعيل واجهات برمجة التطبيقات

  2. تأكَّد من أنّك تفعّل واجهات برمجة التطبيقات في مشروع Cloud الصحيح، ثم انقر على التالي.

  3. تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.

gcloud CLI

  1. إذا لزم الأمر، اضبط مشروع Cloud الحالي على المشروع الذي أنشأته باستخدام الأمر gcloud config set project:

    gcloud config set project PROJECT_ID

    استبدِل PROJECT_ID بـ رقم تعريف المشروع لمشروع Cloud الذي أنشأته.

  2. فعِّل Google Chat API وVertex AI API وCloud Functions API وFirestore API وCloud Build API وPub/Sub API وCloud Run Admin API باستخدام الأمر gcloud services enable:

    gcloud services enable chat.googleapis.com \
aiplatform.googleapis.com \
cloudfunctions.googleapis.com \
firestore.googleapis.com \
cloudbuild.googleapis.com \
pubsub.googleapis.com \
run.googleapis.com

    إنّ واجهات برمجة التطبيقات Admin API في Cloud Build وPub/Sub وCloud Run هي متطلبات أساسية للخدمة Cloud Functions.

المصادقة والتفويض

لست بحاجة إلى ضبط إعدادات المصادقة والتفويض لاتّباع هذا الدليل التمهيدي.

لاستدعاء واجهات برمجة التطبيقات Firestore وVertex AI، تستخدِم هذه المقالة التعليمية بيانات اعتماد التطبيق التلقائية مع حساب الخدمة التلقائي المرتبط بـ Cloud Function، والذي لست بحاجة إلى إعداده. في سياق بيئة الإنتاج، يتم عادةًإنشاء إرفاق حساب خدمة بـ Cloud Function بدلاً من ذلك.

إنشاء تطبيق Google Chat ونشره

بعد إنشاء مشروعك على Google Cloud وضبطه، تكون مستعدًا لإنشاء ونشر تطبيق Google Chat. في هذا القسم، عليك تنفيذ الخطوات التالية:

  1. أنشئ قاعدة بيانات Firestore لحفظ قصص المستخدمين واستعادتها.
  2. يمكنك اختياريًا مراجعة نموذج الرمز.
  3. أنشئ دالة Cloud لاستضافة رمز برمجي لتطبيق Chat وتشغيله استجابةً للأحداث المستلَمة من Chat كطلبات HTTP.
  4. أنشئ تطبيق Google Chat ونشره في صفحة إعدادات Google Chat API.

إنشاء قاعدة بيانات Firestore

في هذا القسم، يمكنك إنشاء قاعدة بيانات Firestore لحفظ قصص المستخدمين واستعادتها، ولكن لا يمكنك تحديد نموذج البيانات. يتم ضبط نموذج البيانات بشكل ضمني في نموذج الرمز البرمجي من خلال الملفَين model/user-story.js وmodel/user.js.

تستخدِم قاعدة بيانات تطبيق Chat لإدارة المشاريع نموذج بيانات NoSQL يستند إلى المستندات المُنظَّمة في المجموعات. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج بيانات Firestore.

يقدّم المخطّط البياني التالي نظرة عامة على نموذج بيانات إدارة المشاريع في تطبيق Google Chat:

نموذج بيانات قاعدة بيانات Firestore

المجموعة الجذر هي spaces، حيث يمثّل كل مستند مساحة أنشأ فيها تطبيق Chat قصصًا. يتم تمثيل كل قصة مستخدم بمستند في المجموعة الفرعية userStories، ويتم تمثيل كل مستخدم بمستند في المجموعة الفرعية users.

عرض تعريفات المجموعات والمستندات والحقول

spaces

المساحات التي أنشأ تطبيق Chat قصصًا فيها

الحقول
Document IDString
المعرّف الفريد لمساحة معيّنة يتم إنشاء القصص فيها. تتوافق مع اسم مورد المساحة في Chat API.
userStoriesSubcollection of Documents (userStories)
القصص التي أنشأها تطبيق Chat ومستخدموه تتوافق مع Document ID userStories في Firebase.
usersSubcollection of Documents (user)
المستخدمون الذين أنشأوا قصصًا أو تم إسناد قصص إليهم
displayNameString
الاسم المعروض للمساحة في Chat API لم يتم ضبطه للرسائل المباشرة مع المستخدمين.

userStories

القصص التي أنشأها تطبيق Chat ومستخدموه

الحقول
Document IDString
المعرّف الفريد لقصة مستخدم محدّدة أنشأها تطبيق Chat ومستخدموه
assigneeDocument (user)
اسم المورد للمستخدم الذي تم تعيينه لإكمال القصة. يتوافق مع Document ID لمستند users ومع اسم مورد المستخدم في Chat API.
descriptionString
وصف لميزة البرنامج من وجهة نظر المستخدم
priorityEnum
مستوى العجلة المطلوب لإنجاز العمل. القيم المحتمَلة هي Low أو Medium أو High.
sizeEnum
حجم العمل: القيم المحتمَلة هي Small أو Medium أو Large.
statusEnum
مرحلة العمل. القيم المحتمَلة هي OPEN أو STARTED أو COMPLETED.
titleString
عنوان القصة، وهو ملخّص موجز

users

المستخدمون الذين أنشأوا قصصًا أو تم إسناد قصص إليهم

الحقول
Document IDString
المعرّف الفريد لمستخدم معيّن. تتوافق مع assignee userStories في Firebase، ومع اسم مورد المستخدم في Chat API.
avatarUrlString
عنوان URL يستضيف صورة أفاتار المستخدم في Chat.
displayNameString
الاسم المعروض للمستخدم في Chat

في ما يلي كيفية إنشاء قاعدة بيانات Firestore:

Google Cloud Console

  1. في وحدة تحكّم Google Cloud، انتقِل إلى Firestore. انقر على القائمة > Firestore.

    الانتقال إلى Firestore

  2. انقر على إنشاء قاعدة بيانات.

  3. من اختيار وضع Firestore، انقر على الوضع المضمّن.

  4. انقر على متابعة.

  5. ضبط قاعدة البيانات:

    1. في قسم تسمية قاعدة البيانات، اترك معرّف قاعدة البيانات على (default).

    2. في نوع الموقع الجغرافي، حدِّد منطقة لقاعدة بياناتك، مثل us-central1. للحصول على أفضل أداء، اختَر الموقع الجغرافي نفسه أو موقع جغرافي قريب مماثل لموقع "وظيفة السحابة الإلكترونية" في تطبيق Chat.

  6. انقر على إنشاء قاعدة بيانات.

gcloud CLI

  • أنشئ قاعدة بيانات Firestore في الوضع الأصلي باستخدام الأمر gcloud firestore databases create:

    gcloud firestore databases create \
--location=LOCATION \
--type=firestore-native

    استبدِل LOCATION باسم منطقة Firestore، مثل us-central1.

مراجعة نموذج الرمز البرمجي

يمكنك اختياريًا قبل إنشاء دالة Cloud، تخصيص بعض الوقت لمراجعة ملف نموذج الرمز البرمجي المستضاف على GitHub والتعرّف عليه.

العرض على GitHub

في ما يلي نظرة عامة على كل ملف:

env.js
متغيّرات إعدادات البيئة لنشر تطبيق Chat في مشروع و منطقة محدّدين على Google Cloud يجب تعديل متغيّرات الإعداد في هذا الملف.
package.json وpackage-lock.json
إعدادات مشروع Node.js وتبعياته
index.js
نقطة الدخول لدالة السحابة الإلكترونية في تطبيق Chat ويقوم بقراءةحدث المحادثة منطلب HTTP، واستدعاء معالِج التطبيق، ونشر استجابة HTTP كعنصرJSON
.
controllers/app.js
منطق التطبيق الرئيسي تعالج أحداث التفاعل من خلال التعامل مع إشارات تطبيق Chat والأوامر التي تبدأ بشرطة مائلة. للردّ على النقرات على البطاقة، يتمّ الاتصال بالرقم app-action-handler.js.
controllers/app-action-handler.js
منطق التطبيق لمعالجة النقر على البطاقة أحداث التفاعل في Chat:
services/space-service.js وservices/user-service.js وservices/user-story-service.js
تحتوي هذه الملفات على أجزاء من منطق التطبيق المخصّص للعمل مع مساحات Chat والمستخدمين وقصص المستخدمين. يتمّ استدعاء الدوالّ في هذه الملفات باستخدام app.js أو app-action-handler.js. لتنفيذ عمليات قاعدة البيانات، تستدعي الدوالّ في هذه الملفات الدوالّ في firestore-service.js.
services/firestore-service.js
تعالج عمليات قاعدة البيانات. يتم استدعاء الدوالّ في هذا الملف من قِبل services/space-service.js وservices/user-service.js و services/user-story-service.js.
services/aip-service.js
تستدعي واجهة برمجة التطبيقات Vertex AI API لإجراء تحليلات ذكاء اصطناعي توليدي للنص.
model/*.js
تحتوي هذه الملفات على تعريفات الفئات والعناصر المحددة التي تستخدمها خدمات التطبيق لتخزين البيانات ونقلها بين الدوال. وهي تُعدّ ملف تعريف البيانات لقاعدة بيانات Firestore.
views/*.js
ينشئ كل ملف في هذا الدليل عنصر بطاقة يُعيده تطبيق Chat إلى Chat إما على هيئة رسالة بطاقة أو ردّ على إجراء حوار.
views/widgets/*.js
ينشئ كل ملف مثيلًا لنوع من عنصر أداة مصغّرة يستخدمه التطبيق لإنشاء البطاقات في الدليل views/.
test/**/*.test.js
يحتوي كل ملف في هذا الدليل والمجلدات الفرعية الخاصة به على اختبارات الوحدة للوظيفة أو وحدة التحكّم أو الخدمة أو طريقة العرض أو الأداة المصغّرة المقابلة. يمكنك تنفيذ جميع اختبارات الوحدة من خلال تشغيل npm run test أثناء الانتقال إلى الدليل الجذر للمشروع.

إنشاء دالة Cloud ونشرها

في هذا القسم، يمكنك إنشاء ونشر إحدى وظائف Cloud التي تتضمّن منطق تطبيق إدارة المشروعات في Chat.

يتم تشغيل Cloud Function استجابةً لطلب HTTP من Chat يحتوي على حدث تفاعل في Chat. عند التشغيل، يعالج رمز Cloud Function الحدث ويُرسِل ردًا إلى Chat يعرضه Chat على هيئة رسالة أو مربّع حوار أو نوع آخر من تفاعل المستخدم. تقرأ دالة Cloud Function أيضًا من قاعدة بيانات Firestore أو تكتب فيها، إذا كان ذلك منطبقًا.

في ما يلي كيفية إنشاء دالة Cloud:

Google Cloud Console

  1. نزِّل الرمز البرمجي من GitHub كملف مضغوط.

    تنزيل ملف zip

  2. استخرِج ملف ZIP الذي تم تنزيله.

    يحتوي المجلد الذي تم استخراجه على مستودع نماذج Google Workspace بالكامل.

  3. في المجلد الذي تم استخراجه، انتقِل إلى google-chat-samples-main/node/project-management-app/، ثم اضغط على المجلد project-management-app لإنشاء ملف zip.

    يجب أن يحتوي الدليل الجذر لملف zip على الملفات والمجلدات التالية:

    • env.js
    • README.md
    • gcloudignore.text
    • package-lock.json
    • package.json
    • index.js
    • model/
    • controllers/
    • views/
    • services/

  4. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة Cloud Functions:

    الانتقال إلى Cloud Functions

    تأكَّد من اختيار مشروع Google Cloud لتطبيق Chat.

  5. انقر على إنشاء دالة.

  6. في صفحة إنشاء دالة، اضبط إعدادات الدالة:

    1. في البيئة، اختَر وظيفة Cloud Run.
    2. في اسم الدالة، أدخِل project-management-tutorial.
    3. في المنطقة، اختَر منطقة.
    4. ضمن المصادقة، اختَر السماح بطلبات البيانات غير المعتمَدة.
    5. انقر على التالي.

  7. في وقت التشغيل، اختَر Node.js 20.

  8. في نقطة الدخول، احذف النص التلقائي وأدخِل projectManagementChatApp.

  9. في رمز المصدر، اختَر تحميل ملفات بتنسيق ZIP.

  10. في حزمة الوجهة، أنشئ أو اختَر حزمة:

    1. انقر على تصفّح.
    2. اختَر حزمة.
    3. انقر على اختيار.

    تحمِّل Google Cloud ملف ZIP إلى حزمة التخزين هذه وتستخرج منه الملفات المكوّنة. بعد ذلك، تنسخ Cloud Functions ملفات المكوّنات إلى دالة Cloud.

  11. في ملف ZIP، حمِّل ملف ZIP الذي نزّلته من GitHub واستخرجته وأعدته للضغط:

    1. انقر على تصفّح.
    2. انتقِل إلى ملف zip واختَره.
    3. انقر على فتح.

  12. انقر على نشر.

    يتم فتح صفحة تفاصيل دوال Cloud، وتظهر دالة مع اثنين من مؤشرات التقدّم: أحدهما للإنشاء والآخر للخدمة. عندما يختفي مؤشّرَا التقدّم ويتم استبدالهما بعلامة تمييز، يعني ذلك أنّه تم نشر وظيفتك وأنّها جاهزة.

  13. عدِّل الرمز البرمجي النموذجي لضبط الثوابت:

    1. في صفحة تفاصيل دالة السحابة الإلكترونية، انقر على تعديل.
    2. انقر على التالي.
    3. في الرمز المصدر، اختَر المحرِّر المضمّن.
    4. في المحرِّر المضمّن، افتح ملف env.js.
    5. استبدِل project-id بمعرّف مشروعك على Cloud.
    6. اختياري: عدِّل us-central1 باستخدام موقع جغرافي متوافق لوظيفتك على Cloud.

  14. انقر على نشر.

  15. عند اكتمال نشر الدالة، انسخ عنوان URL للعامل المشغِّل:

    1. في صفحة تفاصيل الدالة، انقر على العامل المشغِّل.
    2. يجب نسخ عنوان URL. ستحتاج إلى هذا الرمز لضبط إعدادات تطبيق Chat في القسم التالي.

gcloud CLI

  1. استنسِخ الرمز من GitHub:

    git clone https://github.com/googleworkspace/google-chat-samples.git

  2. انتقِل إلى الدليل الذي يحتوي على رمز تطبيق Chat لإدارة المشروعات:

    cd google-chat-samples/node/project-management-app

  3. عدِّل ملف env.js لضبط متغيّرات البيئة:

    1. استبدِل project-id بمعرّف مشروعك على Google Cloud.
    2. استبدِل us-central1 بموقع مشروعك على Google Cloud.

  4. يمكنك نشر "وظيفة السحابة الإلكترونية" على Google Cloud باتّباع الخطوات التالية:

    gcloud functions deploy project-management-tutorial \
--gen2 \
--region=REGION \
--runtime=nodejs20 \
--source=. \
--entry-point=projectManagementChatApp \
--trigger-http \
--allow-unauthenticated

    استبدِل REGION بأحد مواقع "وظائف السحابة الإلكترونية" التي تستضيف بنيته الأساسية، مثل us-central1.

  1. عند اكتمال نشر الدالة، انسخ السمة url من الاستجابة. هذا هو عنوان URL المشغِّل الذي تستخدمه في القسم التالي ل ضبط تطبيق Google Chat.

ضبط تطبيق Google Chat في Google Cloud Console

يوضّح هذا القسم كيفية ضبط Chat API فيconsole‏ (وحدة تحكّم) Google Cloud باستخدام معلومات عن تطبيق Chat، بما في ذلك اسم تطبيق Chat وطلبات slash المتوافقة وعنوان URL المشغِّل لواجهة برمجة التطبيقات Chat Function في تطبيق Chat الذي يُرسِل إليه أحداث تفاعل Chat.

  1. في وحدة تحكّم Google Cloud، انقر على القائمة > المزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعداد.

    الانتقال إلى إعدادات Chat API

  2. في حقل اسم التطبيق، اكتب Project Manager.

  3. في عنوان URL للصورة الرمزية، اكتب https://developers.google.com/chat/images/quickstart-app-avatar.png.

  4. في الوصف، اكتب Manages projects with user stories..

  5. انقر على مفتاح التبديل تفعيل الميزات التفاعلية لتفعيل هذا الخيار.

  6. ضمن الوظيفة، اختَر تلقّي رسائل بين شخصَين والانضمام إلى المساحات والمحادثات الجماعية.

  7. ضمن إعدادات الاتصال، اختَر عنوان URL لنقطة نهاية HTTP.

  8. في عنوان URL لنقطة نهاية HTTP، الصِق عنوان URL للعامل المشغِّل الذي نسخته من عملية نشر Functions في السحابة الإلكترونية، بالتنسيق التالي: https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. إذا كنت قد نشرت "وظيفة السحابة الإلكترونية" باستخدام واجهة سطر الأوامر gcloud CLI، تكون هذه هي السمة url.

  9. سجِّل الأوامر التي تبدأ بشرطة مائلة في تطبيق Chat. لتسجيل أمر يبدأ بشرطة مائلة:

    1. ضمن الطلبات، انقر على إضافة طلب.

    2. لكلّ أمر شرطة مُفصَّل في الجدول التالي، أدخِل الاسم ومعرّف الأمر والوصف، واختَر ما إذا كان الأمر المكوّن من شرطة يفتح مربّع حوار، ثم انقر على تم:

      الاسم رقم تعريف الطلب الوصف نوع الطلب اسم الأمر الذي يبدأ بشرطة مائلة فتح مربّع حوار
      إنشاء قصة مستخدم 1 أنشئ قصة بالعنوان المحدّد. أمر يبدأ بشرطة مائلة /createUserStory تم إلغاء اختياره
      قصص المستخدمين 2 يسرد جميع القصص التي تم تعيينها للمستخدم. أمر يبدأ بشرطة مائلة /myUserStories تم إلغاء اختياره
      قصة المستخدم 3 تعرِض هذه السمة الحالة الحالية للقصة المحدّدة. أمر يبدأ بشرطة مائلة /userStory تم إلغاء اختياره
      إدارة قصص المستخدمين 4 يفتح مربّع حوار يمكن من خلاله تعديل القصص. أمر يبدأ بشرطة مائلة /manageUserStories تم وضع علامة
      تنظيف قصص المستخدمين 5 لحذف كل القصص في المساحة أمر يبدأ بشرطة مائلة /cleanupUserStories تم إلغاء اختياره

  10. ضمن مستوى الرؤية، اختَر إتاحة تطبيق Chat هذا لأشخاص ومجموعات معيّنة في نطاق Workspace وأدخِل عنوان بريدك الإلكتروني.

  11. اختياريًا، ضمن السجلّات، اختَر تسجيل الأخطاء في السجلّ.

  12. انقر على حفظ. تظهر رسالة "تم حفظ الإعدادات"، ما يعني أنّ تطبيق Chat جاهز للاختبار.

اختبار تطبيق Chat

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

  1. افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عند إضافة نفسك كمختبِر موثوق.

    الانتقال إلى Google Chat

  2. انقر على محادثة جديدة.
  3. في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.

  4. اختَر تطبيق Chat من النتائج. ستظهر رسالة مباشرة.

  5. في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter. يستجيب تطبيق Chat المخصّص لإدارة المشروعات من خلال عرض قائمة مساعدة توضّح ما يمكنه فعله.
  6. لإنشاء قصة، اكتب /createUserStory Test story في شريط الرسائل وأرسِله. يستجيب تطبيق Chat المخصّص لإدارة المشاريع من خلال إرسال رسالة بطاقة تتضمّن تفاصيل قصة المستخدِم التي ينشئها لك باستخدام الذكاء الاصطناعي التوليدي من Vertex AI.

  7. في وحدة التحكّم، تحقّق من قاعدة بيانات Firestore لمراجعة السجلّات التي أنشأتها عن المساحة التي أضفت إليها تطبيق Chat والمستخدمين الذين تفاعلوا معه، وقصة المستخدم التي أنشأتها.

    الانتقال إلى Firestore

  8. ارجع إلى Google Chat.

    الانتقال إلى Google Chat

  9. لتعديل القصة، انقر على تعديل (اختياري). عندما تكون راضيًا عن القصة، انقر على حفظ.
  10. اختبِر كل أمر شرطة مائل متوافق مع التطبيق. للاطّلاع عليها، اكتب / أو اذكر تطبيق Chat.
  11. احذِف قصة المستخدم الاختبارية عن طريق إصدار الأمر /cleanupUserStories slash. يمكنك بدلاً من ذلك إزالة التطبيق أو إلغاء تثبيته. عند إزالة التطبيق، يحذف جميع قصص المستخدمين التي تم إنشاؤها في تلك المساحة.

تحديد المشاكل وحلّها

عندما يعرض تطبيق Google Chat أو بطاقة خطأ، تظهر في واجهة Chat رسالة تفيد بأنّ "حدث خطأ". أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا يعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن ينتج عن تطبيق Chat أو البطاقة نتيجة غير متوقّعة، على سبيل المثال، قد لا تظهر رسالة البطاقة.

على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات السجلّ لمساعدتك في حلّ الأخطاء عند تفعيل تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتحديد الأخطاء البرمجية، يُرجى الاطّلاع على مقالة تحديد أخطاء Google Chat وحلّها.

تَنظيم

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

  1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.

    انتقِل إلى "مدير الموارد"

  2. في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
  3. في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.