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

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

  • عند ذكر تطبيق إدارة المشاريع، سيقدّم التطبيق المساعدة.
    الشكل 1. يناقش سمير تطوير الميزات في "مساحة Chat" مع فريقه. عند الإشارة إلى تطبيق Chat لإدارة المشاريع، سيقدّم تطبيق Chat المساعدة.
  • استخدام الأمر /createUserStory slash لإنشاء قصة.
    الشكل 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 لكتابة عناوين وأوصاف قصة المستخدم.
  • Firestore: قاعدة بيانات مستندات لا تستخدِم خادمًا يستخدم تطبيق Google Chat المخصّص لإدارة المشاريع Firebase لتخزين البيانات حول قصص المستخدمين.
  • وظائف السحابة الإلكترونية: خدمة حوسبة خفيفة بدون خادم تتيح لك إنشاء وظائف مستقلة لغرض واحد يمكنها الاستجابة لأحداث التفاعل مع Chat بدون الحاجة إلى إدارة بيئة وقت تشغيل أو خادم يستخدم تطبيق Google Chat لإدارة المشاريع وظائف Cloud ل استضافة نقطة نهاية HTTP التي تُرسِل إليها Chat أحداث التفاعل، وكمنصّة معالجة لتشغيل المنطق الذي يعالج هذه الأحداث ويستجيب لها.

    تستخدِم Cloud Functions منتجات 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 Function.

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

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

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

  4. تعرض دوال السحابة الإلكترونية استجابة 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: لاستخدام وحدة طرفية على الإنترنت مع إعداد واجهة CLI على gcloud، يمكنك تفعيل Cloud Shell.
    تفعيل Cloud Shell
  • Shell على الجهاز: لاستخدام بيئة تطوير على الجهاز، ثبِّت ابدأ أداة gcloud CLI.
    لإنشاء مشروع على السحابة الإلكترونية، استخدِم الأمر gcloud projects create:
    gcloud projects create PROJECT_ID
    استبدِل PROJECT_ID بتحديد رقم تعريف المشروع الذي تريد إنشاؤه.

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

Google Cloud Console

  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 هو رقم تعريف المشروع لمشروع 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

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

    gcloud config set project PROJECT_ID

    استبدِل PROJECT_ID برقم تعريف المشروع الخاص بالمشروع الذي أنشأته على السحابة الإلكترونية.

  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 هي متطلبات أساسية لوظائف Cloud Functions.

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

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

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

إنشاء تطبيق 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 باسم منطقة محل أسلحة، مثل us-central1.

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

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

عرض على GitHub

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

env.js
متغيّرات إعدادات البيئة لنشر تطبيق Chat في مشروع و منطقة محدّدين على Google Cloud يجب تعديل متغيّرات الضبط في هذا الملف.
package.json وpackage-lock.json
إعدادات مشروع Node.js وتبعياته
index.js
نقطة دخول إلى Cloud Function في تطبيق 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 ونشرها

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

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

إليك كيفية إنشاء دالة السحابة:

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. في حزمة الوجهة، يمكنك create حزمة أو اختيارها:

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

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

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

    1. انقر على تصفّح.
    2. انتقل إلى الملف المضغوط وحدده.
    3. انقر على فتح.
  12. انقر على نشر.

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

  13. تحرير نموذج التعليمة البرمجية لتعيين الثوابت:

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

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

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

واجهة سطر الأوامر gcloud

  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 Functions التي تستضيف بنيتها الأساسية، مثل us-central1.

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

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

يعرض هذا القسم كيفية ضبط واجهة Chat API في Google Cloud Console باستخدام معلومات عن تطبيقك في Chat، بما في ذلك اسم تطبيق Chat والأوامر التي تبدأ بالشرطة المائلة المتوافقة وعنوان URL الذي يؤدي إلى تشغيل وظيفة Cloud في تطبيق 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 لنقطة نهاية HTTP.

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

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

    1. ضمن الأوامر التي تبدأ بشرطة مائلة، انقر على إضافة أمر يبدأ بشرطة مائلة.
    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. يستجيب تطبيق Chat المخصّص لإدارة المشروعات من خلال عرض قائمة مساعدة تتضمّن تفاصيل عن الإجراءات التي يمكنه تنفيذها.
  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 مقابل موارد المستخدَمة في هذا الدليل التعليمي، ننصحك بحذف مشروع Cloud.

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

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

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