توضّح هذه الصفحة كيفية إنشاء تطبيق Google Chat يمكنه فهم المحتوى والاستجابة له باستخدام لغة طبيعية باستخدام Dialogflow. يستخدم هذا الدليل Dialogflow CX، الذي يتكامل مباشرةً مع Google Chat. يمكنك أيضًا استخدام Dialogflow ES لإنشاء تطبيق Dialogflow ES Google Chat من خلال اتّباع دليل Dialogflow ES Google Chat.
على سبيل المثال، ضع في اعتبارك تطبيق Chat الذي يساعد الأشخاص في استئجار السيارات. قد يكتب مستخدم ما يلي: "أريد استئجار سيارة". وقد يجيب تطبيق Chat بسؤال مثل "من أين تريد استلام المركبة؟" ويبدأ تطبيق محادثة مع المستخدم بفهم الكلام البشري والرد عليه أثناء حجز السيارة.
هذا مثال واحد فقط. تكون تطبيقات Dialogflow مفيدة في جميع أنواع التفاعلات. إذا كانت تتطلب كلامًا بشري طبيعيًا، فإنّها تتطلب استخدام تطبيق Dialogflow Chat. يساعدك الوكلاء المُنشأون مسبقًا في البدء بسرعة، وعرض ما يمكن أن يفعله 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 Console، فعِّل واجهة برمجة التطبيقات Google Chat وواجهة برمجة تطبيقات Dialogflow.
تأكَّد من تفعيل واجهات برمجة التطبيقات في مشروع Cloud الصحيح، ثمّ انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
إنشاء وكيل 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 تطبيق الإجابة عن نفسه.
- أكمل الاختبار من خلال إجراء نموذج المحادثة التجريبية.
نموذج لمحادثة تجريبية
لاختبار تطبيق Dialogflow CX Chat في وحدة تحكّم Dialogflow CX أو في Google Chat، يُرجى إجراء المحادثة التالية. يساعدك الشرح في فهم طريقة تفسير وكيل Dialogflow CX للغة المستخدم الطبيعية وتقديم إجاباته باللغة الطبيعية في كل خطوة من المحادثة. يستند نموذج المحادثة هذا إلى وكيل مُعدّ مسبقًا يُسمّى السفر: تأجير السيارات.
مربّع حوار | الشرح |
---|---|
المستخدم النهائي: مرحبًا موظّف الدعم: مرحبًا. أنا وكيل تأجير السيارات الافتراضي. يمكنني مساعدتك في بدء حجز جديد لاستئجار السيارة. كيف يمكننا مساعدتك اليوم؟ |
|
المستخدم النهائي: أريد استئجار سيارة. موظّف الدعم: أين تريد استلام المركبة؟ |
|
المستخدم النهائي: لاس فيغاس موظّف الدعم: حسنًا، ستكون عملية الاستلام في لاس فيغاس. موظّف الدعم: هل يختلف موقع التسليم عن الموقع الجغرافي الذي سيتم استلامه منه؟ |
|
المستخدم النهائي: نعم. سَأُرْسِلُ السَّيَّارَة فِي لوس أنجلوس. موظّف الدعم: حسنًا، سيكون موعد التسليم في لوس أنجلوس. موظّف الدعم: ما هو التاريخ والوقت المطلوبان لاستلام المركبة؟ |
|
المستخدم النهائي: أريد استلام السيارة في 5 آذار (مارس) ظهرًا. موظّف الدعم: ما هو تاريخ ووقت تسليم المركبة؟ |
|
المستخدم النهائي: 15 آذار (مارس) ظهرًا. موظّف الدعم: للتأكّد: سيتم استلام المركبة في لاس فيغاس 2024-03-05 الساعة 12:00:00 وتسليمها في لوس أنجلوس 15-03-2024 الساعة 12:00:00 هل هذا صحيح؟ |
|
المستخدم النهائي: نعم، شكرًا لك. موظّف الدعم: رائع. الآن لنختر مركبة. موظّف الدعم: هل يهمّك الحصول على مركبة اقتصادية أم فاخرة؟ |
|
المستخدم النهائي: إذا كان سعره اقتصاديًا، موظّف الدعم: هل تريد الحصول على سيارة Cymbal أم شاحنة Cymbal؟ |
|
المستخدم النهائي: شاحنة Cymbal. موظّف الدعم: تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم. وتتّسع هذه الميزة لأربعة أشخاص وتضم راديو AM/FM. هل تريد المتابعة للدفع؟ المستخدم النهائي: نعم، يُرجى. |
|
موظّف الدعم: ما هو نوع البطاقة التي ستستخدمها؟ المستخدم النهائي: Altostrat موظّف الدعم: يُرجى إدخال رقم البطاقة. المستخدم النهائي: 1234 1234 1234 1234 موظّف الدعم: ما هو الاسم الوارد في البطاقة؟ المستخدم النهائي: تشارلي موظّف الدعم: ما هو عنوان شارع إرسال الفواتير؟ المستخدم النهائي: 1800 Amphibious Blvd. Mountain View, CA Agent: ما هو الرمز البريدي للفوترة؟ المستخدم النهائي: 94045 موظّف الدعم: سيكون عليك استلام سيارة Cymbal في لاس فيغاس بتاريخ 05-03-2024 في الساعة 12:00:00 والتسليم، من الساعة 12:00 إلى الساعة 15-03-2024. سيبلغ إجمالي تكلفة هذه الرحلة 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
CARD_CLICKED
- بالنسبة إلى أحداث
MESSAGE
أوADDED_TO_SPACE
، يتوافق إدخال طلب البحث الذي تم إرساله إلى وكيل Dialogflow مع قيمة الحقلargumentText
في رسالة Chat. إذا تضمّنت الرسالة أمرًا بشرطة مائلة، يتم استخدام قيمة الحقلtext
بدلاً من ذلك. - بالنسبة إلى أحداث
CARD_CLICKED
، يتم تنسيق إدخال طلب البحث المُرسَل إلى وكيل Dialogflow كـCARD_CLICKED.functionName
، حيث يتجاوبfunctionName
مع قيمة الحقلfunction
للكائن الإجراء المرتبط بعنصر البطاقة التفاعلية (مثل زر). - يتم إرسال حمولة JSON الكاملة لكل حدث تفاعل في Chat إلى Dialogflow كحمولة مخصّصة في معلَمة طلب البحث،
ويمكن الوصول إليه باستخدام
Dialogflow webhook
عن طريق الاستعلام عن قيمة الحقل
WebhookRequest.payload
.
- تتوفّر أنواع أحداث التفاعل التالية:
- يجب مراعاة الاستجابة للأوامر التي تبدأ بشرطة مائلة وتلقّي البيانات من البطاقات أو مربّعات الحوار:
- عندما تتلقّى تطبيقات Dialogflow Chat رسالة تحتوي على أمر شرطة مائلة،
يحتوي إدخال طلب البحث فقط على قيمة الحقل
text
. يبدأ الحقلtext
باسم الأمر الشرطة المائلة (على سبيل المثال،/command
)، والذي يمكنك استخدامه لضبط هدف وكيل Dialogflow لاكتشاف الأمر الذي يبدأ بشرطة مائلة. - إذا كان موظّف الدعم في Dialogflow يحتاج إلى معالجة حمولة JSON لحدث التفاعل في Chat، يمكنه إجراء ذلك باستخدام الردّ التلقائي على الويب Dialogflow لفحص الحمولة المخصّصة في معلَمة طلب البحث.
- لعرض مربع حوار من وكيل Dialogflow، يمكنك الردّ باستخدام حمولة JSON أساسية واحدة
تتضمّن رسالة تحتوي على
DIALOG
استجابة للإجراء. - لمعالجة البيانات التي يتم إدخالها من البطاقات، يمكن لوكيل Dialogflow اكتشاف
النية التي تبدأ بالنص
CARD_CLICKED
والتعامل مع حمولة JSON مخصّصة واحدة تحتوي على الإجراء المناسب.
- عندما تتلقّى تطبيقات Dialogflow Chat رسالة تحتوي على أمر شرطة مائلة،
يحتوي إدخال طلب البحث فقط على قيمة الحقل
- لا تتوفّر معاينات الروابط.
- إذا استجاب وكيل Dialogflow برسالة واحدة فقط، سيتم إرسال الرسالة
إلى Google Chat بشكل متزامن. إذا استجاب وكيل Dialogflow
برسائل متعددة، سيتم إرسال جميع الرسائل إلى
Chat بشكل غير متزامن من خلال استدعاء الطريقة
create
في موردspaces.messages
في Chat API مرة واحدة لكل رسالة. - عند استخدام عملية دمج Dialogflow CX مع Chat، يجب إعداد وكيل Dialogflow وتطبيق Chat في مشروع Google Cloud نفسه. إذا كنت بحاجة إلى إعداد Dialogflow وChat في مشاريع مختلفة على Cloud، يمكنك إعداد خادم وسيط لتسهيل الاتصال. للتعرّف على كيفية إجراء ذلك، يمكنك الاطّلاع على مثال على دمج Chat مع Dialogflow CX على GitHub.
تحديد المشاكل وحلّها
عندما يعرض تطبيق أو بطاقة Google Chat رسالة خطأ، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا تعرض واجهة مستخدم Chat أي رسالة خطأ، ولكن يعرض تطبيق Chat أو بطاقة بياناته نتيجة غير متوقعة، على سبيل المثال، قد لا تظهر رسالة بطاقة.
على الرغم من أنّ رسالة الخطأ قد لا تظهر في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة بشأن الاطّلاع على الأخطاء وتصحيحها وتصحيحها، راجِع تحديد المشاكل في Google Chat وحلّها.
تَنظيم
لتجنُّب تحمُّل أي رسوم من حسابك على Google Cloud مقابل الموارد المستخدَمة في هذا الدليل التوجيهي، ننصحك بحذف المشروع على Google Cloud.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف التشغيل لحذف المشروع.
مواضيع ذات صلة
- تستخدم Dialogflow CX نهجًا من آلة حكومية لتصميم وكيل Dialogflow، ما يمنحك تحكُّمًا واضحًا وصريحًا في المحادثة، ويساهم في تحسين تجربة المستخدم النهائي،
وسير عمل أفضل للتطوير. عند إنشاء تطبيق Dialogflow
Chat، ننصحك باستخدام Dialogflow CX.
- لمزيد من المعلومات حول إنشاء الوكلاء وضبطهم، يمكنك الاطّلاع على وكلاء Dialogflow CX.
- للحصول على جولة تفصيلية تشرح كيفية إنشاء الوكلاء وضبطهم، يمكنك الاطّلاع على إنشاء وكيل Dialogflow CX.
- إنشاء تطبيقات لـ Google Chat باستخدام Gemini. درس تطبيقي حول الترميز: للاطّلاع على مثال حول كيفية إنشاء وكيل تخزين بيانات Dialogflow CX، يمكنك الانتقال إلى تطبيق Chat للمعلومات من خلال الدرس التطبيقي حول الترميز
- إنشاء تطبيقات متوافقة مع Google Chat باستخدام Gemini. درس تطبيقي حول الترميز: للاطّلاع على مثال حول كيفية إنشاء وكيل محادثات Dialogflow CX، يمكنك الانتقال إلى قسم الملاحظات والآراء في تطبيق Chat من الدرس التطبيقي حول الترميز
- Dialogflow ES هي طريقة أخرى لاستخدام Dialogflow مع تطبيق Chat.