توضّح هذه الصفحة كيفية إنشاء تطبيق Google Chat الذي يمكنه فهم اللغة الطبيعية والاستجابة لها باستخدام Dialogflow. يستخدم هذا الدليل أداة Dialogflow CX، التي تتيح دمجًا مباشرًا مع Google Chat ومتاحة في إصدار "معاينة المطوِّر". يمكنك أيضًا استخدام Dialogflow ES لإنشاء تطبيق Dialogflow ES مع Google Chat باتّباع دليل Dialogflow ES في Google Chat.
على سبيل المثال، ضع في اعتبارك تطبيق Chat الذي يساعد الأشخاص في استئجار السيارات. قد يكتب أحد المستخدمين، "أرغب في استئجار سيارة". قد يجيب تطبيق Chat بسؤال مثل "أين تريد استلام السيارة؟" الذي يبدأ محادثة تشبه الإنسان مع المستخدم حيث يفهم تطبيق Chat الكلام البشري ويستجيب له أثناء حجز استئجار السيارة.
هذا مجرد مثال واحد. تكون تطبيقات Dialogflow Chat مفيدة في جميع أنواع التفاعلات. إذا كان الأمر يتطلّب كلامًا طبيعيًا، فإنّه يتطلب استخدام تطبيق Chat Dialogflow. وتساعدك برامج الوكيل المُنشأة مسبقًا في البدء بسرعة، وتعرض ما يمكن أن يفعله Dialogflow، مثل:
- حجز رحلات جوية
- تحديد مواعيد الأطباء
- طلب توصيل الطعام
- الإجابة عن أسئلة حول كتالوج منتجات البيع بالتجزئة، مثل ما إذا كانت العناصر متوفرة بألوان أخرى
-
الشكل 2. اختبار الوكيل في Dialogflow CX للتأكّد من أنّ منطق الوكيل وإعداداته تعمل على النحو المطلوب يعرض المخطط مجموعة متسلسلة من الصفحات التي تتناول مواضيع معينة تتعلق بخطوات محددة في المحادثة، مثل تعيين موقع استلام السيارة وإرجاعها، كما يهيئ المنطق الذي يربط بينها. يتم اختبار المحادثة في أحد أجهزة المحاكاة. -
الشكل 3. ضبط تطبيق في Chat لمعالجة الردود باستخدام وكيل Dialogflow CX على صفحة إعداد Chat API في Google Cloud Console -
الشكل 4. إجراء محادثة حول حجز سيارة للاستئجار باستخدام تطبيق Dialogflow Chat في Google Chat
الأهداف
- إعداد البيئة
- إنشاء وكيل Dialogflow CX ونشره.
- يمكنك إنشاء تطبيق في Chat وتفعيله باستخدام وكيل Dialogflow CX.
- اختبِر تطبيق Chat.
المتطلبات الأساسية
- حساب على Google Workspace يمكنه الوصول إلى Google Chat
- مشروع على Google Cloud:
- تأكَّد من تفعيل الفوترة لمشروعك على Google Cloud. تعرَّف على كيفية التحقّق من حالة الفوترة لمشاريعك.
هندسة معمارية
يوضّح المخطّط التالي بنية تطبيق Chat تم إنشاؤه باستخدام Dialogflow:
في المخطّط البياني السابق، يتضمّن المستخدِم الذي يتفاعل مع تطبيق Dialogflow Chat تدفق المعلومات التالي:
- يرسل المستخدم رسالة في Chat إلى تطبيق Chat، إما في رسالة مباشرة أو في مساحة Chat.
- ويتلقّى موظّف الدعم الافتراضي في Dialogflow، المتوفر في Google Cloud، الرسالة ويعالجها لإنشاء ردّ.
- اختياريًا، باستخدام الرد التلقائي على الويب في Dialogflow، يمكن لوكيل Dialogflow التفاعل مع الخدمات الخارجية التابعة لجهات خارجية، مثل نظام إدارة المشاريع أو أداة إصدار التذاكر.
- يرسل وكيل Dialogflow ردًا إلى خدمة تطبيق Chat في Chat.
- يتم تسليم الرد إلى "مساحة Chat".
إعداد البيئة
قبل استخدام Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في وحدة تحكُّم Google Cloud، فعِّل Google Chat API وDialogflow API.
تأكَّد من تفعيل واجهات برمجة التطبيقات في المشروع الصحيح على السحابة الإلكترونية، ثم انقر على التالي.
تأكّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
إنشاء وكيل Dialogflow CX
وكيل Dialogflow CX هو وكيل افتراضي يعالج المحادثات المتزامنة مع المستخدمين النهائيين. إنها وحدة لفهم اللغة الطبيعية والتي تفهم الفروق الدقيقة في اللغة البشرية. يترجم Dialogflow نص المستخدم أثناء المحادثة إلى بيانات منظَّمة يمكن لتطبيقاتك وخدماتك فهمها. تقوم بتصميم وبناء وكيل Dialogflow للتعامل مع أنواع المحادثات المطلوبة لنظامك.
إنّ وكيل Dialogflow مثل موظّف دعم مركز اتصالات. فأنت تقوم بتدريبهم كليهما على التعامل مع سيناريوهات المحادثة المتوقعة، ولا يلزم أن يكون تدريبك واضحًا جدًا.
إليك طريقة إنشاء وكيل Dialogflow CX:
في وحدة تحكم Dialogflow CX، افتح وحدة تحكم Dialogflow CX. انقر على القائمة > Dialogflow CX.
اختَر مشروعًا على Google Cloud. للعثور على مشروعك، قد تحتاج إلى النقر على الكل ثم البحث عنه.
الآن لديك خيار اختيار وكيل مسبق الإنشاء أو إنشاء وكيلك الخاص. إذا كنت تفضِّل استكشاف ميزة تخصيص الوكلاء بالتفصيل لاحقًا، اختَر أحد برامج الوكيل المُنشأة مسبقًا، ومن المفيد أيضًا معرفة المهام التي يمكن لموظّفي الدعم تنفيذها.
لاختيار وكيل مسبق الإنشاء، يُرجى اتّباع الخطوات التالية:
- انقر على استخدام برامج وكيلة مُنشأة مسبقًا.
اختَر وكيلاً تم إنشاؤه مسبقًا. في هذا الدليل، اختَر السفر: تأجير السيارات.
يتم تصنيف موظّفي الدعم على أنهم مبتدئون أو متوسطون أو متقدمون استنادًا إلى عدد الميزات التي يستخدمها الوكيل وإلى مدى تطوّر منطق المحادثات. قد يتطلب اختيار وكيل متوسّط أو متقدم إجراء عمليات تخصيص وإعدادات خاصة بالوكيل، بما في ذلك تفعيل الميزات وواجهات برمجة التطبيقات في Google Cloud Console.
انقر على استيراد كوكيل.
لإنشاء وكيلك الخاص، يُرجى اتّباع الخطوات التالية:
- انقر على إنشاء وكيل.
- اختَر إنشاء تلقائي لإنشاء وكيل تخزين بيانات أو اختَر إنشاء برامجك الخاصة لإنشاء أنواع أخرى من برامج الوكلاء.
للحصول على جولة تفصيلية حول عملية إنشاء الوكيل، راجِع إنشاء وكيل Dialogflow CX.
ضبط إعدادات الوكيل الأساسية:
- في الاسم المعروض، أدخِل الاسم المعروض.
- اختَر موقعك الجغرافي المفضّل. إذا أردت تغيير إعدادات الموقع الجغرافي المتقدمة، انقر على تعديل.
- اختَر منطقتك الزمنية المفضّلة.
- اختَر اللغة التلقائية لوكيلك. لا يمكنك تغيير اللغة التلقائية لأي وكيل بعد إنشاء الملف الشخصي.
انقر على إنشاء. يبدأ Dialogflow CX في إنشاء الوكيل، ثم يعرض تدفق البدء الافتراضي للوكيل.
يمكنك تخصيص الوكيل إذا أردت. للحصول على جولة تفصيلية حول عملية تخصيص الوكلاء، يُرجى الاطّلاع على إنشاء وكيل Dialogflow CX.
ننصحك باختبار الوكيل وفقًا لأفضل الممارسات:
- انقر على وكيل تجريبي.
- اختَر وكيل اختبار في البيئة.
- في البيئة، اختَر مسودة.
- في التدفق، اختر تدفق البدء التلقائي.
- في "الصفحة"، اختَر الصفحة الرئيسية.
- في خانة إدخال المحتوى في التحدث إلى موظّف الدعم، اكتب
Hello
واضغط على مفتاح Enter. يجيب الوكيل من خلال تقديم نفسه. - أكمل الاختبار من خلال إجراء نموذج لمحادثة تجريبية.
يتم إنشاء وكيل Dialogflow CX. ارجِع إلى وحدة تحكُّم Dialogflow CX. انقر على رمز القائمة > Dialogflow CX.
ضمن الوكلاء، انقر على > نسخ الاسم. احفظ هذا الاسم، كما تستخدمه عند ضبط تطبيق Chat.
إنشاء تطبيق في Chat وربطه بوكيل Dialogflow
بعد إنشاء وكيل Dialogflow CX، اتّبِع الخطوات التالية لتحويله إلى تطبيق Chat:
في Google Cloud Console، انتقِل إلى Google Chat API. ابحث عن "Google Chat API" وانقر على Google Chat API، ثم انقر على إدارة.
انقر على الإعدادات واضبط تطبيق Chat:
- في اسم التطبيق، أدخِل
Dialogflow App
. - في عنوان URL للصورة الرمزية، أدخِل
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
. - في الوصف، أدخِل
Responds to real human conversation
. - ضمن الوظائف، اختَر تلقّي رسائل بين شخصَين والانضمام إلى المساحات والمحادثات الجماعية.
- ضِمن إعدادات الربط، اختَر Dialogflow.
- ضِمن إعدادات Dialogflow، اختَر Dialogflow CX.
- في اسم مورد الوكيل أو البيئة، الصِق اسم وكيل Dialogflow CX الذي نسخته في نهاية إنشاء وكيل Dialogflow CX.
- يمكنك إتاحة تطبيق Chat هذا لمستخدمين محدَّدين ومجموعات محدّدة في نطاقك وإدخال عنوان بريدك الإلكتروني.
- ضمن السجلات، اختَر تسجيل الأخطاء إلى التسجيل.
- في اسم التطبيق، أدخِل
انقر على حفظ.
أصبح تطبيق Chat جاهزًا لتلقّي الرسائل من خلال Chat والردّ عليها.
اختبار تطبيق Chat
اختبِر تطبيق Dialogflow CX Chat من خلال مراسلته في Google Chat.
افتح Google Chat باستخدام حساب Google Workspace الذي قدّمته عندما أضفت نفسك كمختبِر موثوق به.
- انقر على محادثة جديدة.
- في الحقل إضافة مستخدم واحد أو أكثر، اكتب اسم تطبيق Chat.
اختَر تطبيق Chat من النتائج. وسيتم فتح رسالة مباشرة.
في الرسالة المباشرة الجديدة مع التطبيق، اكتب
Hello
واضغط علىenter
.يستجيب تطبيق Dialogflow Chat بتقديم نفسه.
- أكمل الاختبار من خلال إجراء نموذج للمحادثة التجريبية.
نموذج لمحادثة تجريبية
لاختبار تطبيق Dialogflow CX Chat في وحدة تحكُّم Dialogflow CX أو في Google Chat، عليك إجراء المحادثة التالية. يساعدك الشرح في فهم كيفية تفسير وكيل Dialogflow CX للغة المستخدم الطبيعية ويُنتج ردوده باللغة الطبيعية في كل خطوة من خطوات المحادثة. يستند نموذج المحادثة هذا إلى وكيل مُعد مسبقًا يُسمّى السفر: تأجير السيارات.
Dialog | الشرح |
---|---|
المستخدم النهائي: مرحبًا الوكيل: مرحبًا، أنا وكيل تأجير السيارات الافتراضية. يمكنني مساعدتك في بدء حجز جديد لاستئجار سيارة. كيف يمكنني مساعدتك اليوم؟ |
|
المستخدم النهائي: أرغب في استئجار سيارة. موظّف الدعم: أين تريد استلام المركبة؟ |
|
المستخدم النهائي: لاس فيغاس موظّف الدعم: حسنًا، سيتم استلام الطلب في لاس فيغاس. موظّف الدعم: هل يختلف الموقع الجغرافي لنقطة التسليم عن الموقع الجغرافي لاستلام الطلب؟ |
|
المستخدم النهائي: نعم. سأترك السيارة في لوس أنجلوس. موظّف الدعم: حسنًا، سيكون التسليم في لوس أنجلوس. موظّف الدعم: في أي تاريخ ووقت مطلوب استلام المركبة؟ |
|
المستخدم النهائي: أرغب في استلام السيارة يوم 5 آذار (مارس) ظهرًا. موظّف الدعم: ما هو التاريخ والوقت المطلوبان لتسليم المركبة؟ |
|
المستخدم النهائي: 15 آذار (مارس) ظهرًا. موظّف الدعم: للتأكيد: سيتم استلام المركبة في لاس فيغاس 2024-03-05 12:00:00 وسلّمها في لوس أنجلوس 15-03-2024 12:00: هل هذا صحيح؟ |
|
المستخدم النهائي: نعم، شكرًا لك. موظّف الدعم: رائع. الآن، دعنا نختار مركبة. العميل: هل تبحث عن سيارة اقتصادية أم فاخرة؟ |
|
المستخدم النهائي: بالاقتصاد، من فضلك. موظّف الدعم: هل تريد سيارة Cymbal أم شاحنة Cymbal؟ |
|
المستخدم النهائي: شاحنة Cymbal. موظّف الدعم: تبلغ تكلفة شاحنة Cymbal $50.33 في اليوم. يتسع هذا الجهاز لأربعة أشخاص، كما أنّه يأتي مع راديو AM/FM. هل تريد المتابعة إلى عملية الدفع؟ المستخدم النهائي: نعم، من فضلك. |
|
موظّف الدعم: ما هو نوع البطاقة التي ستستخدمها؟ المستخدم النهائي: Altostrat الوكيل: يُرجى إدخال رقم البطاقة. المستخدم النهائي: 1234 1234 1234 موظّف الدعم: ما الاسم الظاهر على البطاقة؟ المستخدم النهائي: تامر الموظف: ما هو عنوان شارع الفوترة؟ المستخدم النهائي: 1800 Amphibious Blvd. Mountain View, CA Agent: ما هو الرمز البريدي للفوترة؟ المستخدم النهائي: 94045 موظّف الدعم: في موعد استلام سيارة Cymbal في لاس فيغاس، 2024-03-05 عند الساعة 12:00:00 بعد الظهر وتسليمها في 15-03-2024 الساعة 12:00:00. سيبلغ السعر الإجمالي لهذه الرحلة $175.38. موظّف الدعم: نشكرك على الاستئجار معنا ونتمنّى لك يومًا رائعًا. |
|
إرسال رسائل بطاقة من Dialogflow
يمكن أن يردّ Dialogflow برسائل نصية أو بطاقة. للرد برسالة بطاقة، حددها على أنها حمولة مخصصة في التنفيذ.
يوضّح ملف JSON التالي كيفية إرسال رسالة بطاقة كحمولة بيانات مخصّصة في التنفيذ:
json
{
'cardsV2': [{
'cardId': 'createCardMessage',
'card': {
'header': {
'title': 'A card message!',
'subtitle': 'Sent from Dialogflow',
'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png',
'imageType': 'CIRCLE'
},
'sections': [
{
'widgets': [
{
'buttonList': {
'buttons': [
{
'text': 'Read the docs!',
'onClick': {
'openLink': {
'url': 'https://developers.google.com/workspace/chat'
}
}
}
]
}
}
]
}
]
}
}]
}
الحدود والاعتبارات
- تحصل أحداث التفاعل مع المحادثة
على دعم محدود وبعض الاعتبارات التالية:
- إنّ أنواع أحداث التفاعل
التالية المتاحة:
MESSAGE
ADDED_TO_SPACE
- يتوافق إدخال طلب البحث المُرسَل إلى وكيل Dialogflow مع قيمة
حقل
argumentText
في رسالة Chat. إذا كانت الرسالة تتضمن أمرًا بشرطة مائلة، سيتم استخدام قيمة الحقلtext
بدلاً من ذلك. - ويتم إرسال حمولة JSON الكاملة لكل حدث تفاعل في Chat إلى Dialogflow كحمولة بيانات مخصَّصة في مَعلمة طلب البحث، ويمكن الوصول إليها باستخدام
Dialogflow للردّ التلقائي على الويب
من خلال طلب البحث عن قيمة الحقل
WebhookRequest.payload
.
- إنّ أنواع أحداث التفاعل
التالية المتاحة:
- يُسمح باستخدام الأوامر التي تبدأ بشرطة مائلة بشكل محدود:
- إن أوامر Slash التي تفتح مربعات الحوار لا تتوافق مع تطبيقات Dialogflow Chat.
- عندما تتلقّى تطبيقات Chat من Dialogflow رسالة تتضمّن طلبًا بشرطة مائلة،
لا يتضمّن إدخال طلب البحث سوى قيمة الحقل
text
. يبدأ الحقلtext
باسم الأمر الذي يستخدم الشرطة المائلة (على سبيل المثال،/command
)، والذي يمكنك استخدامه لضبط الغرض من وكيل Dialogflow لرصد الأمر الذي يبدأ بشرطة مائلة. - إذا كان وكيل Dialogflow يحتاج إلى معالجة حمولة JSON لحدث التفاعل مع الأمر slash، يمكنه إجراء ذلك باستخدام ردّ تلقائي على Dialogflow لفحص الحمولة المخصّصة في مَعلمة طلب البحث.
- معاينات الروابط غير متاحة.
- في حال استجابة وكيل Dialogflow برسالة واحدة فقط، سيتم
إرسال الرسالة إلى Google Chat بشكل متزامن. في حال كان وكيل Dialogflow
يستجيب برسائل متعددة، سيتم إرسال جميع الرسائل إلى Chat
بشكل غير متزامن من خلال طلب الإجراء
create
على موردspaces.messages
في Chat API مرة واحدة لكل رسالة.
تحديد المشاكل وحلّها
عندما يعرض أحد تطبيقات Google Chat أو بطاقة رسالة خطأ، تعرض واجهة Chat رسالة مفادها "حدث خطأ" أو "تعذّرت معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن يعرض تطبيق Chat أو البطاقة نتيجة غير متوقعة. على سبيل المثال، قد لا تظهر رسالة بطاقة.
على الرغم من أنّه قد لا تظهر رسالة الخطأ في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة في عرض الأخطاء وتصحيحها وتصحيحها، يُرجى الاطّلاع على مقالة تحديد وحلّ مشاكل Google Chat.
تَنظيم
لتجنّب دفع رسوم من حسابك على Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، ننصحك بحذف المشروع على Google Cloud.
- في Google Cloud Console، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب معرّف المشروع، ثم انقر على إيقاف التشغيل لحذف المشروع.
مواضيع ذات صلة
- يتّبع Dialogflow CX منهجًا
لآلة الحالة
إلى تصميم وكيل Dialogflow،
ما يمنحك تحكمًا واضحًا وصريحًا
في المحادثة، وتجربة أفضل للمستخدم النهائي،
وسير عمل أفضل لتطوير البرامج. عند إنشاء تطبيق Dialogflow
Chat، ننصح باستخدام Dialogflow CX.
- لمزيد من المعلومات حول إنشاء الوكلاء وإعدادهم، يمكنك الاطّلاع على وكلاء Dialogflow CX.
- للحصول على جولة تفصيلية إرشادية حول كيفية إنشاء الوكلاء وإعدادهم، يمكنك الاطّلاع على إنشاء وكيل Dialogflow CX.
- Dialogflow ES هي طريقة أخرى لاستخدام Dialogflow مع تطبيق Chat.