يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق Google Chat يمكن للفريق استخدامه لإدارة المشاريع في الوقت الفعلي. يستخدم تطبيق Chat Vertex AI لمساعدة الفرق في كتابة قصص المستخدمين (التي تمثّل ميزات نظام البرامج من وجهة نظر المستخدم لكي يطوّرها الفريق) والحفاظ على القصص في قاعدة بيانات Firestore.
-
الشكل 2. باستخدام الأمر /createUserStory
الذي يبدأ بشرطة مائلة، أنشأت شيرين قصة. -
الشكل 3. يستخدم تطبيق Chat لإدارة المشاريع Vertex AI لكتابة وصف القصة، ثم يشارك القصة في المساحة. -
الشكل 4 ينقر "شارلي" على تعديل لإكمال تفاصيل القصة. وصف الذكاء الاصطناعي دقيق، ولكن يريد "شارلي" الحصول على مزيد من التفاصيل، لذلك ينقر على توسيع لإضافة متطلبات إلى وصف القصة باستخدام Vertex AI. يحدّد "شارلي" القصة لنفسه، ويضبط الحالة على "مُبدوءة"، ويختار الأولوية والحجم المناسبَين، ثمّ ينقر على حفظ. -
الشكل 5. ويستطيع "تشارلي" في أي وقت الاطّلاع على جميع قصص المستخدمين الخاصة بالفريق وإدارتها باستخدام أمر الشرطة المائلة /manageUserStories
.
المتطلبات الأساسية
- حساب على Google Workspace من فئة Business أو Enterprise يتيح الوصول إلى Google Chat
الوصول إلى خدمات Google Cloud لتنفيذ الإجراءات التالية:
- أنشِئ مشروعًا على Google Cloud.
- ربط حساب فوترة على Google 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 لتخزين البيانات حول قصص المستخدمين.
وظائف السحابة الإلكترونية: خدمة حوسبة خفيفة بدون خادم تتيح لك إنشاء وظائف مستقلة لغرض واحد يمكنها الاستجابة لأحداث التفاعل مع 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 لإدارة المشاريع على النحو التالي:
يرسل المستخدم رسالة في Chat ويستدعي تطبيق Google Chat لإدارة المشاريع من خلال مراسلته مباشرةً أو الإشارة إليه في مساحة أو إدخال أمر شرطة مائلة.
تُرسِل خدمة Chat طلب HTTP متزامنًا إلى نقطة نهاية HTTP في Cloud Function.
يعالج تطبيق Google Chat لإدارة المشاريع طلب HTTP:
يساعد Vertex AI في كتابة قصة مستخدم أو تعديلها.
تخزِّن قاعدة بيانات Firestore بيانات قصة المستخدم أو تستردها أو تحدِّثها أو تحذفها.
تعرض دوال السحابة الإلكترونية استجابة HTTP إلى Chat، ما يعرضها للمستخدم إما كرسالة أو مربّع حوار.
تحضير البيئة
يوضّح هذا القسم كيفية إنشاء مشروع على Google Cloud وضبط إعداداته لتطبيق Chat.
إنشاء مشروع على Google Cloud
Google Cloud Console
- في Google Cloud Console، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إنشاء مشروع.
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع بعد إنشائه، لذا اختَر رقم تعريف يلبي احتياجاتك طوال مدة المشروع.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة لمشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك خلال بضع دقائق.
gcloud CLI
في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud
CLI (gcloud
):
-
Cloud Shell: لاستخدام وحدة طرفية على الإنترنت مع إعداد واجهة CLI على gcloud، يمكنك تفعيل Cloud Shell.
تفعيل Cloud Shell -
Shell على الجهاز: لاستخدام بيئة تطوير على الجهاز،
ثبِّت
ابدأ
أداة gcloud CLI.
لإنشاء مشروع على السحابة الإلكترونية، استخدِم الأمرgcloud projects create
: استبدِل PROJECT_ID بتحديد رقم تعريف المشروع الذي تريد إنشاؤه.gcloud projects create PROJECT_ID
تفعيل الفوترة لمشروع Cloud
Google Cloud Console
- في Google Cloud Console، انتقِل إلى الفوترة. انقر على القائمة > الفوترة > مشاريعي.
- في القسم اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على Google Cloud.
- في صف المشروع، افتح قائمة الإجراءات ( )، وانقر على تغيير الفوترة، واختر حساب فوترة 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
إذا لزم الأمر، اضبط مشروع Cloud الحالي على المشروع الذي أنشأته باستخدام الأمر
gcloud config set project
:gcloud config set project PROJECT_ID
استبدِل PROJECT_ID برقم تعريف المشروع الخاص بالمشروع الذي أنشأته على السحابة الإلكترونية.
يمكنك تفعيل 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 ونشره. في هذا القسم، يمكنك إجراء ما يلي:
- أنشئ قاعدة بيانات 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 باسم منطقة محل أسلحة، مثل
us-central1
.
مراجعة نموذج الرمز البرمجي
يمكنك اختياريًا قبل إنشاء دالة Cloud، تخصيص بعض الوقت لمراجعة ملف نموذج الرمز البرمجي المستضاف على 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
نزِّل الرمز البرمجي من 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.
في حزمة الوجهة، يمكنك create حزمة أو اختيارها:
- انقر على تصفّح.
- اختَر حزمة.
- انقر على اختيار.
تحمِّل Google Cloud ملف ZIP إلى حزمة التخزين هذه وتستخرج منه الملفات المكوّنة. بعد ذلك، تنسخ Cloud Functions ملفات المكوّنات إلى دالة Cloud.
في ملف Zip، حمِّل ملف ZIP الذي نزّلته من GitHub واستخراجته ثمّ أعِد ضغطه:
- انقر على تصفّح.
- انتقل إلى الملف المضغوط وحدده.
- انقر على فتح.
انقر على نشر.
ستفتح صفحة تفاصيل دوال Cloud، وستظهر دالة مع اثنين من مؤشرات التقدّم: أحدهما للإصدار والآخر للخدمة. عندما يختفي كلا مؤشري التقدم ويتم استبدالهما بعلامة اختيار، تكون الدالة منتشرة وجاهزة.
تحرير نموذج التعليمة البرمجية لتعيين الثوابت:
- في صفحة تفاصيل دالة Cloud، انقر على تعديل.
- انقر على التالي.
- في رمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
. - استبدِل project-id بمعرّف مشروعك على Cloud.
- اختياري: عدِّل us-central1 باستخدام موقع جغرافي متوافق لـ "وظيفة السحابة الإلكترونية".
انقر على نشر.
عند اكتمال نشر الدالة، انسخ عنوان URL للعامل المشغِّل:
- في صفحة تفاصيل الدالة، انقر على العامل المشغِّل.
- يجب نسخ عنوان URL. ستحتاج إلى هذا الرمز لضبط إعدادات تطبيق Chat في القسم التالي.
واجهة سطر الأوامر gcloud
استنسِخ الرمز من 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 بأحد مواقع Cloud Functions التي تستضيف بنيتها الأساسية، مثل
us-central1
.
- عند انتهاء نشر الدالة، انسخ السمة
url
من الاستجابة. هذا هو عنوان URL المشغِّل الذي تستخدمه في القسم التالي ل ضبط تطبيق Google Chat.
ضبط تطبيق Google Chat في Google Cloud Console
يعرض هذا القسم كيفية ضبط واجهة Chat API في Google Cloud Console باستخدام معلومات عن تطبيقك في Chat، بما في ذلك اسم تطبيق Chat والأوامر التي تبدأ بالشرطة المائلة المتوافقة وعنوان URL الذي يؤدي إلى تشغيل وظيفة Cloud في تطبيق Chat التي يرسل إليها أحداث التفاعل في Chat.
في Google Cloud Console، انقر على القائمة > مزيد من المنتجات > 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 المشغِّل الذي نسخته من نشر "دوال السحابة" بالتنسيق
https://
REGION-
PROJECT_ID.cloudfunctions.net/project-management-tutorial
. في حال تفعيل دالة Cloud باستخدام واجهة سطر الأوامر gcloud، هذه هي السمة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
الذي يتضمّن الشرطة المائلة. يمكنك بدلاً من ذلك إزالة التطبيق أو إلغاء تثبيته. عند إزالة التطبيق، يحذف جميع قصص المستخدمين التي تم إنشاؤها في تلك المساحة.
تحديد المشاكل وحلّها
عندما يعرض تطبيق أو بطاقة Google Chat رسالة خطأ، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن يعرض تطبيق Chat أو بطاقة بياناته نتيجة غير متوقعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.
على الرغم من أنّ رسالة الخطأ قد لا تظهر في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتصحيح الأخطاء، يُرجى الاطّلاع على مقالة تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنُّب تحمُّل رسوم على حسابك على Google Cloud مقابل موارد المستخدَمة في هذا الدليل التعليمي، ننصحك بحذف مشروع Cloud.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.
مواضيع ذات صلة
- الإجابة عن الأسئلة استنادًا إلى محادثات Chat باستخدام تطبيق Gemini Chat المستنِد إلى الذكاء الاصطناعي
- الاستجابة للحوادث باستخدام Google Chat وVertex AI و"برمجة تطبيقات Google"