رسائل intent هي كائنات مراسلة تصف كيفية تنفيذ إجراء ما. يمكنك استخدام النية للشراء بإحدى الطريقتَين التاليتَين:
- من خلال توفير طريقة توفّر الغرض من التجربة
- إذا طلبت من "مساعد Google" تنفيذ هدف معيّن
وتختلف هذه العملية التي توفّرها لتنفيذ نيّة الشراء لدى مطوّري البرامج باستخدام Dialogflow ومطوّري البرامج الذين يستخدمون حزمة تطوير البرامج (SDK) لتنفيذ الإجراءات. وفي كلتا الحالتين، يجب توفير اسم النية بالشراء وعنوان URL للرد التلقائي على الويب المرتبط بطريقة التنفيذ. يؤدي ذلك إلى إعلام "المهام مع مساعد Google " بأنّه يمكنك إتاحة طلبات بحث المستخدمين المتوافقة مع الهدف.
لطلب تنفيذ هدف، يجب تحديد الهدف في الكائن possibleIntents عند الاستجابة إلى "مساعد Google". في الطلب التالي لتنفيذ الطلب، سيعرض "مساعد Google" نتيجة المعالجة التي تمت معالجتها لك. لمزيد من المعلومات، اطّلِع على نظرة عامة على استخدام المساعدين.
النوايا الشائعة
يوضّح الجدول التالي الأهداف التي يطلب "مساعد Google" منك تنفيذها.
| اسم النية بالشراء | الاستخدام | حدث Dialogflow |
|---|---|---|
actions.intent.MAIN |
مطلوبة: تشير كل حزمة إجراءات إلى أنّ هدفًا واحدًا فقط هو نقطة دخول للمستخدمين لبدء المحادثات. | WELCOME أو GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
الحصول على تمثيل نصي أولي لطلب المستخدم. أنت تستخدم هذا الوقت غالبًا عند المشاركة في محادثة مع المستخدمين. | |
actions.intent.CANCEL |
ستتلقّى هذا الهدف عند تفعيل ميزة تلقّي رسائل الإلغاء في حزمة الإجراءات. عندما يقول المستخدمون طلبًا عامًا للإلغاء، مثل "إنهاء"، ستتلقّى هذه النية في الطلب التالي لتنفيذ طلبك، حتى تتمكّن من الردّ على الرسالة النهائية وتنفيذ أي عملية إزالة للمنطق. | actions_intent_CANCEL |
actions.intent.NO_INPUT |
ستتلقّى هذا الهدف عند تفعيل تلقّي نوايا عدم الإدخال في حزمة الإجراءات. وفي حال عدم ردّ المستخدمين على إشعار، ستتلقّى هذه النية في الطلب التالي لتنفيذ الطلب. | actions_intent_NO_INPUT |
المساعدون
يوضّح الجدول التالي المساعدين المتوافقين الذين يمكنك أن تطلب منهم تنفيذ "مساعد Google".
| اسم النية بالشراء | الاستخدام | حدث Dialogflow |
|---|---|---|
actions.intent.PERMISSION |
احصل على الاسم الكامل للمستخدم أو الموقع الجغرافي التقريبي أو الموقع الجغرافي الدقيق أو جميعها 3. | actions_intent_PERMISSION |
actions.intent.OPTION |
يمكنك تلقّي العنصر المحدّد من واجهة مستخدم قائمة أو لوحة عرض دوّارة. وفي حال لم يختَر المستخدم من القائمة أو واجهة مستخدم لوحة العرض الدوّارة، يمكنك تلقّي إدخال الكلام أو النص الذي يتطابق مع المفتاح في القائمة أو واجهة مستخدم لوحة العرض الدوّارة. | actions_intent_OPTION |
actions.intent.DATETIME |
الحصول على إدخال التاريخ والوقت من المستخدم. | actions_intent_DATETIME |
actions.intent.SIGN_IN |
يطلب المسار ربط الحساب لربط حساب مستخدم. | actions_intent_SIGN_IN |
actions.intent.PLACE |
الحصول على عنوان أو موقع جغرافي محفوظ من المستخدم | actions_intent_PLACE |
actions.intent.CONFIRMATION |
الحصول على تأكيد من المستخدم (على سبيل المثال، إجابة بنعم أو لا). | actions_intent_CONFIRMATION |
actions.intent.NEW_SURFACE |
يطلب من المستخدم إذنًا للانتقال إلى مساحة عرض أخرى في "مساعد Google". | actions_intent_NEW_SURFACE |
الأهداف المضمّنة
تمثّل نيّات التطبيق المضمّنة بعض الطرق الشائعة التي يعبّر بها المستخدمون عن المهام التي يحاولون تنفيذها أو المعلومات التي يبحثون عنها، مثل طلب وجبة أو حجز رحلة أو الاطّلاع على رصيد الحساب. يمكنك الاطّلاع على المرجع المضمّن حسب النية بالشراء للحصول على مزيد من المعلومات.
أغراض إضافية
تستند معظم إجراءات المحادثة إلى مجموعة من الأهداف والمساعدات والردود الشائعة. ومع ذلك، فإنّ الإجراءات التي تتضمّن ميزات إضافية مثل المعاملات أو التعديلات اليومية إمكانية الوصول إلى عناصر intent لهذه الميزات.
تطبيقات مساعدة المعاملات
يوضّح الجدول التالي المساعدات المرتبطة بمعالجة عمليات الشراء التي يمكنك أن تطلب من "مساعد Google" تنفيذها. يمكنك العثور على مزيد من المعلومات حول كيفية تنفيذ هذه الأغراض وغيرها من الأغراض ذات الصلة في مستندات ميزات المعاملات.
| اسم النية بالشراء | الاستخدام | حدث Dialogflow |
|---|---|---|
actions.intent.DELIVERY_ADDRESS |
الحصول على إدخال عنوان التسليم من المستخدم. | actions_intent_DELIVERY_ADDRESS |
actions.intent.TRANSACTION_REQUIREMENTS_CHECK |
التحقق من استيفاء جميع متطلبات المعاملة | actions_intent_TRANSACTION_REQUIREMENTS_CHECK |
actions.intent.TRANSACTION_DECISION |
اسأل المستخدم عما إذا كان يجب إجراء المعاملة أم لا. | actions_intent_TRANSACTION_DECISION |
actions.intent.DIGITAL_PURCHASE_CHECK |
يتحقق من صحة ضبط معاملة المستخدم. يُستخدم هذا الخيار لتجنُّب تقديم سلع رقمية للمستخدمين الذين يتعذّر إجراء المعاملة لهم. | actions_intent_DIGITAL_PURCHASE_CHECK |
actions.intent.COMPLETE_PURCHASE |
يبدأ طلب شراء. تؤدي إلى نتيجة شراء توضّح ما إذا كانت المعاملة قد نجحت أو لم تنجح. | actions_intent_COMPLETE_PURCHASE |
نِيّ تفاعل المستخدمين
ويوضّح الجدول التالي عناصر intent المتعلّقة بميزات تفاعل المستخدمين. يمكنك الاطّلاع على مزيد من المعلومات عن طريقة تنفيذ هذه الوحدات الإعلانية وغيرها من النيّات ذات الصلة في مستندات ميزات تفاعل المستخدمين.
| اسم النية بالشراء | توفير طريقة التنفيذ | تنفيذ الطلب | الاستخدام | حدث Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | تطلب من المستخدم التسجيل للحصول على التحديثات. | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | ستتلقّى هذه النية عن طريق المستخدم عندما يحاول التسجيل للتحديثات (أي يجب إرسال رسالة تسجيل REG_UPDATE). | actions_intent_CONFIGURE_UPDATES |
مخصّص حسب نيّة الشراء
يمكنك إنشاء نواياك الخاصة لتحديد الاختصارات في المحادثة لمساعدة المستخدمين على إنجاز المهام بفعالية أكبر. تظل هذه الأهداف في مساحة الاسم الخاصة بك، ويمكنك تحديد الطريقة التي يشغّل بها المستخدمون الأهداف، كما أن "حزمة الإجراءات" هي الحزمة الوحيدة التي يمكنها تقديم هذه الأهداف.
لمزيد من المعلومات، يُرجى الاطِّلاع على تحديد الإجراءات في Dialogflow أو باستخدام حزمة تطوير برامج المهام. يمكنك العثور على مزيد من المعلومات حول حِزم الإجراءات في مستندات مرجع حزمة الإجراءات.
أغراض المنزل الذكي
إذا كنت تنشئ إجراءً منزليًا ذكيًا، ستحدّد توافقه مع نواياه بطريقة مختلفة قليلاً. اطّلِع على المستندات المتعلقة بأغراض المنزل الذكية.