تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
الوصول إلى خدمات Google Cloud لتنفيذ ما يلي:
- أنشئ مشروعًا على Google Cloud.
- ربط حساب فوترة على Google Cloud بمشروع Cloud للاطّلاع على ما إذا كان لديك إذن الوصول، اطّلِع على الأذونات المطلوبة لتفعيل الفوترة.
- يمكنك استخدام عمليات الاستدعاء التي لم تتم مصادقتها في Google Cloud Function، التي يمكنك التحقّق منها من خلال تحديد ما إذا كانت مؤسستك على Google Cloud تستخدم المشاركة المحصورة بالنطاق.
إذا لزم الأمر، اطلب من مشرف Google Cloud منحك إذن الوصول أو الإذن.
في حال استخدام Google Cloud CLI، يجب توفُّر بيئة تطوير Node.js تم ضبطها للعمل مع gcloud CLI. اطّلِع على إعداد بيئة تطوير Node.js.

الأهداف

أنشئ تطبيق 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 لتخزين البيانات حول قصص المستخدمين.
Cloud Functions: هي خدمة حوسبة بدون خادم خفيفة الوزن تتيح لك إنشاء functions مستقلة ومخصّصة لغرض واحد يمكنها الاستجابة لأحداث تفاعل 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 لإدارة المشاريع على النحو التالي:

يرسل أحد المستخدمين رسالة في Chat ويشغّل تطبيق Google Chat لإدارة المشاريع إما من خلال إرسال رسالة إليه مباشرةً أو ذكره في مساحة أو إدخال أمر الشرطة المائلة.
تُرسِل خدمة Chat طلب HTTP متزامنًا إلى نقطة نهاية HTTP في Cloud Function.
يعالج تطبيق Google Chat لإدارة المشاريع طلب HTTP:
1. يساعد Vertex AI في كتابة قصة مستخدم أو تعديلها.
2. تخزِّن قاعدة بيانات Firestore بيانات قصة المستخدم أو تسترجعها أو تعدّلها أو تحذفها.
تُعرِض Cloud Functions ردّ HTTP إلى Chat الذي يعرضه للمستخدم إما كرسالة أو مربّع حوار.

إعداد البيئة

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

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

Google Cloud Console

في Google Cloud Console، انتقِل إلى القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إنشاء مشروع.
الانتقال إلى "إنشاء مشروع"
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير معرّف المشروع بعد إنشائه، لذا اختَر معرّفًا يلبي احتياجاتك طوال مدّة المشروع.
في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة لمشروعك. بعد ذلك، انقر على اختيار.
تحذير: هل يتعذّر عليك العثور على مؤسستك على Google Workspace؟
هذا يعني أنّك لست مسجّلاً الدخول إلى حساب على Google Workspace. لا تتوفّر بعض الميزات описанة في مستندات مطوّري Google Workspace إلا للمشاريع المرتبطة بمؤسسة.
انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك خلال بضع دقائق.

gcloud CLI

