يشرح هذا الدليل التوجيهي كيفية إنشاء تطبيق Google Chat يجيب عن أسئلة تستند إلى المحادثات في "مساحات Chat" مع أداة إنشاء الذكاء الاصطناعي مستند إلى Vertex AI مع Gemini يستخدم تطبيق Chat Google Workspace Events API بالإضافة إلى ميزة Pub/Sub للتعرّف على الأسئلة والإجابة عنها. في مساحات Chat في الوقت الفعلي، حتى في حال غير مذكور.
يستخدم تطبيق Chat جميع الرسائل المُرسَلة في المساحة كـ مصدر بيانات وقاعدة معرفية: عندما يطرح شخص ما سؤالاً، فإن يتحقّق تطبيق Chat من الإجابات التي تمت مشاركتها سابقًا، ثم على مشاركة واحدة. إذا لم يتم العثور على أي إجابة، هذا يعني أنّه لا يمكن الإجابة. في كل إجابة، يمكن للمستخدمين النقر على زر إجراء في الملحق للإشارة باستخدام @إلى مدير مساحة وتوجيه طلب. للعثور على إجابة. من خلال استخدام Gemini AI، يتكيّف تطبيق Google Chat مع تنمو قاعدة معارفها لأنها تتدرب باستمرار على المحادثات في المساحات تمت الإضافة إليه.
في ما يلي طريقة عمل تطبيق Chat في عملية إعداد الموظفين ومساحة الدعم:
-
الشكل 1. يضيف "تشارلي" تطبيق Chat الذي يضم مساعد المعرفة بالذكاء الاصطناعي إلى مساحة 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
- يرسل تطبيق Chat طلبًا لتجديد
للاشتراك من خلال استدعاء طريقة
إزالة تطبيق Chat من Chat مساحة:
يحذف تطبيق Chat الاشتراك من خلال لاستدعاء طريقة
subscriptions.delete
في واجهة برمجة التطبيقات لفعاليات Google Workspaceسيحذف تطبيق Chat Chat بيانات الفضاء من Firestore.
مراجعة المنتجات التي يستخدمها تطبيق Chat لمساعد المعرفة المستنِد إلى الذكاء الاصطناعي
يستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستنِد إلى الذكاء الاصطناعي منتجات Google Workspace وGoogle Cloud التالية:
- Vertex AI API مع Gemini: منصة مستندة إلى الذكاء الاصطناعي التوليدي من Gemini مساعد المعرفة المستنِد إلى الذكاء الاصطناعي يستخدم تطبيق Chat واجهة Vertex AI API مع Gemini لتنفيذ ما يلي: والتعرف على أسئلة الموظف وفهمها والإجابة عليها.
-
واجهة برمجة تطبيقات Chat:
واجهة برمجة تطبيقات لتطوير تطبيقات Google Chat التي تتلقّى
أحداث التفاعل مع المحادثة، مثل الرسائل الذكاء الاصطناعي
يستخدم تطبيق Chat مساعد المعرفة واجهة Chat API لإجراء ما يلي:
- تلقّي أحداث التفاعل المُرسَلة من خلال Chat والردّ عليها
- إدراج الرسائل المُرسَلة في مساحة
- يمكنك نشر الردود على أسئلة المستخدمين في مساحة.
- تهيئة السمات التي تحدد كيفية ظهورها في الدردشة، مثلاً الاسم والصورة الرمزية
- واجهة برمجة التطبيقات لفعاليات Google Workspace: تتيح لك واجهة برمجة التطبيقات هذه الاشتراك في الأحداث وإدارة تغيير الإشعارات في جميع تطبيقات Google Workspace. تشير رسالة الأشكال البيانية يستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستند إلى الذكاء الاصطناعي Google Workspace Events API للاستماع إلى الرسائل المنشورة في مساحة Chat لتتمكّن من رصد الأسئلة والإجابة عنها حتى عندما يكون غير مذكور.
- مخزن إطفاء: قاعدة بيانات مستندات بدون خادم. مساعد المعرفة المستنِد إلى الذكاء الاصطناعي تطبيق Chat يستخدم Firestore لتخزين البيانات حول الرسائل المُرسَلة في "مساحة Chat".
- نشر/اشتراك: النشر/الاشتراك هي خدمة مراسلة غير متزامنة وقابلة للتوسع تفصل الخدمات التي تنتج رسائل من الخدمات التي تعالج هذه الرسائل. تشير رسالة الأشكال البيانية يستخدم تطبيق Chat المزوّد بمساعِد المعرفة المستنِد إلى الذكاء الاصطناعي نشر/اشتراك تلقّي أحداث الاشتراك من مساحات Chat
- Eventarc: تتيح لك Eventarc إنشاء بُنى تستند إلى الأحداث بدون الحاجة إلى تنفيذ أو تخصيص أو صيانة البنية الأساسية غير المجدية. الذكاء الاصطناعي يستخدم تطبيق Chat المساعِد والمساعِد منصة Eventarc توجيه الأحداث من نشر/اشتراك إلى مساحة Chat وظيفة السحابة الإلكترونية التي تتلقّى أحداث الاشتراك وتعالجها
-
الوظائف السحابية:
هي خدمة حوسبة خفيفة بدون خادم تتيح لك إنشاء
وظائف مستقلة لغرض واحد يمكنها الردّ على Chat
أحداث التفاعل والاشتراك بدون الحاجة إلى إدارة خادم أو وقت تشغيل
محددة. تطبيق Chat لمساعد المعرفة المستنِد إلى الذكاء الاصطناعي
تستخدم دالتين من دالات السحابة الإلكترونية المسماة:
-
app
: استضافة نقطة نهاية HTTP التي يرسلها تطبيق Chat أحداث التفاعل مع نظام أساسي للحوسبة ولتشغيل منطق عمليات هذه الأحداث والاستجابة لها. -
eventsApp
: تلقّي "مساحة Chat" ومعالجتها أحداث مثل الرسائل الواردة من خلال اشتراك في خدمة Pub/Sub.
- Cloud Build: منصّة تكامل وتسليم ونشر مستمر مُدارة بالكامل التي تشغِّل إصدارات مبرمَجة
- تشغيل السحابة الإلكترونية: بيئة مُدارة بالكامل لتشغيل التطبيقات المضمّنة في حاويات
-
تحضير البيئة
يعرض هذا القسم كيفية إنشاء مشروع على 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`: استبدِل PROJECT_ID من خلال ضبط رقم تعريف المشروع الذي تريد إنشاءه.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 وGoogle Workspace Events API وEventarc API وCloud Run Admin API.
تأكَّد من تفعيل واجهات برمجة التطبيقات بالشكل الصحيح مشروع على Google Cloud، ثم انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
واجهة سطر الأوامر gcloud
إذا لزم الأمر، اضبط المشروع الحالي على السحابة الإلكترونية على المشروع تاريخ الإنشاء:
gcloud config set project PROJECT_ID
استبدِل PROJECT_ID برقم تعريف المشروع المشروع الذي أنشأته على السحابة الإلكترونية
تفعيل Google Chat API وVertex AI API وCloud Functions API واجهة برمجة تطبيقات Firestore وCloud Build API وPub/Sub API واجهة برمجة تطبيقات أحداث Google Workspace و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.
ضمن معلومات الاتصال بالمطوِّر، أدخِل عنوان بريدك الإلكتروني.
انقر على حفظ ومتابعة.
انقر على إضافة نطاقات أو إزالتها. تظهر لوحة تحتوي على قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعَّلتها في مشروعك على Google Cloud.
ضمن إضافة النطاقات يدويًا، الصِق النطاق التالي:
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: رقم تعريف المشروع للمشروع على Google Cloud قمت بإنشائه.
- REGION: منطقة دالّة السحابة الإلكترونية، مثل
انقر على إنشاء.
من النافذة التي تم إنشاؤها باستخدام عميل OAuth، انقر على تنزيل JSON.
يجب حفظ الملف الذي تم تنزيله باسم
client_secrets.json
. لاحقًا، عند إنشاء وظيفتَي السحابة الإلكترونية، عليك تضمين ملفclient_secrets.json
في كل النشر.انقر على موافق.
إنشاء موضوع النشر/الاشتراك
يعمل موضوع النشر/الاشتراك مع واجهة Google Workspace Events API للاشتراك في الأحداث في Chat المساحة مثل الرسائل وإشعار تطبيق Chat مباشرةً الوقت.
إليك كيفية إنشاء موضوع النشر/الاشتراك:
وحدة التحكّم في Google Cloud
في وحدة التحكّم في Google Cloud، انتقِل إلى قائمة الطعام > النشر/الاشتراك:
انقر على إنشاء موضوع.
في رقم تعريف الموضوع، اكتب
events-api
.ألغِ اختيار إضافة اشتراك تلقائي.
ضمن التشفير، اختَر مفتاح التشفير الذي تديره Google.
انقر على إنشاء. يظهر موضوع النشر/الاشتراك.
لكي يعمل موضوع النشر/الاشتراك هذا وGoogle Workspace Events API معًا، امنح مستخدم إدارة الهوية وإمكانية الوصول في Chat الإذن بالنشر على موضوع النشر/الاشتراك:
في لوحة events-api، ضمن 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 إلى نموذج بيانات متجر النار:
مستندات منظمًا في المجموعات. لمزيد من المعلومات، يُرجى مراجعةيقدّم المخطّط التالي نظرة عامة على مساعد المعرفة المستنِد إلى الذكاء الاصطناعي نموذج بيانات تطبيق 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، انقر على وضع الأصلي.
انقر على متابعة.
اضبط قاعدة البيانات:
في تسمية قاعدة البيانات، اترك معرّف قاعدة البيانات كـ
(default)
.ضمن نوع الموقع الجغرافي، اختَر المنطقة.
في Region، حدِّد منطقة لقاعدة بياناتك، مثل
us-central1
للحصول على أفضل أداء، اختَر المنتج نفسه أو منتجًا قريبًا. الموقع الجغرافي باعتباره دوال Cloud في تطبيق Chat.
انقر على إنشاء قاعدة بيانات.
واجهة سطر الأوامر gcloud
إنشاء قاعدة بيانات Firestore في الوضع الأصلي:
gcloud firestore databases create \ --location=LOCATION \ --type=firestore-native
استبدل LOCATION باسم مخزن إطفاء المنطقة، مثل باسم
us-central1
. للحصول على أفضل أداء، اختَر المنتج نفسه أو منتجًا قريبًا. الموقع الجغرافي باعتباره دوال Cloud في تطبيق Chat.
إنشاء تطبيق Chat ونشره
أصبحت الآن جاهزًا لإنشاء مشروعك على Google Cloud وإعداده. ونشر تطبيق Chat في هذا القسم، يمكنك إجراء التالي:
- إنشاء دالتَين في السحابة الإلكترونية ونشرها مفتاح واحد للردّ على Chat أحداث التفاعل والآخر للرد على أحداث النشر/الاشتراك.
- إنشاء تطبيق في Chat ونشره على Google Chat API صفحة التكوين.
إنشاء دوال Cloud ونشرها
في هذا القسم، يمكنك إنشاء دالتَين من دوال السحابة الإلكترونية ونشرهما وهما:
app
: يستضيف تطبيقات Chat ويديرها رمز برمجي يتجاوب مع الأحداث التي يتم تلقّيها من Chat على أنّها HTTP الطلبات.eventsApp
: تلقّي مساحة Chat ومعالجتها أحداث مثل الرسائل من النشر/الاشتراك
تشكِّل هذه الوظائف المستنِدة إلى السحابة الإلكترونية معًا مساعد المعرفة المستنِد إلى الذكاء الاصطناعي منطق تطبيق تطبيق Chat
قبل إنشاء وظائف السحابة، خصص بعض الوقت لمراجعة فتعرف على نموذج التعليمات البرمجية المستضافة على 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. الملف.يجب أن يحتوي الدليل الجذري للملف المضغوط على ما يلي: الملفات والمجلدات:
.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) المعتمَد لإعادة التوجيه عند CANNOT TRANSLATE تم إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والترخيص. - في نوع المشغِّل، اختر HTTPS.
- ضمن المصادقة، اختَر السماح بالاستدعاءات التي لم تتم مصادقتها
- انقر على التالي.
في وقت التشغيل، اختَر Node.js 20.
في نقطة الإدخال، احذف النص التلقائي وأدخِل
app
في رمز المصدر، اختر تحميل بتنسيق ZIP.
في حزمة الوجهة، إنشاء أو اختَر مجموعة بيانات:
- انقر على تصفّح.
- اختَر مجموعة.
- انقر على اختيار.
تحمِّل Google Cloud ملف ZIP إلى ملفات المكوّنات ويستخرجها في هذه المجموعة. بعد ذلك تنسخ دوال Cloud ملفات المكوّنات إلى لدالة السحابة الإلكترونية.
في ملف Zip، حمِّل ملف ZIP الذي نزّلته من GitHub، ثم استخراجه وإعادة ضغطه:
- انقر على تصفّح.
- انتقل إلى الملف المضغوط وحدده.
- انقر على فتح.
انقر على نشر.
ستفتح صفحة تفاصيل دوال Cloud وتظهر دالتك. من خلال مؤشرين للتقدم: أحدهما للإصدار والآخر للخدمة. عند اختفاء مؤشري التقدّم واستبدالهما بعلامة تحقّق مارك، فإن الدالة تم نشرها وجاهزة.
تحرير نموذج التعليمة البرمجية لتعيين الثوابت:
- في صفحة تفاصيل دالة Cloud، انقر على تعديل.
- انقر على التالي.
- في رمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
وعدِّله:- اضبط قيمة project على رقم تعريف المشروع على السحابة الإلكترونية.
- اضبط قيمة location على قيمة
المنطقة
مثل
us-central1
.
انقر على نشر.
واجهة سطر الأوامر gcloud
استنسِخ الرمز من GitHub:
git clone https://github.com/googleworkspace/google-chat-samples.git
يُرجى التبديل إلى الدليل الذي يحتوي على رمز هذه المعرفة المستنِدة إلى الذكاء الاصطناعي. تطبيق مساعد Google 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 على قيمة
المنطقة، مثل
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) المعتمَد لإعادة التوجيه عند CANNOT TRANSLATE تم إنشاء بيانات اعتماد معرِّف عميل OAuth للمصادقة والترخيص. - في نوع المشغِّل، اختَر Cloud Pub/Sub.
- في موضوع Cloud Pub/Sub، اختَر اسم الموضوع الذي تريده.
تم إنشاؤه، والتي تحتوي على التنسيق
مكان
projects/PROJECT/topics/events-api
PROJECT هو رقم تعريف مشروعك على Google 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
.انقر على ملف ZIP الذي حمّلته.
انقر على اختيار.
انقر على نشر.
ستفتح صفحة تفاصيل دوال Cloud وتظهر دالتك. ثلاثة مؤشرات للتقدم: واحد للإصدار وواحد للخدمة وواحدة للمشغل. عند اختفاء مؤشرات التقدم الثلاثة واستبدالها بعلامة اختيار، فهذا يعني أن الدالة منشورة وجاهزة.
تحرير نموذج التعليمة البرمجية لتعيين الثوابت:
- في صفحة تفاصيل دالة Cloud، انقر على تعديل.
- انقر على التالي.
- في رمز المصدر، اختَر المحرِّر المضمّن.
- في المحرِّر المضمّن، افتح ملف
env.js
وعدِّله:- اضبط قيمة project على رقم تعريف المشروع على السحابة الإلكترونية.
- اضبط قيمة location على قيمة
المنطقة
مثل
us-central1
.
انقر على نشر.
واجهة سطر الأوامر gcloud
في gcloud CLI، إذا لم تكن موجودًا فيه، يُرجى الانتقال إلى الدليل يحمل رمز هذه المعرفة بالذكاء الاصطناعي لتطبيق Google 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 على قيمة
المنطقة، مثل
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
وحدة التحكّم في Google Cloud
في وحدة التحكّم في Google Cloud، انتقِل إلى قائمة الطعام > وظائف السحابة الإلكترونية.
في العمود Name (الاسم) ضمن قائمة Cloud Functions، انقر على
app
انقر على تشغيل.
انسخ عنوان URL.
واجهة سطر الأوامر gcloud
وصف دالة السحابة الإلكترونية
app
:gcloud functions describe app
انسخ السمة
url
.
ضبط تطبيق Chat في وحدة تحكّم Google Cloud
يوضّح هذا القسم كيفية ضبط Chat API في وحدة تحكُّم Google Cloud التي تتضمن معلومات عن تطبيق Chat بما في ذلك اسم تطبيق Chat وعنوان URL لمشغِّل شبكة Cloud في تطبيق Chat الدالة التي يتم إرسال أحداث التفاعل في Chat إليها
في وحدة تحكُّم Google Cloud، انقر على القائمة > مزيد من المنتجات > 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 Function، مثل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 في كل مرة
تطبيق Chat يجيب عن سؤال علاوة على ذلك، فإن الاتصال
list messages
بشكل متكرر يمكن أن يتسبب في
وصول تطبيق Chat إلى الحدّ الأقصى لحصة واجهة برمجة التطبيقات
ومع ذلك، إذا أصبح سجلّ المحادثات في "مساحة Chat" لفترة طويلة جدًا فإن استخدام Firestore قد يكون مكلفًا.
التخزين السحابي كبديل لـ Firestore. سيكون كل مساحة مساعد المعرفة مستنِدًا إلى الذكاء الاصطناعي يكون تطبيق Chat نشطًا في وضع الكائن الخاص به، ويحصل كل عنصر على هو ملف نصي يحتوي على جميع الرسائل في المساحة. تتمثل ميزة هو أنه يمكن إدخال المحتوى الكامل للملف النصي إلى Vertex من استخدام الذكاء الاصطناعي مع Gemini في الوقت نفسه، ولكن العيب هو أنّ الأمر يتطلب تعديل سجلّ المحادثات لأنه لا يمكنك الإلحاق بعنصر في السحابة الإلكترونية يجب استبدال مساحة التخزين فقط. هذا النهج ليس منطقيًا إذا قمت بانتظام لتحديث سجلّ الرسائل، إلا أنّه سيكون خيارًا جيدًا إذا أجريت تحديثًا مجمّعًا سجلّ الرسائل دوريًا، لنفترض مرة واحدة في الأسبوع.
تحديد المشاكل وحلّها
عند تثبيت تطبيق Google Chat أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.
على الرغم من أنه قد لا تظهر رسالة الخطأ في واجهة مستخدم Chat، تتوفر رسائل خطأ وصفية وبيانات السجل لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء لتطبيقات Chat للحصول على مساعدة في العرض، وتصحيح الأخطاء وإصلاح الأخطاء، فراجع تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
- إدارة المشاريع باستخدام Google Chat وVertex AI وFirestore
- الرد على الحوادث باستخدام Google Chat وVertex AI وبرمجة التطبيقات