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

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

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

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

البنية

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

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

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

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

  2. يرسل تطبيق Chat طلب HTTP متزامنًا إلى خادم نقطة نهاية HTTP.

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

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

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

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

تحضير البيئة

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

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

وحدة التحكّم في Google Cloud

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

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

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

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

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

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

وحدة التحكّم في Google Cloud

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

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

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

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

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

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

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

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

وحدة التحكّم في Google Cloud

  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. تأكَّد من تفعيل واجهات برمجة التطبيقات بالشكل الصحيح مشروع على Google Cloud، ثم انقر على التالي.

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

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

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

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

لا حاجة إلى ضبط المصادقة والترخيص لتطبيق ذلك البرنامج التعليمي.

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

إنشاء تطبيق 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 نموذج بيانات استنادًا إلى مستندات منظمًا في المجموعات. لمزيد من المعلومات، يُرجى مراجعة نموذج بيانات متجر النار:

الرسم التخطيطي التالي هو نظرة عامة على إدارة المشروعات نموذج بيانات تطبيق 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. (يُرجى النقر.) قائمة الطعام > متجر إطفاء.

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

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

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

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

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

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

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

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

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

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

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

    استبدل LOCATION باسم مخزن إطفاء المنطقة، مثل باسم us-central1.

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

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

عرض على GitHub

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

env.js
متغيرات ضبط البيئة لنشر تطبيق Chat على مشروع محدّد على Google Cloud . يجب تعديل متغيّرات الضبط في هذا الملف.
package.json وpackage-lock.json
إعدادات وتبعيات مشروع Node.js
index.js
نقطة دخول إلى Cloud Function في تطبيق Chat. أُنشأها جون هنتر، الذي كان متخصصًا يقرأ حدث محادثة من طلب HTTP، ويستدعي معالِج التطبيق، وينشر استجابة HTTP كائن JSON.
controllers/app.js
المنطق الرئيسي للتطبيق: يعالج أحداث التفاعل من خلال التعامل مع إشارات التطبيقات في Chat والأوامر التي تبدأ بشرطة مائلة للاستجابة إلى النقرات على البطاقة، يتم طلب app-action-handler.js.
controllers/app-action-handler.js
منطق التطبيق للتعامل مع النقر على البطاقة أحداث التفاعل عبر المحادثة.
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 ونشرها

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

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

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

وحدة التحكّم في Google Cloud

  1. قم بتنزيل الرمز من GitHub كملف ZIP.

    تنزيل ملف ZIP

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

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

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

    يجب أن يحتوي الدليل الجذري للملف المضغوط على ما يلي: الملفات والمجلدات:

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

  4. في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":

    الانتقال إلى وظائف السحابة الإلكترونية

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    1. في صفحة تفاصيل دالة Cloud، انقر على تعديل.
    2. انقر على التالي.
    3. في رمز المصدر، اختَر المحرِّر المضمّن.
    4. في المحرِّر المضمّن، افتح ملف env.js.
    5. استبدِل project-id برقم تعريف مشروعك على Google 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 Function حيث تتم استضافة بنيته الأساسية، مثل us-central1.

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

إعداد تطبيق Google Chat في وحدة تحكّم Google Cloud

يوضّح هذا القسم كيفية ضبط Chat API في وحدة تحكُّم Google Cloud التي تتضمن معلومات عن تطبيق Chat بما في ذلك اسم تطبيق Chat، والشرطة المائلة المتوافقة والأوامر وعنوان URL لمشغِّل السحابة الإلكترونية في تطبيق 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 للتطبيق.

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

  9. تسجيل أوامر الشرطة المائلة. لتسجيل أمر شرطة مائلة:

    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 أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.

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

تَنظيم

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

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

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

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