في إحدى بيئات التطوير التالية، يمكنك الوصول إلى واجهة سطر الأوامر في Google Cloud (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

في وحدة تحكُّم Google Cloud، انتقِل إلى الفوترة. انقر على القائمة > الفوترة > مشاريعي.
الانتقال إلى "الفوترة لمشاريعي"
في القسم اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على Google Cloud.
في صف المشروع، افتح قائمة الإجراءات ()، وانقر على تغيير الفوترة، ثم اختَر حساب "الفوترة في السحابة الإلكترونية".
انقر على ضبط الحساب.

gcloud CLI

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

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

Google Cloud Console

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

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

gcloud CLI

إذا لزم الأمر، اضبط مشروع Cloud الحالي على المشروع الذي أنشأته باستخدام الأمر gcloud config set project:
```
gcloud config set project PROJECT_ID
```
استبدِل PROJECT_ID بـ رقم تعريف المشروع لمشروع Cloud الذي أنشأته.
يمكنك تفعيل 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، والذي لست بحاجة إلى إعداده. في سياق بيئة الإنتاج، يتم عادةًcreate إرفاق حساب خدمة بـ Cloud Function بدلاً من ذلك.

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

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

أنشئ قاعدة بيانات Firestore لحفظ قصص المستخدم واستردادها.
يمكنك اختياريًا مراجعة نموذج الرمز.
يمكنك إنشاء دالة سحابية لاستضافة رمز تطبيق Chat وتشغيله استجابةً للأحداث التي يتم تلقّيها من Chat كطلبات HTTP.
أنشئ تطبيق 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 ID`	`String` معرّف فريد لمساحة محددة يتم إنشاء القصص فيها. تتوافق مع اسم مورد المساحة في Chat API.
`userStories`	`Subcollection of Documents (userStories)` القصص التي ينشئها تطبيق Chat ومستخدميه تتوافق مع `Document ID` `userStories` في Firebase.
`users`	`Subcollection of Documents (user)` المستخدمون الذين أنشأوا قصصًا أو تم إسناد قصص إليهم
`displayName`	`String` الاسم المعروض للمساحة في Chat API لا يتم ضبطه للرسائل المباشرة مع المستخدمين.

`userStories`

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

الحقول
`Document ID`	`String` المعرّف الفريد لقصة مستخدم محدّدة أنشأها تطبيق Chat ومستخدموه
`assignee`	`Document (user)` اسم المورد للمستخدم الذي تم تعيينه لإكمال القصة. يتوافق مع `Document ID` لمستند `users` ومع اسم مورد المستخدم في Chat API.
`description`	`String` وصف لميزة البرنامج من وجهة نظر المستخدم
`priority`	`Enum` الحاجة المُلحّة لإكمال العمل القيم المحتمَلة هي `Low` أو `Medium` أو `High`.
`size`	`Enum` حجم العمل. القيم المحتمَلة هي `Small` أو `Medium` أو `Large`.
`status`	`Enum` مرحلة العمل. القيم المحتمَلة هي `OPEN` أو `STARTED` أو `COMPLETED`.
`title`	`String` عنوان القصة، وهو ملخّص موجز

`users`

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

الحقول
`Document ID`	`String` المعرّف الفريد لمستخدم معيّن. تتوافق مع `assignee` `userStories` في Firebase، ومع اسم مورد المستخدم في Chat API.
`avatarUrl`	`String` عنوان URL يستضيف صورة رمزية للمستخدم في Chat.
`displayName`	`String` الاسم المعروض للمستخدم على Chat.

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

Google Cloud Console

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

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

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 Function تتضمّن منطق تطبيق إدارة المشروعات في Chat.

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

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

Google Cloud Console

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

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

يحتوي المجلد الذي تم استخراجه على مستودع نماذج Google Workspace بالكامل.
في المجلد الذي تم استخراجه، انتقِل إلى 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/
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":

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

تأكَّد من اختيار مشروع Google Cloud لتطبيق Chat.
انقر على إنشاء دالة.
في صفحة إنشاء دالة، اضبط إعدادات الدالة:
1. في البيئة، اختَر وظيفة Cloud Run.
2. في اسم الدالة، أدخِل project-management-tutorial.
3. في المنطقة، اختَر منطقة.
4. ضمن المصادقة، اختَر السماح بطلبات البيانات غير المعتمَدة.
5. انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في نقطة الدخول، احذف النص التلقائي وأدخِل projectManagementChatApp.
في رمز المصدر، اختر تحميل بتنسيق ZIP.
في حزمة الوجهة، يمكنك create حزمة أو اختيارها:
1. انقر على تصفّح.
2. اختَر حزمة.
3. انقر على اختيار.
تحمِّل Google Cloud ملف ZIP إلى حزمة التخزين هذه وتستخرج منه الملفات المكوّنة. بعد ذلك، تنسخ Cloud Functions ملفات المكوّنات إلى دالة Cloud.
في ملف Zip، حمِّل ملف ZIP الذي نزّلته من GitHub واستخراجته ثمّ أعِد ضغطه:
1. انقر على تصفّح.
2. انتقل إلى الملف المضغوط وحدده.
3. انقر على فتح.
انقر على نشر.

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

gcloud CLI

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

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

انتقِل إلى الدليل الذي يحتوي على رمز تطبيق Chat لإدارة المشروعات:
```
cd google-chat-samples/node/project-management-app
```
عدِّل ملف env.js لضبط متغيّرات البيئة:
1. استبدِل project-id بمعرّف مشروعك على Google Cloud.
2. استبدِل us-central1 بموقع مشروعك على Google Cloud.
يمكنك نشر "وظيفة السحابة الإلكترونية" على 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.

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

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

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

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

الانتقال إلى إعدادات Chat API
في اسم التطبيق، اكتب Project Manager.
في عنوان URL للصورة الرمزية، اكتب https://developers.google.com/chat/images/quickstart-app-avatar.png.
في الوصف، اكتب Manages projects with user stories.
انقر على مفتاح التبديل تفعيل الميزات التفاعلية لتفعيله.
ضمن الوظائف، اختَر تلقّي الرسائل بين شخصين، الانضمام إلى المساحات والمحادثات الجماعية.
ضمن إعدادات الاتصال، اختَر عنوان URL لنقطة نهاية HTTP.
في عنوان URL لنقطة نهاية HTTP، الصِق عنوان URL للعامل المشغِّل الذي نسخته من عملية نشر Functions في السحابة الإلكترونية، بالتنسيق التالي: https://REGION-PROJECT_ID.cloudfunctions.net/project-management-tutorial. إذا كنت قد نشرت "وظيفة السحابة الإلكترونية" باستخدام واجهة سطر الأوامر gcloud CLI، تكون هذه هي السمة url.

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

ضمن الأوامر التي تبدأ بشرطة مائلة، انقر على إضافة أمر يبدأ بشرطة مائلة.

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

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

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

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

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

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

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

ملاحظة: إذا لم يظهر لك تطبيق Chat في قائمة النتائج، تأكَّد من تضمين حسابك على Google Workspace في إعدادات مستوى العرض في صفحة إعدادات Chat API في Google Cloud Console.
في الرسالة المباشرة الجديدة مع التطبيق، اكتب Hello واضغط على enter. يستجيب تطبيق Chat المخصّص لإدارة المشروعات من خلال عرض قائمة مساعدة تتضمّن تفاصيل عن الإجراءات التي يمكنه تنفيذها.
لإنشاء قصة، اكتب /createUserStory Test story في شريط الرسائل وأرسِله. يستجيب تطبيق Chat المخصّص لإدارة المشاريع من خلال إرسال رسالة بطاقة تتضمّن تفاصيل قصة المستخدِم التي ينشئها لك باستخدام الذكاء الاصطناعي التوليدي من Vertex AI.
في وحدة التحكّم، اطّلِع على قاعدة بيانات Firestore لمراجعة السجلّات التي تم إنشاؤها بشأن المساحة التي أضفت تطبيق Chat إليها والمستخدمين الذين تفاعلوا معها وقصة المستخدم التي أنشأتها.

الانتقال إلى Firestore
ارجع إلى Google Chat.

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

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

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

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

تَنظيم

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

تنبيه: ينتج عن حذف المشروع التأثيرات التالية:

يتم حذف كل المحتوى في المشروع. إذا استخدمت مشروعًا حاليًا لهذا البرنامج التعليمي، فعند حذفه، يتم أيضًا حذف أي عمل آخر قمت به في هذا المشروع.
يتم فقدان أرقام تعريف المشاريع المخصّصة. عند إنشاء هذا المشروع، ربما أنشأت معرّف مشروع مخصّصًا تريد استخدامه في المستقبل. للحفاظ على عناوين URL التي تستخدِم رقم تعريف المشروع، مثل عنوان URL على appspot.com، يمكنك حذف الموارد المحدّدة داخل المشروع بدلاً من حذف المشروع بأكمله.

إذا كنت تخطّط لاستكشاف عدة برامج تعليمية وبرامج سريعة البدء، يمكن أن يساعدك إعادة استخدام المشاريع في تجنُّب تجاوز حدود الحصة المخصّصة للمشاريع.

في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
الانتقال إلى Resource Manager
في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.

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

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

الأهداف

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

البنية

إعداد البيئة

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

Google Cloud Console

gcloud CLI

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

Google Cloud Console

gcloud CLI

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

Google Cloud Console

gcloud CLI

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

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

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

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

spaces

userStories

users

Google Cloud Console

gcloud CLI

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

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

Google Cloud Console

gcloud CLI

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

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

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

تَنظيم

مواضيع ذات صلة

`spaces`

`userStories`

`users`