يوضِّح هذا المستند تنسيق الرد التلقائي على الويب للتواصل بين "المهام مع مساعد Google"
وخدمة تنفيذ الطلبات التي تُحدِّد واجهة مستخدم محادثات مخصَّصة.
من المهم فهم كيفية تواصل "المهام مع مساعد Google" وتنفيذك من خلال تنسيقات الردّ التلقائي على الويب في "المهام مع مساعد Google":
للمشاركة في محادثات باستخدام "المهام مع مساعد Google"، يتم تنفيذ ردّ تلقائي على الويب يمكنه الردّ على طلبات HTTP من "المهام مع مساعد Google".
عندما يستدعي المستخدمون الإجراء الخاص بك، تتلقّى عملية تنفيذ الإجراء HTTP POST مع حمولة بيانات JSON تصف طلب المستخدم.
في المقابل، يكون التنفيذ مسؤولاً عن قراءة المعلَمات من حمولة الطلب وإنشاء استجابة بتنسيق JSON مناسب وإرسال ردّ إلى "مساعد Google" يتضمّن هذا الردّ.
أنواع الطلبات
يلخّص هذا الجدول أنواع الطلبات التي قد يتلقّاها الردّ التلقائي على الويب من "مساعد Google":
Type
الوصف
أمثلة على JSON
طلبات الاستدعاء
العبارات التي يألفها المستخدم والتي تبدأ المحادثة مع الطلب أو تؤدّي إلى تنفيذ إجراءات برابط لصفحة في التطبيق (على سبيل المثال، "التحدّث إلى طاهٍ شخصي للعثور على وصفات طعام العشاء")
في حال استخدام Dialogflow، تتوافق هذه الطلبات مع الأغراض
المحدّدة في قسم اقتراحات ضمن إعدادات دمج مساعد Google.
في حال استخدام حزمة تطوير البرامج (SDK) للإجراءات، تتوافق هذه الطلبات مع الأغراض المحدّدة في حزمة الإجراءات.
العبارات التي قالها المستخدمون في الجلسة نفسها بعد بدء المحادثة مع
قسم التنفيذ. في تنسيق الرد التلقائي على الويب للمحادثة، هذه هي
الردود النصية الأولية من المستخدم والتي تتوافق مع نوايا actions.intent.TEXT
التي طلبها تنفيذك في الدور السابق.
الطلبات التي أرسلها "مساعد Google" إلى عملية التنفيذ عندما يطلب الردّ التلقائي على الويب
نيّة مساعد
في المرحلة السابقة من المحادثة للتعامل مع أجزاء
من المحادثة (على سبيل المثال، actions.intent.OPTION
وactions.intent.PERMISSION).
في سيناريو تفاعل "المهام مع مساعد Google" النموذجي، ينطق المستخدمون عبارة لاستدعاء إجراء. لتقديم رد، تعثر ميزة "المهام مع مساعد Google" على التنفيذ الذي يطابق
الإجراء الذي استدعاه المستخدم ويرسل الطلب إلى هناك.
بعد أن تثبت خدمة Actions on Google أنّ عملية تنفيذ طلبك مطابقة مناسبة لاستدعاء المستخدم، يتم بدء جلسة محادثة عن طريق إرسال طلب HTTP يتضمّن حمولة JSON بمعلومات طلب المستخدم إلى نقطة نهاية التنفيذ. يحلل التنفيذ الذي تقوم به الطلب ويعرض ردًا
يحتوي على حمولة JSON. ثم تحوّل "المهام مع مساعد Google" الحمولة إلى كلام وإخراج وسائط متعددة معروض للمستخدمين.
الشكل 1. يستدعي "المهام مع مساعد Google" عملية التنفيذ من خلال
حزمة تطوير البرامج (SDK) للإجراءات.
لمزيد من المعلومات عن تنسيق حمولة JSON عندما تستدعي "المهام مع مساعد Google" عملية التنفيذ من خلال حزمة تطوير البرامج "للمهام"، يُرجى الاطّلاع على تنسيق الرد التلقائي على الويب للمحادثة.
الطلبات والردود في Dialogflow
عند إنشاء "المهام"، يمكنك استخدام Dialogflow لتبسيط
مهمة إنشاء واجهات محادثات. في هذا السيناريو، يعمل Dialogflow كوكيل
بين "المهام مع مساعد Google" وتنفيذك. وبدلاً من إرسال طلب HTTP/JSON مباشرةً إلى نقطة نهاية التنفيذ، يرسله "المهام مع مساعد Google" إلى Dialogflow.
يدمج Dialogflow حمولة بيانات JSON المضمّنة في الطلب الأصلي بتنسيق
الرد التلقائي على الويب في Dialogflow، ويُعيد توجيه الطلب الناتج إلى تنفيذ Dialogflow.
وفي المقابل، عندما يرسل التنفيذ ردًا إلى Dialogflow، يجب أن تتوافق حمولة JSON
للاستجابة مع تنسيق الرد التلقائي على الويب في Dialogflow. يحلّل التنفيذ المعلَمات من طلب Dialogflow JSON وينشئ ردًا بتنسيق الرد التلقائي على الويب في Dialogflow. يحوّل Dialogflow الرد من تنفيذك إلى رسالة رد يفهمها
مساعد Google.
الشكل 2. يستدعي "المهام مع مساعد Google" عملية تنفيذ طلبك من خلال
Dialogflow.
تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2023-12-02 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Actions on Google communicates with your fulfillment service through webhooks, sending JSON payloads that describe user requests."],["Your fulfillment service needs to process these requests, generate appropriate JSON responses, and send them back to the Assistant."],["There are two main webhook formats: Dialogflow webhook format and Conversation webhook format, depending on whether you use Dialogflow or Actions SDK."],["Webhooks can handle different request types like invocation requests, conversation requests, and helper results, each with specific JSON structures."],["Dialogflow can act as a proxy between Actions on Google and your fulfillment, handling the communication and format conversions."]]],["Actions on Google uses webhooks to communicate with fulfillment services, sending HTTP POST requests with JSON payloads. Fulfillment services must parse these requests and respond with appropriately formatted JSON. There are two main webhook formats: Dialogflow and Conversation, corresponding to whether Dialogflow acts as a proxy. Webhook requests can be invocations, conversation turns, or helper results. The fulfillment reads parameters from the request payload and sends a reply back to the Assistant.\n"]]
