يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق Google Chat يجيب عن الأسئلة استنادًا إلى المحادثات في مساحات Chat باستخدام الذكاء الاصطناعي التوليدي المستند إلى Vertex AI مع Gemini. يستخدم تطبيق Chat واجهة برمجة التطبيقات Google Workspace Events API بالإضافة إلى ميزة Pub/Sub للتعرّف على الأسئلة المنشورة في مساحات Chat والإجابة عنها في الوقت الفعلي، حتى في حال عدم ذكرها.
يستخدم تطبيق Chat جميع الرسائل المُرسَلة في المساحة كمصدر بيانات وقاعدة معرفية: عندما يطرح مستخدم سؤالاً، يتحقّق تطبيق Chat من الإجابات التي تمت مشاركتها سابقًا، ثم يشاركها. إذا لم يتم العثور على أي إجابة، هذا يعني أنّه لا يمكن الإجابة. في كل إجابة، يمكن للمستخدمين النقر على زر الإجراء الملحق للإشارة إلى مدير المساحة وطلب إجابة عنها. يستخدم تطبيق Google Chat تكنولوجيات الذكاء الاصطناعي من Gemini ليتكيّف مع قاعدة معرفته ويطوّرها من خلال التدريب المستمر على المحادثات في المساحات التي تتم إضافتها إليها.
إليك طريقة عمل تطبيق Chat في مساحة إعداد الموظفين ودعمهم:
-
الشكل 2. تسأل "دانا" ما إذا كانت الشركة تقدّم تدريبًا على التحدُّث أمام الجمهور. -
الشكل 3. يطلب تطبيق Chat، المساعد المستنِد إلى الذكاء الاصطناعي، من Vertex AI مع Gemini الإجابة عن سؤال "دانا" بناءً على سجلّ المحادثات في "مساحة Chat"، ثم مشاركة الإجابة.
المتطلّبات الأساسية
حساب على 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 يستخدم الذكاء الاصطناعي التوليدي للإجابة عن الأسئلة استنادًا إلى المعلومات التي تتم مشاركتها من خلال المحادثات على "مساحة Chat".
- باستخدام الذكاء الاصطناعي التوليدي:
- اكتشاف أسئلة الموظف والإجابة عنها.
- تعلَّم باستمرار من المحادثات الجارية في مساحة Chat.
- يمكنك الاستماع إلى الرسائل والرد عليها في "مساحة Chat" في الوقت الفعلي، حتى إذا لم يتم إرسال رسائل إلى تطبيق Chat بشكل مباشر.
- لاستمرار الرسائل من خلال الكتابة إلى قاعدة بيانات Firestore والقراءة منها.
- يمكنك تسهيل التعاون في "مساحة Chat" من خلال الإشارة إلى مدراء المساحة في حال عدم العثور على إجابة عن السؤال.
هندسة معمارية
يوضّح المخطّط التالي بنية موارد Google Workspace وGoogle Cloud التي يستخدمها تطبيق Chat لمساعد المعرفة بالذكاء الاصطناعي.
يعمل تطبيق Chat المزوّد بمساعِد المعرفة بالذكاء الاصطناعي على النحو التالي:
يضيف مستخدم تطبيق Chat الذي يضم مساعد المعرفة بالذكاء الاصطناعي إلى مساحة Chat:
يطلب تطبيق Chat من المستخدم الذي أضافه إلى مساحة Chat ضبط المصادقة والترخيص.
يجلب تطبيق Chat رسائل المساحة من خلال استدعاء الطريقة
spaces.messages.list
في Chat API، ثم يخزِّن الرسائل التي تم استرجاعها في قاعدة بيانات Firestore.يطلب تطبيق Chat الطريقة
subscriptions.create
في Google Workspace Events API لبدء الاستماع إلى أحداث، مثل الرسائل في المساحة. نقطة نهاية الإشعارات الخاصة بالاشتراك هي موضوع نشر/اشتراك يستخدم Eventarc لإعادة توجيه الحدث إلى تطبيق Chat.ينشر تطبيق Chat رسالة تمهيدية إلى المساحة.
ينشر مستخدم في "مساحة Chat" رسالة:
يتلقى تطبيق Chat الرسالة في الوقت الفعلي من موضوع النشر/الاشتراك.
يضيف تطبيق Chat الرسالة إلى قاعدة بيانات Firestore.
إذا عدّل أحد المستخدمين الرسالة أو حذفها لاحقًا، يتلقّى تطبيق Chat الحدث المعدّل أو المحذوف في الوقت الفعلي، ثم يعدِّل الرسالة أو يحذفها في قاعدة بيانات Firestore.
يرسل تطبيق Chat الرسالة إلى Vertex AI باستخدام Gemini:
يطلب الطلب من Vertex AI مع Gemini التحقّق ممّا إذا كانت الرسالة تتضمّن سؤالاً. في هذه الحالة، يجيب Gemini عن السؤال بالاستناد إلى سجلّ رسائل مساحة Chat المحفوظ في Firestore، ويُرسِل تطبيق Google Chat الرسالة إلى مساحة Chat. وإذا لم يحدث ذلك، فلا تردّ.
إذا أجاب Vertex AI مع Gemini على السؤال، سينشر تطبيق Chat الإجابة من خلال طلب طريقة
spaces.messages.create
في Chat API باستخدام مصادقة التطبيقات.إذا لم يتمكّن Vertex AI مع Gemini من الإجابة عن السؤال، ينشر تطبيق Chat رسالة تفيد بأنّه لا يمكنه العثور على إجابة عن هذا السؤال في سجلّ "مساحة Chat".
وتتضمّن الرسائل دائمًا زر إجراء ملحق يمكن للمستخدمين النقر عليه، ما يدفع تطبيق Chat إلى الإشارة باستخدام @ إلى مدير مساحة يطلب منهم الرد.
يتلقّى تطبيق Chat إشعارًا من واجهة برمجة التطبيقات Google Workspace Events API يفيد بأنّ اشتراك مساحة Chat على وشك الانتهاء:
- يرسل تطبيق Chat طلبًا لتجديد الاشتراك من خلال طلب طريقة
subscriptions.patch
في Google Workspace Events API.
- يرسل تطبيق Chat طلبًا لتجديد الاشتراك من خلال طلب طريقة
تتم إزالة تطبيق Chat من مساحة Chat:
يحذف تطبيق Chat الاشتراك من خلال استدعاء الطريقة
subscriptions.delete
في Google Workspace Events API.يحذف تطبيق Chat بيانات "مساحة Chat" من Firestore.
مراجعة المنتجات التي يستخدمها تطبيق Chat لمساعد المعرفة المستنِد إلى الذكاء الاصطناعي
يستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستنِد إلى الذكاء الاصطناعي منتجات Google Workspace وGoogle Cloud التالية:
- Vertex AI API من خلال Gemini: منصة مستندة إلى الذكاء الاصطناعي التوليدي تستند إلى Gemini. يستخدم تطبيق Chat، المساعِد على المعرفة بالذكاء الاصطناعي، واجهة Vertex AI API مع Gemini للتعرّف على أسئلة الموظفين وفهمها والإجابة عنها.
-
Chat API:
واجهة برمجة تطبيقات لتطوير تطبيقات Google Chat التي تتلقّى
أحداث التفاعل في Chat وتردّ عليها، مثل الرسائل. يستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستنِد إلى الذكاء الاصطناعي واجهة Chat API لإجراء ما يلي:
- تلقّي أحداث التفاعل المُرسَلة من خلال Chat والردّ عليها
- إدراج الرسائل المُرسَلة في مساحة
- يمكنك نشر الردود على أسئلة المستخدمين في مساحة.
- يمكنك ضبط السمات التي تحدّد كيفية ظهور المحادثة في Chat، مثل الاسم والصورة الرمزية.
- Google Workspace Events API: تتيح لك واجهة برمجة التطبيقات هذه الاشتراك في الفعاليات وإدارة الإشعارات المتعلّقة بالتغييرات في جميع تطبيقات Google Workspace. ويستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستنِد إلى الذكاء الاصطناعي Google Workspace Events API للاستماع إلى الرسائل المنشورة في "مساحة Chat" ليتمكّن من رصد الأسئلة والإجابة عنها حتى في حال عدم ذكرها.
- Firestore: قاعدة بيانات مستندات بدون خادم. يستخدم تطبيق Chat للمساعد المعرفي المستنِد إلى الذكاء الاصطناعي Firestore لتخزين بيانات الرسائل المُرسَلة في "مساحة Chat".
- النشر/الاشتراك: النشر/الاشتراك هي خدمة مراسلة غير متزامنة وقابلة للتطوّر تفصل بين الخدمات التي تنتج الرسائل عن الخدمات التي تعالج هذه الرسائل. يستخدم تطبيق Chat المزوّد بمساعِد المعرفة بالذكاء الاصطناعي ميزة النشر/الاشتراك لتلقّي فعاليات الاشتراكات من مساحات Chat.
- Eventarc: تتيح لك Eventarc إنشاء بُنى تستند إلى الأحداث بدون الحاجة إلى تنفيذ البنية الأساسية الأساسية أو تخصيصها أو صيانتها. ويستخدم تطبيق Chat المزوّد بمساعِد المعرفة بالذكاء الاصطناعي Eventarc لتوجيه الأحداث من Pub/Sub إلى مساحة Chat، ووظيفة Cloud التي تتلقّى أحداث الاشتراك وتعالجها.
-
الوظائف السحابية:
خدمة حوسبة خفيفة بدون خادم تتيح لك إنشاء وظائف مستقلة لغرض واحد يمكنها الاستجابة لأحداث التفاعل والاشتراكات في Chat بدون الحاجة إلى إدارة بيئة وقت تشغيل أو خادم. يستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستنِد إلى الذكاء الاصطناعي دالتَين من دالات السحابة الإلكترونية المسماة:
-
app
: يمكنك استضافة نقطة نهاية HTTP التي يرسل تطبيق Chat أحداث التفاعل إليها كنظام أساسي للحوسبة، وذلك من أجل تنفيذ منطق يعالج هذه الأحداث ويستجيب لها. -
eventsApp
: يتم تلقّي أحداث مساحة Chat ومعالجتها، مثل الرسائل الواردة من اشتراك في نشر/اشتراك.
- Cloud Build: هي منصّة تكامل وتسليم ونشر مستمر مُدارة بالكامل تشغّل إصدارات مبرمَجة.
- التشغيل في السحابة الإلكترونية: بيئة مُدارة بالكامل لتشغيل التطبيقات المضمّنة في حاويات.
-
تحضير البيئة
يعرض هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداده لتطبيق Chat.
إنشاء مشروع على Google Cloud
وحدة التحكّم في Google Cloud
- في Google Cloud Console، انتقِل إلى القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إنشاء مشروع.
-
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير رقم تعريف المشروع بعد إنشائه، لذا اختَر رقم تعريف يلبي احتياجاتك طوال مدة المشروع.
- في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتمَلة لمشروعك. بعد ذلك، انقر على اختيار.
- انقر على إنشاء. تنتقل وحدة التحكّم في Google Cloud إلى صفحة "لوحة البيانات" وسيتم إنشاء مشروعك في غضون بضع دقائق.
واجهة سطر الأوامر gcloud
في إحدى بيئات التطوير التالية، يمكنك الوصول إلى واجهة سطر الأوامر في Google Cloud (`gcloud`):
-
Cloud Shell: لاستخدام وحدة طرفية على الإنترنت مع إعداد واجهة CLI على gcloud، يمكنك تفعيل Cloud Shell.
تفعيل Cloud Shell -
Local Shell: لاستخدام بيئة تطوير محلية، عليك
تثبيت
initialize
واجهة سطر الأوامر gcloud.
لإنشاء مشروع على Google Cloud، استخدِم الأمر `gcloud المشروعات 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
هو رقم تعريف المشروع للمشروع على Google Cloud الذي تريد تفعيل الفوترة له.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 وGoogle Workspace Events API وEventarc API وCloud Run Admin API.
تأكَّد من تفعيل واجهات برمجة التطبيقات في مشروع Cloud الصحيح، ثمّ انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
واجهة سطر الأوامر gcloud
إذا لزم الأمر، اضبط المشروع الحالي على Cloud على المشروع الذي أنشأته:
gcloud config set project PROJECT_ID
استبدِل PROJECT_ID برقم تعريف المشروع الخاص بالمشروع الذي أنشأته على السحابة الإلكترونية.
يمكنك تفعيل Google Chat API وVertex AI API وCloud Functions API وFirestore API وCloud Build API وواجهة Pub/Sub، وواجهة برمجة التطبيقات Google Workspace Events API، وEventarc API، وواجهة برمجة التطبيقات للمشرف في Cloud Run:
gcloud services enable chat.googleapis.com \ aiplatform.googleapis.com \ cloudfunctions.googleapis.com \ firestore.googleapis.com \ cloudbuild.googleapis.com \ pubsub.googleapis.com \ workspaceevents.googleapis.com \ eventarc.googleapis.com \ run.googleapis.com
إعداد المصادقة والتفويض
تتيح المصادقة والتفويض لتطبيق Chat الوصول إلى الموارد في Google Workspace وGoogle Cloud.
في هذا البرنامج التعليمي، ستنشر تطبيق Google Chat داخليًا حتى تتمكن من استخدام معلومات العنصر النائب. قبل نشر تطبيق Google Chat خارجيًا، استبدِل معلومات العنصر النائب بمعلومات حقيقية عن شاشة الموافقة.
ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وتحديد النطاقات وتسجيل تطبيقك
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > شاشة موافقة OAuth.
ضمن نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
في اسم التطبيق، اكتب
AI knowledge assistant
.ضِمن البريد الإلكتروني المخصّص لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google مناسبة.
ضمن معلومات الاتصال بالمطوِّر، أدخِل عنوان بريدك الإلكتروني.
انقر على حفظ ومتابعة.
انقر على إضافة نطاقات أو إزالتها. تظهر لوحة تتضمن قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعَّلتها في مشروعك على السحابة الإلكترونية.
ضمن إضافة النطاقات يدويًا، الصِق النطاق التالي:
https://www.googleapis.com/auth/chat.messages
انقر على إضافة إلى الجدول.
انقر على تعديل.
انقر على حفظ ومتابعة.
راجِع ملخّص تسجيل التطبيق، ثم انقر على الرجوع إلى لوحة البيانات.
إنشاء بيانات اعتماد معرِّف عميل OAuth
في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
انقر على نوع التطبيق > تطبيق الويب.
في حقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في وحدة تحكم Google Cloud.
ضمن معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على إضافة معرِّف الموارد المنتظم (URI).
في معرّفات الموارد المنتظمة (URI) 1، اكتب ما يلي:
https://REGION-PROJECT_ID.cloudfunctions.net/app/oauth2
استبدِل ما يلي:
- REGION: منطقة دالّة السحابة الإلكترونية، مثل
us-central1
. عند إنشاء دالتَي السحابة الإلكترونية لاحقًا، عليك ضبط المنطقة الخاصة بهما على هذه القيمة. - PROJECT_ID: رقم تعريف المشروع للمشروع الذي أنشأته على Cloud الذي أنشأته
- REGION: منطقة دالّة السحابة الإلكترونية، مثل
انقر على إنشاء.
من النافذة التي تم إنشاؤها باستخدام عميل OAuth، انقر على تنزيل JSON.
يجب حفظ الملف الذي تم تنزيله باسم
client_secrets.json
. وفي وقت لاحق، عند إنشاء دالتَي Cloud، يمكنك تضمين ملفclient_secrets.json
في كل عملية نشر.انقر على موافق.
إنشاء موضوع النشر/الاشتراك
يعمل موضوع النشر/الاشتراك مع واجهة برمجة التطبيقات Google Workspace Events API للاشتراك في الفعاليات في مساحة Chat، مثل الرسائل وإشعار تطبيق Chat في الوقت الفعلي.
إليك كيفية إنشاء موضوع النشر/الاشتراك:
وحدة التحكّم في Google Cloud
في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > نشر/اشتراك.
انقر على إنشاء موضوع.
في رقم تعريف الموضوع، اكتب
events-api
.ألغِ اختيار إضافة اشتراك تلقائي.
ضمن التشفير، اختَر مفتاح التشفير الذي تديره Google.
انقر على إنشاء. يظهر موضوع النشر/الاشتراك.
لكي يعمل موضوع Pub/Sub وGoogle Workspace Events API معًا، يجب منح مستخدم Chat IAM الإذن بالنشر في موضوع النشر/الاشتراك:
في لوحة events-api، ضمن الأذونات، انقر على إضافة مدير.
ضمن إضافة العناصر الرئيسية، في العناصر الرئيسية الجديدة، اكتب
chat-api-push@system.gserviceaccount.com
.ضِمن تعيين الأدوار، في اختيار دور، انقر على نشر/اشتراك > ناشر/اشتراك.
انقر على حفظ.
واجهة سطر الأوامر gcloud
إنشاء موضوع نشر/اشتراك باستخدام رقم تعريف الموضوع
events-api
:gcloud pubsub topics create events-api
امنح مستخدم إدارة الهوية وإمكانية الوصول في Chat إذنًا للنشر في موضوع النشر/الاشتراك:
gcloud pubsub topics add-iam-policy-binding events-api \ --member='serviceAccount:chat-api-push@system.gserviceaccount.com' \ --role='roles/pubsub.publisher'
إنشاء قاعدة بيانات Firestore
تحتفظ قاعدة بيانات Firestore بالبيانات
واستردادها من مساحات Chat، مثل الرسائل. أنت لا تُحدِّد نموذج البيانات الذي يتم ضبطه ضمنيًا في نموذج الرمز من خلال الملفَّين model/message.js
وservices/firestore-service.js
.
تستخدم قاعدة بيانات تطبيق Chat المساعد للمعرفة المستنِدة إلى الذكاء الاصطناعي نموذج بيانات NoSQL استنادًا إلى نموذج بيانات Firestore.
المستندات المنظّمة في مجموعات. لمزيد من المعلومات، يُرجى الاطّلاع علىيمثّل المخطّط التالي نظرة عامة على نموذج بيانات تطبيق Chat المساعد للمعرفة المستنِدة إلى الذكاء الاصطناعي:
يحتوي الجذر على مجموعتَين:
spaces
، حيث يمثل كل مستند "مساحة Chat" التي تتم إضافة تطبيق Chat إليها. يتم تمثيل كل رسالة من خلال مستند في المجموعة الفرعيةmessages
.users
، حيث يمثل كل مستند المستخدم الذي أضاف تطبيق Chat إلى مساحة Chat.
عرض تعريفات المجموعة والمستندات والحقول
spaces
مساحة Chat تتضمّن تطبيق Chat الذي يضم مساعد المعرفة بالذكاء الاصطناعي.
الحقول | |
---|---|
Document ID | String معرّف فريد لمساحة معيّنة جزء من اسم مورد المساحة في Chat API |
messages | Subcollection of Documents ( الرسائل التي يتم إرسالها في "مساحة Chat" يتوافق مع Document ID لـ message في Firebase. |
spaceName | String الاسم الفريد للمساحة في Chat API يتطابق مع اسم مورد المساحة في Chat API. |
messages
الرسائل المُرسَلة في "مساحة Chat"
الحقول | |
---|---|
Document ID | String معرّف فريد لرسالة معيّنة |
name | String الاسم الفريد لرسالة في Chat API يطابِق اسم مورد الرسالة في Chat API. |
text | String نص الرسالة |
time | String (Timestamp format) وقت إنشاء الرسالة |
users
المستخدمون الذين أضافوا تطبيق Chat لمساعد المعرفة المستند إلى الذكاء الاصطناعي إلى مساحة Chat
الحقول | |
---|---|
Document ID | String معرّف فريد لمستخدِم معيّن |
accessToken | String رمز الدخول الذي تم منحه أثناء تفويض المستخدم في OAuth 2.0، والذي تم استخدامه لطلب واجهات برمجة تطبيقات Google Workspace. |
refreshToken | String الرمز المميّز لإعادة التحميل الذي تم منحه أثناء تفويض المستخدم في OAuth 2.0. |
إليك كيفية إنشاء قاعدة بيانات Firestore:
وحدة التحكّم في Google Cloud
في وحدة التحكّم في Google Cloud، انتقِل إلى القائمة > Firestore.
انقر على إنشاء قاعدة بيانات.
من اختَر وضع Firestore، انقر على وضع الأصلي.
انقر على متابعة.
اضبط قاعدة البيانات:
في تسمية قاعدة البيانات، اترك معرّف قاعدة البيانات كـ
(default)
.ضمن نوع الموقع الجغرافي، اختَر المنطقة.
في Region، حدِّد منطقة لقاعدة بياناتك، مثل
us-central1
. للحصول على أفضل أداء، اختَر الموقع الجغرافي نفسه أو الموقع المجاور نفسه لوظائف السحابة الإلكترونية في تطبيق Chat.
انقر على إنشاء قاعدة بيانات.
واجهة سطر الأوامر gcloud
إنشاء قاعدة بيانات Firestore في الوضع الأصلي:
gcloud firestore databases create \ --location=LOCATION \ --type=firestore-native
استبدِل LOCATION باسم منطقة محل أسلحة، مثل
us-central1
. للحصول على أفضل أداء، اختَر الموقع الجغرافي نفسه أو الموقع الجغرافي القريب نفسه الذي تستخدمه دوال Cloud في تطبيق Chat.
إنشاء تطبيق Chat ونشره
الآن بعد إنشاء مشروعك على Google Cloud وإعداده، أصبحت جاهزًا لإنشاء تطبيق Chat ونشره. في هذا القسم، يمكنك إجراء ما يلي:
- إنشاء دالتَين في السحابة الإلكترونية ونشرها وأحدهما للرد على أحداث التفاعل عبر الدردشة والآخر للرد على أحداث النشر/الاشتراك.
- يمكنك إنشاء تطبيق Chat ونشره في صفحة إعداد Google Chat API.
إنشاء دوال Cloud ونشرها
في هذا القسم، يمكنك إنشاء دالتَين من دوال السحابة الإلكترونية ونشرهما وهما:
app
: يستضيف ويشغِّل رمز تطبيق Chat الذي يستجيب للأحداث الواردة من Chat في شكل طلبات HTTP.eventsApp
: يتم تلقّي أحداث مساحة Chat ومعالجتها مثل الرسائل الواردة من نشر/اشتراك.
تشكِّل هذه الدوال السحابية معًا منطق تطبيق مساعد المعرفة المستند إلى الذكاء الاصطناعي في تطبيق Chat.
وقبل إنشاء دوال Cloud، يُرجى تخصيص بعض الوقت لمراجعة نموذج التعليمات البرمجية المستضافة على GitHub والتعرّف عليها.
إنشاء ونشر app
وحدة التحكّم في Google Cloud
قم بتنزيل الرمز من GitHub كملف ZIP.
استخرِج ملف ZIP الذي تم تنزيله.
يحتوي المجلد المستخرج على مستودع نماذج Google Workspace بالكامل.
في المجلد المستخرَج، انتقِل إلى دليل "
google-chat-samples-main/node/ai-knowledge-assistant
".في دليل
google-chat-samples/node/ai-knowledge-assistant
، أضِف ملفclient_secrets.json
الذي نزّلته عند إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والتفويض.اضغط محتوى مجلد
ai-knowledge-assistant
داخل ملف ZIP.يجب أن يحتوي الدليل الجذري لملف zip على الملفات والمجلدات التالية:
.gcloudignore
.gitignore
README.md
deploy.sh
env.js
events_index.js
http_index.js
index.js
client_secrets.json
package-lock.json
package.json
controllers/
model/
services/
test/
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > وظائف السحابة الإلكترونية.
الانتقال إلى وظائف السحابة الإلكترونية
احرص على اختيار مشروع Google Cloud لتطبيق Chat.
انقر على
إنشاء دالة.في صفحة إنشاء دالة، عليك إعداد الدالة:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، اكتب
app
. - في المنطقة، اختَر منطقة، مثل
us-central1
. يجب أن تتطابق هذه المنطقة مع المنطقة التي أعددتها في معرّف الموارد المنتظم (URI) المعتمَد لإعادة التوجيه عند إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والتفويض. - في نوع المشغِّل، اختر HTTPS.
- ضمن المصادقة، اختَر السماح بالاستدعاءات التي لم تتم مصادقتها.
- انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
app
.في رمز المصدر، اختر تحميل بتنسيق ZIP.
في حزمة الوجهة، يمكنك إنشاء حزمة أو اختيارها:
- انقر على تصفّح.
- اختَر مجموعة.
- انقر على اختيار.
تحمِّل Google Cloud ملف ZIP إلى ملفات المكوّنات في هذه الحزمة ويستخرجها. بعد ذلك تنسخ دوال Cloud ملفات المكوّنات إلى دالة Cloud.
في ملف Zip، حمِّل ملف ZIP الذي نزّلته من GitHub واستخراجته ثمّ أعِد ضغطه:
- انقر على تصفّح.
- انتقل إلى الملف المضغوط وحدده.
- انقر على فتح.
انقر على نشر.
ستفتح صفحة تفاصيل دوال السحابة، وتظهر وظيفتك مع مؤشرَين للتقدم: أحدهما للإصدار والآخر للخدمة. عندما يختفي كلا مؤشري التقدم ويتم استبدالهما بعلامة اختيار، تكون الدالة منتشرة وجاهزة.
تحرير نموذج التعليمة البرمجية لتعيين الثوابت:
- في صفحة تفاصيل دالة Cloud، انقر على تعديل.
- انقر على التالي.
- في رمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
وعدِّله:- اضبط قيمة project على رقم تعريف مشروعك على Google Cloud.
- اضبط قيمة location على منطقة دالة Cloud، مثل
us-central1
.
انقر على نشر.
واجهة سطر الأوامر gcloud
استنسِخ الرمز من GitHub:
git clone https://github.com/googleworkspace/google-chat-samples.git
قم بالتبديل إلى الدليل الذي يحتوي على رمز تطبيق Chat لمساعد المعرفة بالذكاء الاصطناعي:
cd google-chat-samples/node/ai-knowledge-assistant
في دليل
google-chat-samples/node/ai-knowledge-assistant
، أضِف ملفclient_secrets.json
الذي نزّلته عند إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والتفويض.عدِّل ملف
env.js
لضبط متغيّرات البيئة على النحو التالي:- اضبط قيمة project على رقم تعريف مشروعك على Google Cloud.
- اضبط قيمة location على منطقة دالة Cloud، مثل
us-central1
.
نشر وظيفة السحابة الإلكترونية على Google Cloud:
gcloud functions deploy app \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=app \ --trigger-http \ --allow-unauthenticated
استبدِل REGION بقيمة المنطقة في دالة Cloud لمطابقة المنطقة المحدّدة في ملف
env.js
، مثلus-central1
.
إنشاء ونشر eventsApp
وحدة التحكّم في Google Cloud
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > وظائف السحابة الإلكترونية.
الانتقال إلى وظائف السحابة الإلكترونية
احرص على اختيار مشروع Google Cloud لتطبيق Chat.
انقر على
إنشاء دالة.في صفحة إنشاء دالة، عليك إعداد الدالة:
- في البيئة، اختَر الجيل الثاني.
- في اسم الدالة، اكتب
eventsApp
. - في المنطقة، اختَر منطقة، مثل
us-central1
. يجب أن تتطابق هذه المنطقة مع المنطقة التي أعددتها في معرّف الموارد المنتظم (URI) المعتمَد لإعادة التوجيه عند إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والتفويض. - في نوع المشغِّل، اختَر Cloud Pub/Sub.
- في موضوع Cloud Pub/Sub، اختَر اسم موضوع النشر/الاشتراك الذي
أنشأته، والذي يكون بالتنسيق
projects/PROJECT/topics/events-api
حيث يشير PROJECT إلى رقم تعريف مشروعك على Cloud. - إذا ظهرت لك رسالة تبدأ بـ
Service account(s) might not have enough permissions to deploy the function with the selected trigger.
، انقر على منح الكل. - انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
eventsApp
.في رمز المصدر، اختَر Zip from Cloud Storage.
في موقع Cloud Storage، انقر على تصفُّح.
اختَر الحزمة التي حمّلت ملف ZIP إليها عند إنشاء
app
Cloud Function.انقر على ملف ZIP الذي حمّلته.
انقر على اختيار.
انقر على نشر.
تفتح صفحة تفاصيل دوال السحابة الإلكترونية، وتظهر وظيفتك مع ثلاثة مؤشرات للتقدّم: مؤشر للإصدار، وآخر للخدمة، وآخر للعامل المشغِّل. عندما تختفي جميع مؤشرات التقدم الثلاثة واستبدالها بعلامة اختيار، يتم نشر الدالة وتكون جاهزة.
تحرير نموذج التعليمة البرمجية لتعيين الثوابت:
- في صفحة تفاصيل دالة Cloud، انقر على تعديل.
- انقر على التالي.
- في رمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
وعدِّله:- اضبط قيمة project على رقم تعريف مشروعك على Google Cloud.
- اضبط قيمة location على منطقة دالة Cloud، مثل
us-central1
.
انقر على نشر.
واجهة سطر الأوامر gcloud
في gcloud CLI، إذا لم يسبق لك ذلك، انتقِل إلى الدليل الذي يحتوي على الرمز الخاص بتطبيق Chat لمساعد المعرفة بالذكاء الاصطناعي والذي استنسخته سابقًا من GitHub:
cd google-chat-samples/node/ai-knowledge-assistant
في دليل
google-chat-samples/node/ai-knowledge-assistant
، أضِف ملفclient_secrets.json
الذي نزّلته عند إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والتفويض.عدِّل ملف
env.js
لضبط متغيّرات البيئة على النحو التالي:- اضبط قيمة project على رقم تعريف مشروعك على Google Cloud.
- اضبط قيمة location على منطقة دالة Cloud، مثل
us-central1
.
نشر وظيفة السحابة الإلكترونية على Google Cloud:
gcloud functions deploy eventsApp \ --gen2 \ --region=REGION \ --runtime=nodejs20 \ --source=. \ --entry-point=eventsApp \ --trigger-topic=events-api
استبدِل REGION بقيمة المنطقة في دالة Cloud لمطابقة المنطقة المحدّدة في ملف
env.js
، مثلus-central1
.
انسخ عنوان URL لمشغِّل app
Cloud Function.
يمكنك لصق عنوان URL لمشغِّل app
Cloud Function في القسم التالي
عند
ضبط تطبيق Chat في Google Cloud Console.
وحدة التحكّم في Google Cloud
في وحدة تحكُّم Google Cloud، انتقِل إلى القائمة > وظائف السحابة الإلكترونية.
في عمود الاسم في قائمة دوال السحابة، انقر على
app
.انقر على تشغيل.
انسخ عنوان URL.
واجهة سطر الأوامر gcloud
وصف دالة السحابة الإلكترونية
app
:gcloud functions describe app
انسخ السمة
url
.
ضبط تطبيق Chat في وحدة تحكّم Google Cloud
يعرض هذا القسم كيفية ضبط واجهة Chat API في Google Cloud Console باستخدام معلومات عن تطبيق Chat، بما في ذلك اسم تطبيق Chat وعنوان URL المشغّل الخاص بوظيفة Cloud في تطبيق Chat التي يرسل إليها أحداث التفاعل في Chat.
في Google Cloud Console، انقر على رمز القائمة > مزيد من المنتجات > Google Workspace > مكتبة المنتجات > Google Chat API > إدارة > الإعداد.
في اسم التطبيق، اكتب
AI knowledge assistant
.في عنوان URL للصورة الرمزية، اكتب
https://fonts.gstatic.com/s/i/short-term/release/googlesymbols/live_help/default/24px.svg
.في الوصف، اكتب
Answers questions with AI
.انقر على مفتاح التبديل تفعيل الميزات التفاعلية لتفعيله.
ضمن الوظائف، اختَر الانضمام إلى المساحات والمحادثات الجماعية.
ضمن إعدادات الربط، اختَر عنوان URL للتطبيق.
في عنوان URL للتطبيق، الصِق عنوان URL المشغِّل من دالة السحابة الإلكترونية
app
بتنسيقhttps://
REGION-
PROJECT_ID.cloudfunctions.net/app
حيث يشير REGION إلى منطقة دالة Cloud، مثلus-central1
وPROJECT_ID هو رقم تعريف المشروع للمشروع الذي أنشأته على السحابة الإلكترونية.ضمن مستوى الرؤية، اختَر إتاحة تطبيق Chat هذا لمستخدمين محدّدين ومجموعات محدّدة في نطاق Workspace وأدخِل عنوان بريدك الإلكتروني.
اختياريًا، ضمن السجلات، اختَر تسجيل الأخطاء إلى التسجيل.
انقر على حفظ. تظهر رسالة تم حفظها بالإعداد، ما يعني أن تطبيق Chat جاهز للاختبار.
اختبار تطبيق Chat
يمكنك اختبار تطبيق Chat لمساعد المعرفة الخاص بالذكاء الاصطناعي في "مساحة Chat" تتضمّن رسائل من خلال طرح أسئلة يمكن لتطبيق Chat المساعد أن يجيب عنها.
إليك بعض الطرق لاختبار تطبيق Chat الذي يضم مساعد المعرفة بالذكاء الاصطناعي:
- يمكنك إضافة تطبيق Chat الذي يضم مساعد المعرفة بالذكاء الاصطناعي إلى مساحة Chat حالية وطرح أسئلة ذات صلة بتلك المساحة.
- أنشِئ مساحة Chat وانشر بعض الرسائل لاستخدامها
كمصدر بيانات. يمكن الحصول على الرسائل من
Gemini من خلال طلب مثل
Answer 20 common onboarding questions employees ask their teams.
، أو يمكنك لصق بضع فقرات من دليل نظرة عامة حول التطوير باستخدام Chat، ثم طرح أسئلة حول هذا الطلب.
في هذا البرنامج التعليمي، لننشئ مساحة Chat ونلصق بضع فقرات من دليل نظرة عامة حول التطوير باستخدام Chat.
افتح Google Chat.
إنشاء "مساحة Chat":
انقر على > إنشاء مساحة.
محادثة جديدةفي اسم المساحة، اكتب
Testing AI knowledge assistant app
.ضمن الغرض من هذه المساحة؟، اختَر التعاون.
ضمن إعدادات الوصول، اختَر مَن يمكنه الوصول إلى المساحة.
انقر على إنشاء.
إضافة رسائل لاستخدامها كمصدر بيانات:
في متصفِّح الويب، انتقِل إلى دليل نظرة عامة حول التطوير باستخدام Chat.
انسخ محتوى الدليل والصقه في مساحة Chat التي أنشأتها.
إضافة تطبيق Chat لمساعد المعرفة المستنِد إلى الذكاء الاصطناعي:
في خانة إدخال الرسائل، اكتب
@AI knowledge assistant
وفي قائمة الاقتراحات التي تظهر، اختَر تطبيق Chat لمساعد المعرفة المستند إلى الذكاء الاصطناعي، واضغط علىenter
.ستظهر رسالة تسألك ما إذا كنت تريد إضافة تطبيق Chat الذي يضم مساعد المعرفة بالذكاء الاصطناعي إلى المساحة. انقر على الإضافة إلى المساحة.
إذا كانت هذه هي المرة الأولى التي تضيف فيها تطبيق Chat إلى مساحة، عليك ضبط المصادقة والتفويض لتطبيق Chat:
- انقر على ضبط.
- ستفتح نافذة متصفّح أو علامة تبويب جديدة تطلب منك اختيار حساب Google. اختر الحساب الذي تريد الاختبار باستخدامه.
- راجِع الأذونات التي يطلبها تطبيق Chat المساعد للمعرفة المستنِدة إلى الذكاء الاصطناعي. لمنحهم، انقر على السماح.
- ستظهر رسالة مفادها
You may close this page now.
. أغلق نافذة المتصفح أو علامة التبويب وارجع إلى مساحة Chat.
طرح سؤال:
في خانة إدخال الرسالة، اكتب سؤالاً مثل
What are Google Chat apps?
يجيب تطبيق Chat المساعد للمعرفة عبر الذكاء الاصطناعي.
اختياريًا، إذا لم تكن الإجابة دقيقة أو كافية للمساعدة في تحسين سجلّ المحادثات من الذكاء الاصطناعي، انقر على
الحصول على المساعدة. يذكر تطبيق Chat المساعد للمعرفة بالذكاء الاصطناعي مدير مساحة ويطلب منه الإجابة عن السؤال. في المرة القادمة، سيعرف تطبيق مساعد المعرفة في Chat بالذكاء الاصطناعي الإجابة!
الاعتبارات وخيارات البنية البديلة والخطوات التالية
يراجع هذا القسم الطرق الأخرى التي يمكن من خلالها إنشاء تطبيق Chat المساعِد المستنِد إلى الذكاء الاصطناعي.
Firestore أو Cloud Storage أو ميزة "رسائل قوائم المكالمات" في Chat API
ينصح هذا البرنامج التعليمي بتخزين بيانات مساحة Chat، مثل
الرسائل في قاعدة بيانات Firestore، لأنّ ذلك يحسِّن الأداء مقارنةً
بطلب طريقة list
على مورد Message
باستخدام Chat API في كل مرة
يجيب فيها تطبيق Chat عن سؤال. بالإضافة إلى ذلك، قد يؤدي طلب
list messages
بشكل متكرّر إلى بلوغ تطبيق Chat الحدّ الأقصى لحصة واجهة برمجة التطبيقات.
ومع ذلك، إذا أصبح سجلّ المحادثات في "مساحة Chat" طويلاً جدًا، قد يكون استخدام Firestore مكلفًا.
تُعدّ خدمة Cloud Storage بديلاً عن Firestore. يتم تخصيص عنصر لكل مساحة يفعّل فيها تطبيق Chat المساعد للمعرفة المستنِد إلى الذكاء الاصطناعي، ويكون كل عنصر ملفًا نصيًا يحتوي على جميع الرسائل المتوفّرة في المساحة. وتتمثّل الميزة في هذا الأسلوب في أنّه يمكن إدخال المحتوى الكامل للملف النصي إلى Vertex AI باستخدام Gemini في آنٍ واحد، ولكن من العيوب أنّ تعديل سجلّ المحادثات يتطلب المزيد من الجهد، لأنّه لا يمكنك إلحاقه بعنصر في Cloud Storage، ولكن يجب استبداله فقط. ولن يكون لهذه الطريقة أي معنى إذا كنت تعدّل سجلّ الرسائل بشكل منتظم، ولكن سيكون من المفيد تعديل سجلّ الرسائل بشكل مجمّع بشكل دوري، على سبيل المثال مرة واحدة في الأسبوع.
تحديد المشاكل وحلّها
عندما يعرض تطبيق أو بطاقة Google Chat رسالة خطأ، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن يعرض تطبيق Chat أو بطاقة بياناته نتيجة غير متوقعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.
على الرغم من أنّ رسالة الخطأ قد لا تظهر في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة بشأن الاطّلاع على الأخطاء وتصحيحها وتصحيحها، راجِع تحديد المشاكل في Google Chat وحلّها.
تَنظيم
لتجنُّب تحمُّل أي رسوم من حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا الدليل التوجيهي، ننصحك بحذف المشروع على Google Cloud.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف التشغيل لحذف المشروع.
مواضيع ذات صلة
- إدارة المشاريع باستخدام Google Chat وVertex AI وFirestore
- الرد على الحوادث باستخدام Google Chat وVertex AI وبرمجة التطبيقات