يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق Google Chat يمكن للفريق تنفيذه استخدامها لإدارة المشروعات في الوقت الفعلي. يستخدم تطبيق Chat Vertex AI لمساعدة الفرق في كتابة قصص المستخدمين (التي تمثل ميزات البرمجيات من وجهة نظر المستخدم لتطويرها) القصص في قاعدة بيانات Firestore.
-
الشكل 1. يناقش سمير تطوير الميزات في "مساحة Chat" مع فريقه. يؤدي ذِكر تطبيق Chat لإدارة المشاريع إلى مطالبة تطبيق Chat بتقديم المساعدة. -
الشكل 2. ينشئ "تشارلي" قصة باستخدام أمر الشرطة المائلة /createUserStory
. -
الشكل 3. يستخدم تطبيق Chat المخصّص لإدارة المشاريع Vertex AI لكتابة وصف القصة، ثم يشارك القصة في المساحة. -
الشكل 4 ينقر سمير على تعديل لإنهاء تفاصيل القصة. وصف الذكاء الاصطناعي دقيق، لكن تشارلي يريد المزيد من التفاصيل، لذلك ينقر على توسيع لكي يضيف Vertex AI متطلبات إلى وصف القصة. يخصّص تشارلي القصة لنفسه، ويضبط الحالة على "بدأ"، ويختار الأولوية والحجم المناسبَين، ثم ينقر على حفظ. -
الشكل 5 ويستطيع "تشارلي" في أي وقت الاطّلاع على جميع قصص المستخدمين الخاصة بالفريق وإدارتها باستخدام أمر الشرطة المائلة /manageUserStories
.
المتطلبات الأساسية
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى 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: واجهة برمجة تطبيقات لتطوير تطبيقات 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 لإدارة المشاريع على النحو التالي:
يرسل المستخدم رسالة في Chat ويستدعي تطبيق Google Chat لإدارة المشروعات من خلال مراسلته بشكل مباشر، أو الإشارة إليه في مسافة أو إدخال أمر شرطة مائلة.
يرسل تطبيق Chat طلب HTTP متزامنًا إلى خادم نقطة نهاية HTTP.
يعالج تطبيق Google Chat لإدارة المشروعات عنوان HTTP الطلب:
يساعد Vertex AI في كتابة قصة مستخدم أو تعديلها.
تخزِّن قاعدة بيانات Firestore قصة المستخدم أو تستردها أو تحدِّثها أو تحذفها البيانات.
تعرض دوال السحابة الإلكترونية استجابة HTTP إلى Chat سيعرضها للمستخدم إما رسالة أو مربع حوار.
تحضير البيئة
يعرض هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده من أجل تطبيق Chat
إنشاء مشروع على Google Cloud
وحدة التحكّم في Google Cloud
- في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول و المشرف > إنشاء مشروع. .
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع. بعد إنشاء المشروع، لذا اختر رقم تعريف يلبي احتياجاتك طوال مشروعك.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة. مشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل 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
تفعيل الفوترة للمشروع على Google Cloud
وحدة التحكّم في Google Cloud
- في وحدة تحكُّم Google Cloud، انتقِل إلى الفوترة. (يُرجى النقر.) قائمة الطعام > الفوترة > مشاريعي.
- في القسم اختيار مؤسسة، اختَر المؤسسة المرتبطة مشروعك على Google Cloud
- في صف المشروع، افتح قائمة الإجراءات. ( ), انقر على تغيير الفوترة، واختر حساب فوترة Cloud.
- انقر على ضبط الحساب.
واجهة سطر الأوامر gcloud
- لسرد حسابات الفوترة المتاحة، شغِّل:
gcloud billing accounts list
- ربط حساب فوترة بمشروع على Google Cloud:
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
استبدِل ما يلي:
PROJECT_ID
هو رقم تعريف المشروع المشروع على السحابة الإلكترونية الذي تريد تفعيل الفوترة لهBILLING_ACCOUNT_ID
هو رقم تعريف حساب الفوترة المطلوب الربط به. لمشروع Google Cloud.
تفعيل واجهات برمجة التطبيقات
وحدة التحكّم في Google Cloud
في Google Cloud Console، عليك تفعيل Google Chat API وVertex AI API وCloud Functions API وFirestore API وCloud Build API وPub/Sub API وCloud Run Admin API.
تأكَّد من تفعيل واجهات برمجة التطبيقات بالشكل الصحيح مشروع على Google Cloud، ثم انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
واجهة سطر الأوامر gcloud
إذا لزم الأمر، اضبط المشروع الحالي على السحابة الإلكترونية على المشروع تم إنشاؤه باستخدام الأمر
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 باستخدام الأمر
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 في هذا القسم، يمكنك إجراء التالي:
- أنشئ قاعدة بيانات Firestore حيث يمكن الاحتفاظ بقصص المستخدم واستردادها.
- بشكل اختياري، راجع نموذج التعليمة البرمجية.
- أنشئ دالة سحابية لاستضافة دالة Cloud وتشغيلها رمز تطبيق Chat استجابةً للأحداث التي تم تلقّيها من Chat كطلبات HTTP.
- إنشاء تطبيق Google Chat ونشره على Google Chat API صفحة التكوين.
إنشاء قاعدة بيانات Firestore
في هذا القسم، يمكنك إنشاء قاعدة بيانات Firestore للاحتفاظ
قصصهم، لكنك لا تحدد نموذج البيانات. يتم تعيين نموذج البيانات
ضمنًا في نموذج الرمز من خلال model/user-story.js
وmodel/user.js
الملفات.
تستخدم قاعدة بيانات تطبيق Chat لإدارة المشاريع قاعدة بيانات NoSQL نموذج بيانات استنادًا إلى نموذج بيانات متجر النار:
مستندات منظمًا في المجموعات. لمزيد من المعلومات، يُرجى مراجعةالرسم التخطيطي التالي هو نظرة عامة على إدارة المشروعات نموذج بيانات تطبيق 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
في وحدة التحكّم في Google Cloud، انتقِل إلى Firestore. (يُرجى النقر.) قائمة الطعام > متجر إطفاء.
انقر على إنشاء قاعدة بيانات.
من اختَر وضع Firestore، انقر على وضع الأصلي.
انقر على متابعة.
اضبط قاعدة البيانات:
في تسمية قاعدة البيانات، اترك معرّف قاعدة البيانات كـ
(default)
.في نوع الموقع الجغرافي، حدِّد منطقة لقاعدة البيانات، مثل
us-central1
للحصول على أفضل أداء، اختَر المنتج نفسه أو منتجًا قريبًا. الموقع الجغرافي باعتباره وظيفة السحابة الإلكترونية في تطبيق Chat.
انقر على إنشاء قاعدة بيانات.
واجهة سطر الأوامر gcloud
أنشئ قاعدة بيانات Firestore في الوضع الأصلي باستخدام الأمر
gcloud firestore databases create
:gcloud firestore databases create \ --location=LOCATION \ --type=firestore-native
استبدل LOCATION باسم مخزن إطفاء المنطقة، مثل باسم
us-central1
.
مراجعة نموذج الرمز
اختياريًا، قبل إنشاء دالة السحابة، خصص بعض الوقت لمراجعة فتعرف على نموذج التعليمات البرمجية المستضافة على 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
قم بتنزيل الرمز من GitHub كملف ZIP.
استخرِج ملف ZIP الذي تم تنزيله.
يحتوي المجلد المستخرَج على نماذج Google Workspace بأكملها. المستودع.
في المجلد المستخرَج، انتقِل إلى
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/
في وحدة التحكّم في Google Cloud، انتقِل إلى صفحة "وظائف السحابة الإلكترونية":
الانتقال إلى وظائف السحابة الإلكترونية
تأكَّد من أنّ مشروع Google Cloud الخاص تم اختيار تطبيق Chat.
انقر على
إنشاء دالة.في صفحة إنشاء دالة، عليك إعداد الدالة:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، أدخِل
project-management-tutorial
. - في المنطقة، اختَر منطقة.
- ضمن المصادقة، اختَر السماح بالاستدعاءات التي لم تتم مصادقتها
- انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
projectManagementChatApp
في رمز المصدر، اختر تحميل بتنسيق ZIP.
في حزمة الوجهة، إنشاء أو اختَر مجموعة بيانات:
- انقر على تصفّح.
- اختَر مجموعة.
- انقر على اختيار.
تحمِّل Google Cloud ملف ZIP إلى ملفات المكوّنات ويستخرجها في هذه المجموعة. بعد ذلك تنسخ دوال Cloud ملفات المكوّنات إلى لدالة السحابة الإلكترونية.
في ملف Zip، حمِّل ملف ZIP الذي نزّلته من GitHub، ثم استخراجه وإعادة ضغطه:
- انقر على تصفّح.
- انتقل إلى الملف المضغوط وحدده.
- انقر على فتح.
انقر على نشر.
ستفتح صفحة تفاصيل دوال Cloud وتظهر دالتك. من خلال مؤشرين للتقدم: أحدهما للإصدار والآخر للخدمة. عند اختفاء مؤشري التقدّم واستبدالهما بعلامة تحقّق مارك، فإن الدالة تم نشرها وجاهزة.
تحرير نموذج التعليمة البرمجية لتعيين الثوابت:
- في صفحة تفاصيل دالة Cloud، انقر على تعديل.
- انقر على التالي.
- في رمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
. - استبدِل project-id برقم تعريف مشروعك على Google 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 Function حيث تتم استضافة بنيته الأساسية، مثل
us-central1
.
- عند انتهاء نشر الدالة، انسخ السمة
url
من الاستجابة. هذا هو عنوان URL المشغِّل الذي تستخدمه في القسم التالي إعداد تطبيق Google Chat
إعداد تطبيق Google Chat في وحدة تحكّم Google Cloud
يوضّح هذا القسم كيفية ضبط Chat API في وحدة تحكُّم Google Cloud التي تتضمن معلومات عن تطبيق Chat بما في ذلك اسم تطبيق Chat، والشرطة المائلة المتوافقة والأوامر وعنوان URL لمشغِّل السحابة الإلكترونية في تطبيق 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 للتطبيق.
في عنوان URL داخل التطبيق، ألصِق عنوان URL المشغِّل الذي نسخته من السحابة الإلكترونية نشر الدوال، بالتنسيق
https://
REGION-
PROJECT_ID.cloudfunctions.net/project-management-tutorial
. في حال نشر دالة Cloud باستخدام واجهة سطر الأوامر gcloud، سيكونurl
الموقع.تسجيل أوامر الشرطة المائلة. لتسجيل أمر شرطة مائلة:
- ضمن أوامر الشرطة المائلة، انقر على إضافة أمر شرطة مائلة.
لكل أمر من أوامر الشرطة المائلة الموضحة بالتفصيل في الجدول التالي، أدخِل الاسم ورقم تعريف الطلب والوصف واختَر ما إذا كان أمر الشرطة المائلة يفتح مربع حوار، ثم انقر على تم:
الاسم رقم تعريف الطلب الوصف يفتح مربع حوار /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 أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.
على الرغم من أنه قد لا تظهر رسالة الخطأ في واجهة مستخدم Chat، تتوفر رسائل خطأ وصفية وبيانات السجل لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء لتطبيقات Chat للحصول على مساعدة في العرض، وتصحيح الأخطاء وإصلاح الأخطاء، فراجع تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
- الإجابة عن الأسئلة استنادًا إلى المحادثات مع تطبيق Gemini AI Chat
- الرد على الحوادث باستخدام Google Chat وVertex AI وبرمجة التطبيقات