يوضّح هذا البرنامج التعليمي كيفية إنشاء تطبيق 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 Functions، التي يمكنك التحقّق منها من خلال تحديد ما إذا كانت مؤسستك في 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 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 لإدارة المشاريع على النحو التالي:
يرسل أحد المستخدمين رسالة في Chat ويشغّل تطبيق Google Chat لإدارة المشاريع إما من خلال إرسال رسالة إليه مباشرةً أو ذكره في مساحة أو إدخال أمر الشرطة المائلة.
تُرسِل Chat طلب HTTP متزامنًا إلى نقطة نهاية HTTP في Cloud Function.
يعالج تطبيق Google Chat لإدارة المشاريع طلب HTTP:
تساعد Vertex AI في كتابة قصة مستخدم أو تعديلها.
تخزِّن قاعدة بيانات Firestore بيانات قصة المستخدم أو تسترجعها أو تعدّلها أو تحذفها.
تُعرِض Cloud Functions ردّ HTTP إلى Chat الذي يعرضه للمستخدم إما كرسالة أو مربّع حوار.
إعداد البيئة
يوضّح هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده لتطبيق Chat.
إنشاء مشروع على Google Cloud
Google Cloud Console
- في Google Cloud Console، انتقِل إلى القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إنشاء مشروع.
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير معرّف المشروع بعد إنشاء المشروع، لذا اختَر معرّفًا يلبي احتياجاتك طوال مدّة المشروع.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتملة لمشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك خلال بضع دقائق.
gcloud CLI
في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud
CLI (gcloud
):
-
Cloud Shell: لاستخدام وحدة طرفية على الإنترنت تم إعداد واجهة سطر أوامر gcloud CLI عليها، فعِّل Cloud Shell.
تفعيل Cloud Shell -
Shell المحلي: لاستخدام بيئة تطوير محلية،
ثبِّت
افتح
أداة gcloud CLI.
لإنشاء مشروع على Cloud، استخدِم الأمرgcloud projects create
: استبدِل PROJECT_ID بتحديد رقم تعريف المشروع الذي تريد إنشاؤه.gcloud projects create PROJECT_ID
تفعيل الفوترة لمشروع Cloud
Google Cloud Console
- في Google Cloud Console، انتقِل إلى الفوترة. انقر على القائمة > الفوترة > مشاريعي.
- في اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على 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، والذي لست بحاجة إلى إعداده. في سياق بيئة الإنتاج، يتم عادةًإنشاء إرفاق حساب خدمة بـ Cloud Function بدلاً من ذلك.
إنشاء تطبيق Google Chat ونشره
بعد إنشاء مشروعك على Google Cloud وضبطه، تكون مستعدًا لإنشاء ونشر تطبيق Google Chat. في هذا القسم، عليك تنفيذ الخطوات التالية:
- أنشئ قاعدة بيانات Firestore لحفظ قصص المستخدمين واستعادتها.
- يمكنك اختياريًا مراجعة نموذج الرمز.
- أنشئ دالة Cloud لاستضافة رمز برمجي لتطبيق Chat وتشغيله استجابةً للأحداث المستلَمة من Chat كطلبات HTTP.
- أنشئ تطبيق Google Chat ونشره في صفحة إعدادات Google Chat API.
إنشاء قاعدة بيانات Firestore
في هذا القسم، يمكنك إنشاء قاعدة بيانات Firestore لحفظ
قصص المستخدمين واستعادتها، ولكن لا يمكنك تحديد نموذج البيانات. يتم ضبط نموذج البيانات
بشكل ضمني في نموذج الرمز البرمجي من خلال الملفَين model/user-story.js
وmodel/user.js
.
تستخدِم قاعدة بيانات تطبيق Chat لإدارة المشاريع نموذج بيانات NoSQL يستند إلى نموذج بيانات Firestore.
المستندات المُنظَّمة في المجموعات. لمزيد من المعلومات، يُرجى الاطّلاع علىيقدّم المخطّط البياني التالي نظرة عامة على نموذج بيانات إدارة المشاريع في تطبيق Google Chat:
المجموعة الجذر هي spaces
، حيث يمثّل كل مستند مساحة أنشأ فيها
تطبيق Chat قصصًا. يتم تمثيل كل قصة مستخدم
بمستند في المجموعة الفرعية userStories
، ويتم تمثيل كل مستخدم
بمستند في المجموعة الفرعية users
.
عرض تعريفات المجموعات والمستندات والحقول
spaces
المساحات التي أنشأ تطبيق Chat قصصًا فيها
الحقول | |
---|---|
Document ID | String المعرّف الفريد لمساحة معيّنة يتم إنشاء القصص فيها. تتوافق مع اسم مورد المساحة في Chat API. |
userStories | Subcollection of Documents ( القصص التي أنشأها تطبيق 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، انقر على الوضع المضمّن.
انقر على متابعة.
ضبط قاعدة البيانات:
في قسم تسمية قاعدة البيانات، اترك معرّف قاعدة البيانات على
(default)
.في نوع الموقع الجغرافي، حدِّد منطقة لقاعدة بياناتك، مثل
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 والتعرّف عليه.
في ما يلي نظرة عامة على كل ملف:
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
نزِّل الرمز البرمجي من GitHub كملف مضغوط.
استخرِج ملف 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، انتقِل إلى صفحة Cloud Functions:
تأكَّد من اختيار مشروع Google Cloud لتطبيق Chat.
انقر على
إنشاء دالة.في صفحة إنشاء دالة، اضبط إعدادات الدالة:
- في البيئة، اختَر وظيفة Cloud Run.
- في اسم الدالة، أدخِل
project-management-tutorial
. - في المنطقة، اختَر منطقة.
- ضمن المصادقة، اختَر السماح بطلبات التنفيذ غير المعتمَدة.
- انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في نقطة الدخول، احذف النص التلقائي وأدخِل
projectManagementChatApp
.في رمز المصدر، اختَر تحميل ملفات بتنسيق ZIP.
في حزمة الوجهة، أنشئ أو اختَر حزمة:
- انقر على تصفّح.
- اختَر حزمة.
- انقر على اختيار.
تحمِّل Google Cloud ملف ZIP إلى حزمة التخزين هذه وتستخرج منه الملفات المكوّنة. بعد ذلك، تنسخ Cloud Functions ملفات المكوّنات إلى دالة Cloud.
في ملف ZIP، حمِّل ملف ZIP الذي نزّلته من GitHub واستخرجته وأعدته للضغط:
- انقر على تصفّح.
- انتقِل إلى ملف zip واختَره.
- انقر على فتح.
انقر على نشر.
يتم فتح صفحة تفاصيل دوال Cloud، وتظهر دالة مع اثنين من مؤشرات التقدّم: أحدهما للإنشاء والآخر للخدمة. عندما يختفي مؤشّرَا التقدّم ويتم استبدالهما بعلامة تمييز، يعني ذلك أنّه تم نشر وظيفتك وأنّها جاهزة.
عدِّل الرمز البرمجي النموذجي لضبط الثوابت:
- في صفحة تفاصيل دالة السحابة الإلكترونية، انقر على تعديل.
- انقر على التالي.
- في الرمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
. - استبدِل project-id بمعرّف مشروعك على Cloud.
- اختياري: عدِّل us-central1 باستخدام موقع جغرافي متوافق لوظيفتك على Cloud.
انقر على نشر.
عند اكتمال نشر الدالة، انسخ عنوان URL للعامل المشغِّل:
- في صفحة تفاصيل الدالة، انقر على العامل المشغِّل.
- يجب نسخ عنوان 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
لضبط متغيّرات البيئة:- استبدِل project-id بمعرّف مشروعك على Google Cloud.
- استبدِل 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 بأحد مواقع "وظائف السحابة الإلكترونية" التي يتم استضافة بنيتها الأساسية فيها، مثل
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 > إدارة > الإعداد.
في حقل اسم التطبيق، اكتب
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 الذي قدّمته عند إضافة نفسك كمختبِر موثوق.
- انقر على محادثة جديدة.
- في حقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.
اختَر تطبيق Chat من النتائج. ستظهر رسالة مباشرة.
- في الرسالة المباشرة الجديدة مع التطبيق، اكتب
Hello
واضغط علىenter
. يستجيب تطبيق Chat المخصّص لإدارة المشروعات من خلال عرض قائمة مساعدة تفصِّل ما يمكنه فعله. - لإنشاء قصة، اكتب
/createUserStory Test story
في شريط الرسائل وأرسِله. يستجيب تطبيق Chat المخصّص لإدارة المشاريع من خلال إرسال رسالة بطاقة تتضمّن تفاصيل قصة المستخدِم التي ينشئها لك باستخدام الذكاء الاصطناعي التوليدي من Vertex AI. في وحدة التحكّم، تحقّق من قاعدة بيانات Firestore لمراجعة السجلّات التي أنشأتها عن المساحة التي أضفت إليها تطبيق Chat والمستخدمين الذين تفاعلوا معه، وقصة المستخدم التي أنشأتها.
ارجع إلى Google Chat.
- لتعديل القصة، انقر على تعديل (اختياري). عندما تكون راضيًا عن القصة، انقر على حفظ.
- اختبِر كل أمر شرطة مائل متوافق مع التطبيق. للاطّلاع عليها، اكتب
/
أو اذكر تطبيق Chat. - احذِف قصة المستخدم الاختبارية من خلال إصدار الأمر
/cleanupUserStories
slash. يمكنك بدلاً من ذلك إزالة التطبيق أو إلغاء تثبيته. عند إزالة التطبيق، يحذف جميع قصص المستخدمين التي تم إنشاؤها في تلك المساحة.
تحديد المشاكل وحلّها
عندما يعرض تطبيق Google Chat أو بطاقة خطأ، تظهر في واجهة Chat رسالة تفيد بأنّ "حدث خطأ". أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا يعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن ينتج عن تطبيق Chat أو البطاقة نتيجة غير متوقّعة. على سبيل المثال، قد لا تظهر رسالة البطاقة .
على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات السجلّ لمساعدتك في حلّ الأخطاء عند تفعيل تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتصحيح الأخطاء، يُرجى الاطّلاع على تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنُّب تحمُّل رسوم على حسابك على Google Cloud مقابل موارد المستخدَمة في هذا الدليل التعليمي، ننصحك بحذف مشروع Cloud.
- في وحدة تحكّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.
مواضيع ذات صلة
- الإجابة عن الأسئلة استنادًا إلى محادثات Chat باستخدام تطبيق Gemini Chat المستنِد إلى الذكاء الاصطناعي
- الاستجابة للحوادث باستخدام Google Chat وVertex AI و"برمجة تطبيقات Google"