توضّح هذه الصفحة كيفية إنشاء تطبيق Google Chat يمكنه تنفيذ كلا الإجراءَين. والفهم والاستجابة بلغة طبيعية باستخدام Dialogflow. يستخدم هذا الدليل Dialogflow CX، الذي يتميز تكامل مباشر مع Google Chat. يمكنك أيضًا استخدام Dialogflow ES لإنشاء تطبيق Dialogflow ES Google Chat من خلال المتابعة الـ Dialogflow ES Google Chat الدليل.
على سبيل المثال، ننصحك باستخدام تطبيق Chat يساعد المستخدمين في استئجار. السيارات. قد يكتب مستخدم ما يلي: "أريد استئجار سيارة". تشير رسالة الأشكال البيانية قد يجيب تطبيق Chat بسؤال مثل "أين ترغب في استلام المركبة؟" والذي يطلق على شكل إنسان محادثة مع المستخدم، حيث يتم استخدام تطبيق Chat يفهم ويستجيب بالكلام البشري أثناء حجز تأجير السيارة.
هذا مثال واحد فقط. تطبيقات Dialogflow Chat مفيدة في جميع وأنواع التفاعلات. وإذا كان يتطلب كلامًا بشري طبيعيًا، فإنه يتطلب تطبيق Dialogflow في المحادثة تشير رسالة الأشكال البيانية وكلاء تم إنشاؤهم مسبقًا لمساعدتك في البدء بسرعة، وعرض المهام التي يمكن أن تنفّذها منصة Dialogflow، مثل:
- حجز رحلات جوية
- تحديد مواعيد مع الأطباء
- طلب توصيل الطعام
- الإجابة عن أسئلة حول كتالوج منتجات البيع بالتجزئة، مثل ما إذا كانت السلع متوفرة بألوان أخرى
-
الشكل 1. اختيار وكيل مُعَدّ مسبقًا لتطبيق Dialogflow Chat. -
الشكل 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.
تأكَّد من تفعيل واجهات برمجة التطبيقات بالشكل الصحيح مشروع على Google Cloud، ثم انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.
إنشاء وكيل Dialogflow CX
حاسمة وكيل Dialogflow CX هو وكيل افتراضي يعالج المحادثات المتزامنة مع المستخدمين النهائيين. إنها وحدة فهم اللغة الطبيعية يفهم الفروقات الدقيقة للغة الإنسان. يترجم Dialogflow نص المستخدم النهائي خلال محادثة مع البيانات المنظَّمة التي تستخدمها تطبيقاتك وخدماتك فهمها. يمكنك تصميم وإنشاء وكيل Dialogflow للتعامل مع أنواع عدد المحادثات المطلوبة لنظامك.
يشبه وكيل Dialogflow وكيل مركز الاتصال البشري. أنت تدرّبهما معًا للتعامل مع سيناريوهات المحادثة المتوقعة، ولا يحتاج تدريبك إلى شديدة الصراحة.
إليك كيفية إنشاء وكيل Dialogflow CX:
في وحدة تحكّم Dialogflow CX، افتح وحدة التحكّم Dialogflow CX. (يُرجى النقر.) قائمة الطعام > Dialogflow CX.
اختَر مشروعًا على Google Cloud. للعثور على مشروعك، قد تحتاج إلى انقر على الكل ثم ابحث عنه.
لديك الآن خيار اختيار وكيل معد مسبقًا أو إنشاء مجموعتك الخاصة. إذا أردت الاطّلاع على معلومات موظّف دعم التخصيص بالتفصيل لاحقًا، اختر أحد وبرامج ضارة تم إنشاؤها مسبقًا وهي مفيدة أيضًا لمعرفة ما يمكن أن يفعله موظّفو الدعم.
لاختيار وكيل مُعَدّ مسبقًا، اتّبِع الخطوات التالية:
- انقر على استخدام برامج وكيلة مُعَدّة مسبقًا.
اختَر وكيلاً تم إنشاؤه مسبقًا. بالنسبة إلى هذا الدليل، اختَر سفر: تأجير السيارات.
تم تصنيف الوكلاء على أنّهم مبتدئون، أو متوسط أو متقدم بناءً على عدد الميزات التي يستخدمها الوكيل وبناءً على تعقيد منطق المحادثات لديها. يتيح لك اختيار قد يطلب منك وكيل متوسّط أو متقدّم التخصيصات والإعدادات، بما في ذلك تفعيل الميزات وواجهات برمجة التطبيقات في وحدة تحكُّم Google Cloud.
انقر على استيراد كوكيل.
لإنشاء الوكيل الخاص بك، اتّبِع الخطوات التالية:
- انقر على إنشاء وكيل.
- اختَر إنشاء تلقائي لإنشاء وكيل تخزين بيانات أو اختَر إنشاء موظّفي الدعم الخاص بك لإنشاء أنواع أخرى من الوكلاء.
للحصول على جولة تفصيلية حول عملية إنشاء موظفي الدعم، يمكنك الاطّلاع على إنشاء وكيل 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 اللغة الطبيعية للمستخدم وتُنتج ردوده اللغوية الطبيعية في كل خطوة في المحادثة. يعتمد نموذج المحادثة هذا على وكيل مسبق الإعداد تسمى السفر: تأجير السيارات.
مربّع حوار | الشرح |
---|---|
المستخدم النهائي: مرحبًا موظّف الدعم: مرحبًا، أنا وكيل تأجير السيارات الافتراضي. يمكنني في بدء حجز جديد لتأجير السيارات. كيف يمكنني تقديم المساعدة؟ معك اليوم؟ |
|
المستخدم النهائي: أريد استئجار سيارة. موظّف الدعم: أين تريد استلام المركبة؟ |
|
المستخدم النهائي: لاس فيغاس موظّف الدعم: حسنًا، سيتم استلام الطلب في لاس فيغاس. موظّف الدعم: هل يختلف موقع التسليم عن الخاص بك موقع الاستلام؟ |
|
المستخدم النهائي: نعم. سَأُرْسِلُ السَّيَّارَة فِي لوس أنجلوس. موظّف الدعم: حسنًا، سيكون موعد التسليم في لوس أنجلوس. موظّف الدعم: ما هو التاريخ والوقت المناسبان لاستلام المركبة؟ |
|
المستخدم النهائي: أريد استلام السيارة في 5 آذار (مارس) ظهرًا. موظّف الدعم: ما هو تاريخ ووقت تسليم المركبة؟ |
|
المستخدم النهائي: 15 آذار (مارس) ظهرًا. موظّف الدعم: يُرجى العِلم بما يلي: ستستلم المركبة خلال لاس فيغاس موعد التسليم النهائي هو 2024-03-05 الساعة 12:00:00 في لوس أنجلوس 2024-03-15 12:00:00 هل هذا صحيح؟ |
|
المستخدم النهائي: نعم، شكرًا لك. موظّف الدعم: رائع. الآن لنختر مركبة. موظّف الدعم: هل تريد توفير وسائل اقتصادية أم فاخرة؟ المركبة؟ |
|
المستخدم النهائي: إذا كان سعره اقتصاديًا، موظّف الدعم: هل تريد شراء سيارة Cymbal أم شاحنة Cymbal؟ |
|
المستخدم النهائي: شاحنة Cymbal. موظّف الدعم: تبلغ تكلفة شاحنة Cymbal 50.33 دولار أمريكي في اليوم. وتتّسع هذه الميزة لأربعة أشخاص وتضم راديو AM/FM. هل تريد المتابعة للدفع؟ المستخدم النهائي: نعم، من فضلك. |
|
موظّف الدعم: ما هو نوع البطاقة التي ستستخدمها؟ المستخدم النهائي: Altostrat موظّف الدعم: يُرجى إدخال رقم البطاقة. المستخدم النهائي: 1234 1234 1234 1234 موظّف الدعم: ما هو الاسم الظاهر على البطاقة؟ المستخدم النهائي: تشارلي موظّف الدعم: ما هو عنوان شارع إرسال الفواتير؟ المستخدم النهائي: 1800 شارع برمائي ماونتن فيو، كاليفورنيا موظّف الدعم: ما هو الرمز البريدي للفوترة؟ المستخدم النهائي: 94045 موظّف الدعم: ستختار سيارة Cymbal. في لاس فيغاس، 2024-03-05 الساعة 12:00:00 ووضعها، 2024-03-15 12:00:00. سيكون إجمالي هذه الرحلة 175.38 دولارًا. موظّف الدعم: نشكرك على تأجير المحتوى معنا ونتمنّى لك يومًا رائعًا. |
|
إرسال رسائل البطاقات من Dialogflow
يمكن لـ Dialogflow الرد باستخدام text أو رسائل البطاقات. للرد باستخدام بطاقة على أنها رسالة، فقم بتحديدها حمولة مخصّصة بوصة توصيل الطلبات:
يعرض ملف 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. إذا كانت الرسالة تتضمن أمر slash، وهي قيمة فسيتم استخدام الحقلtext
بدلاً من ذلك. - بالنسبة إلى أحداث
CARD_CLICKED
، تم إرسال إدخال طلب البحث إلى وكيل Dialogflow يتم تنسيقها على الشكلCARD_CLICKED.functionName
، حيثfunctionName
مع قيمة الحقلfunction
عنصر الإجراء مرفقة بعنصر البطاقة التفاعلية (مثل زر). - حمولة JSON الكاملة لكل حدث تفاعل في Chat
يتم إرساله إلى Dialogflow كحمولة مخصّصة في معلَمة طلب البحث،
يمكن الوصول إليه من خلال
الردّ التلقائي على الويب من Dialogflow
عن طريق الاستعلام عن قيمة الحقل
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 والدردشة في مشاريع مختلفة على Google Cloud، وبالتالي إعداد خادم وسيط لتسهيل الاتصال. للتعرّف على كيفية إجراء ذلك، عرض هذا مثال على دمج الدردشة مع Dialogflow CX على GitHub.
تحديد المشاكل وحلّها
عند تثبيت تطبيق Google Chat أو تعرض card خطأً، تعرض واجهة Chat رسالة مفادها "حدث خطأ". أو "تعذَّرت معالجة طلبك". في بعض الأحيان، لا يمكن واجهة مستخدم Chat لا يعرض أي رسالة خطأ، ولكن يظهر تطبيق Chat أو ينتج عن بطاقة نتيجة غير متوقعة؛ على سبيل المثال، قد لا تظهر رسالة البطاقة موضع الإعلان.
على الرغم من أنه قد لا تظهر رسالة الخطأ في واجهة مستخدم Chat، تتوفر رسائل خطأ وصفية وبيانات السجل لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء لتطبيقات Chat للحصول على مساعدة في العرض، وتصحيح الأخطاء وإصلاح الأخطاء، فراجع تحديد مشاكل Google Chat وحلّها.
تَنظيم
لتجنب تكبد أي رسوم إلى حسابك في Google Cloud مقابل الموارد المستخدمة في هذا البرنامج التعليمي، نوصيك بحذف المشروع على السحابة الإلكترونية.
- في وحدة تحكُّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. (يُرجى النقر.) قائمة الطعام > إدارة الهوية وإمكانية الوصول و المشرف > إدارة الموارد.
- في قائمة المشاريع، اختَر المشروع الذي تريد حذفه ثم انقر على حذف .
- في مربّع الحوار، اكتب رقم تعريف المشروع ثم انقر على إيقاف التشغيل لحذفه. للمشروع.
مواضيع ذات صلة
- يأخذ Dialogflow CX
جهاز الحالة
نحو تصميم وكيل Dialogflow، والذي يمنحك معلومات واضحة وصريحة
والتحكم في المحادثات وتقديم تجربة أفضل للمستخدم النهائي
سير عمل التطوير. عند إنشاء Dialogflow
في تطبيق Chat، ننصحك باستخدام Dialogflow CX.
- لمزيد من المعلومات عن إنشاء البرامج الوكيلة وضبطها، يمكنك الاطّلاع على وكلاء Dialogflow CX
- للحصول على جولة تفصيلية ترشدك إلى كيفية إنشاء حساب موظّفو الدعم، يُرجى الاطّلاع على إنشاء وكيل Dialogflow CX
- إنشاء تطبيقات متوافقة مع Google Chat باستخدام Gemini: درس تطبيقي حول الترميز: للحصول على مثال حول كيفية إنشاء بيانات Dialogflow CX يمكنك الاطّلاع على تطبيق Google Chat المخصّص للمتجر من الدرس التطبيقي حول الترميز
- إنشاء تطبيقات متوافقة مع Google Chat باستخدام Gemini: درس تطبيقي حول الترميز: للحصول على مثال حول كيفية إنشاء نموذج Dialogflow CX موظّف الدعم الحواري، يُرجى الاطّلاع على ملاحظات تطبيق Chat من الدرس التطبيقي حول الترميز
- Dialogflow ES هو طريقة أخرى لاستخدام Dialogflow مع تطبيق Chat.