يوضّح هذا المستند تنسيق الردّ التلقائي على الويب للتواصل بين "المهام مع مساعد Google" وخدمة توصيل توفّر واجهة مستخدم مخصّصة للمحادثات.
ومن المهم فهم كيفية وصول المهام على Google و"تنفيذ المهام" من خلال تنسيقات "الردّ التلقائي على الويب في "المهام مع مساعد Google":
- للمشاركة في محادثات مع "المهام مع مساعد Google"، نفِّذ طريقة التنفيذ الرد التلقائي على الويب الذي يمكنه الرد على طلبات HTTP من خلال "المهام مع مساعد Google".
- عندما يستدعي المستخدمون الإجراء الذي تقدّمه، سيتلقّى توصيل الطلب
HTTP POSTمع حمولة JSON تصف طلب المستخدم. - وبالتالي، سيكون توصيل الطلب مسؤولاً عن قراءة المعلَمات من حمولة الطلب وإنشاء استجابة بتنسيق JSON مناسبة وإرسال ردّ إلى "مساعد Google" باستخدام هذه الاستجابة.
أنواع الطلبات
يلخّص هذا الجدول أنواع الطلبات التي قد يتلقّاها الرد التلقائي على الويب من "مساعد Google":
| Type | الوصف | أمثلة على JSON |
|---|---|---|
| طلبات الاستدعاء | هي عبارات المستخدمين التي تبدأ المحادثة مع توصيل الطلب أو
تؤدي إلى تنفيذ إجراءات الروابط للصفحات في التطبيق (على سبيل المثال، "التحدّث إلى الشيف الشخصي للعثور على
وصفات للعشاء")
|
|
| طلبات المحادثات | عدد مرات الظهور من خلال المستخدمين في الجلسة نفسها بعد بدء المحادثة مع توصيل الطلب. في تنسيق الردّ التلقائي على الويب للمحادثة، هذه
هي الردود النصية الأولية من المستخدم المقابلة لرغبات actions.intent.TEXT
التي طلبها العميل في الدور السابق. |
|
| النتائج المساعِدة | الطلبات التي يرسلها "مساعد Google" إلى توصيل طلباتك عندما يطلب الردّ التلقائي على الويب رغبة في المساعدة في الدور السابق من المحادثة للتعامل مع أجزاء من المحادثة (على سبيل المثال، actions.intent.OPTION وactions.intent.PERMISSION) |
طلبات المحادثات والردود
في سيناريو نموذجي حول "المهام مع مساعد Google"، يلفظ المستخدِمون عبارة لاستدعاء إجراء معيّن. لتقديم ردّ، يعثر تطبيق "المهام مع مساعد Google" على طريقة تنفيذ الطلب التي تتطابق مع الإجراء الذي استدعاه المستخدم ويرسل الطلب إلى التطبيق.
بعد أن يتبيّن لبرنامج "المهام مع مساعد Google" أنّ تنفيذ الطلب هو مناسب لاستدعاء المستخدم، يتم بدء جلسة محادثة من خلال إرسال طلب HTTP يحتوي على حمولة JSON تتضمّن معلومات طلب المستخدم إلى نقطة نهاية التنفيذ. تحلّل عملية التنفيذ الطلب وتُعرض استجابة تحتوي على حمولة JSON. بعد ذلك، تحوِّل "المهام مع مساعد Google" الحمولة إلى إخراج الكلام والوسائط المتعددة للمستخدمين.
لمزيد من المعلومات عن تنسيق حمولة JSON عندما يستدعي "المهام مع مساعد Google" تنفيذ الطلب من خلال حزمة تطوير البرامج (SDK) للإجراءات، يُرجى الاطّلاع على تنسيق الرد التلقائي على الويب للمحادثات.
طلبات Dialogflow والردود عليه
عند إنشاء المهام، يمكنك اختياريًا استخدام Dialogflow لتبسيط مهمة إنشاء واجهات المحادثة. في هذا السيناريو، يعمل Dialogflow كخادم وكيل بين المهام على Google وعملية توصيل الطلبات. بدلاً من إرسال طلب HTTP/JSON مباشرةً إلى نقطة نهاية طريقة التنفيذ، يرسلها "المهام مع مساعد Google" إلى Dialogflow.
تحدّد Dialogflow حمولة JSON المضمّنة في الطلب الأصلي إلى تنسيق الردّ التلقائي على الويب Dialogflow وتعيد توجيه الطلب الناتج إلى طريقة تنفيذ Dialogflow.
في المقابل، عندما يرسل النموذج الردّ إلى Dialogflow، يجب أن تتوافق حِملة JSON للاستجابة مع تنسيق الردّ التلقائي على الويب في Dialogflow. تحلِّل طريقة التنفيذ المعلَمات من طلب Dialogflow بتنسيق JSON، وتنشئ استجابة بتنسيق الردّ التلقائي على الويب Dialogflow. بعد ذلك، يحوّل Dialogflow الاستجابة من توصيل الطلب إلى رسالة ردّ يفهمها "مساعد Google".
للاطّلاع على المزيد من المعلومات حول تنسيق حمولة JSON عندما يستدعي تطبيق "المهام مع مساعد Google" تنفيذ الطلبات من خلال Dialogflow، يمكنك الاطّلاع على تنسيق الردّ التلقائي على الويب في Dialogflow.