أدِر المشاريع باستخدام 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 لتلقّي أحداث التفاعل التي يرسلها Chat والاستجابة لها، ولإعداد السمات التي تحدّد كيفية ظهورها في Chat، مثل الاسم والصورة الرمزية.
  • Vertex AI API: منصة للذكاء الاصطناعي التوليدي. يستخدم تطبيق إدارة المشروعات تطبيق Google Chat واجهة برمجة التطبيقات Vertex AI API لكتابة عناوين قصص المستخدمين وأوصافها.
  • Firestore: قاعدة بيانات مستندات بدون خادم لإدارة المشروعات يستخدم تطبيق Google Chat منصة Firebase لتخزين البيانات المتعلقة بقصص المستخدمين.

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

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

    • Cloud Build: هي نظام أساسي مُدار بالكامل للدمج والعرض والنشر ويعمل على تشغيل إصدارات مبرمَجة.
    • النشر/الاشتراك: هي خدمة مراسلة غير متزامنة وقابلة للتطوير تعمل على الفصل بين الخدمات التي تنتج الرسائل من الخدمات التي تعالج هذه الرسائل.
    • 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.

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

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

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

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

تهيئة البيئة

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

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

وحدة تحكُّم Google Cloud

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

    الانتقال إلى صفحة إنشاء مشروع

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

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

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

gcloud CLI

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

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

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

وحدة تحكُّم Google Cloud

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

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

  2. في القسم اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على Google Cloud.
  3. في صف المشروع، افتح قائمة الإجراءات ()، وانقر على تغيير الفوترة، واختَر حساب فوترة Cloud.
  4. انقر على ضبط الحساب.

gcloud CLI

  1. لإدراج حسابات الفوترة المتاحة، شغِّل: 
    gcloud billing accounts list
  2. ربط حساب فوترة بمشروع على Google Cloud: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    استبدل ما يلي:

    • PROJECT_ID هو رقم تعريف المشروع للمشروع على Google Cloud الذي تريد تفعيل الفوترة له.
    • BILLING_ACCOUNT_ID هو رقم تعريف حساب الفوترة المطلوب ربطه بمشروع Google Cloud.

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

وحدة تحكُّم Google Cloud

  1. في Google Cloud Console، فعِّل واجهة برمجة تطبيقات Google Chat وVertex AI API وCloud Functions API وFirestore API وCloud Build API وPub/Sub وواجهة برمجة تطبيقات المشرف في Cloud Run.

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

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

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

gcloud CLI

  1. إذا لزم الأمر، اضبط المشروع الحالي على السحابة الإلكترونية على المشروع الذي أنشأته باستخدام الأمر 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

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

المصادقة والترخيص

ليس من الضروري ضبط المصادقة والترخيص لاتّباع هذا البرنامج التعليمي

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

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

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

  1. قم بإنشاء قاعدة بيانات Firestore التي تحتفظ فيها بقصص المستخدمين واستردادها.
  2. يمكنك بشكل اختياري مراجعة الرمز.
  3. يمكنك إنشاء دالة سحابية لاستضافة وتشغيل رمز تطبيق 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

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

    الانتقال إلى 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 باسم منطقة متجر أطعمة، مثل us-central1.

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

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

العرض على GitHub

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

env.js
متغيّرات ضبط البيئة لنشر تطبيق Chat في مشروع ومنطقة محدّدتَين على Google Cloud يجب تعديل متغيّرات الضبط في هذا الملف.
package.json وpackage-lock.json
إعدادات مشروع Node.js وتبعياته.
index.js
نقطة إدخال لوظيفة السحابة الإلكترونية في تطبيق Chat: ويقرأ حدث 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 للتنبؤ بنصوص الذكاء الاصطناعي التوليدي.
model/*.js
تحتوي هذه الملفات على تعريف للفئات والتعدادات التي تستخدمها خدمات التطبيقات لتخزين البيانات وتمريرها بين الدوال. أعدّوا نموذج البيانات لقاعدة بيانات Firestore.
views/*.js
ينشئ كل ملف في هذا الدليل مثيلاً لكائن بطاقة يرسله تطبيق Chat بعد ذلك إلى Chat كإما رسالة بطاقة أو استجابة لإجراء حوار.
views/widgets/*.js
ينشئ كل ملف مثيلاً لنوع من كائنات التطبيقات المصغّرة التي يستخدمها التطبيق لإنشاء البطاقات في دليل views/.
test/**/*.test.js
يحتوي كل ملف في هذا الدليل وأدلته الفرعية على اختبارات الوحدة للدالة أو وحدة التحكّم أو الخدمة أو العرض أو التطبيق المصغّر المقابل. يمكنك تنفيذ جميع اختبارات الوحدة من خلال تشغيل npm run test أثناء التواجد في الدليل الجذري للمشروع.

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

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

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

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

وحدة تحكُّم Google Cloud

  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 Console، انتقِل إلى صفحة Cloud Functions:

    الانتقال إلى دوال Cloud

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

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

  6. في صفحة إنشاء دالة، عليك إعداد الدالة:

    1. في البيئة، اختَر الجيل الثاني.
    2. في اسم الدالة، أدخِل project-management-tutorial.
    3. في المنطقة، اختَر منطقة.
    4. ضمن المصادقة، اختَر السماح باستدعاءات لم تتم مصادقتها.
    5. انقر على التالي.

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

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

  9. في رمز المصدر، اختر تحميل الرمز البريدي.

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

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

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

  11. في ملف Zip، قم بتحميل ملف zip الذي قمت بتنزيله من GitHub واستخراجه وإعادة ضغطه:

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

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

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

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

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

  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 بموقع جغرافي لدالة Cloud حيث تتم استضافة بنيته الأساسية، مثل us-central1.

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

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

يعرض هذا القسم كيفية إعداد Chat API في وحدة تحكُّم Google Cloud باستخدام معلومات عن تطبيق Chat، بما في ذلك اسم تطبيق Chat، والأوامر المتوافقة التي تبدأ بشرطة مائلة، وعنوان URL لمشغِّل وظيفة السحابة الإلكترونية في تطبيق Chat التي يتم إرسال أحداث التفاعل إلى Chat إليها.

  1. في Google Cloud Console، انقر على القائمة > مزيد من المنتجات > 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 للتطبيق.

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

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

    1. ضمن أوامر Slash، انقر على إضافة أمر شرطة مائلة.

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

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

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

  11. اختياريًا، ضمن السجلات، اختر تسجيل الأخطاء إلى التسجيل.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تَنظيم

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

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

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

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