تمثّل الأهداف مهمة يحتاج "مساعد Google" إلى تنفيذ الإجراء الخاص بك، مثل إدخال بعض بيانات المستخدم التي تحتاج إلى معالجة أو حدث نظام تحتاج إلى معالجته. أنت تستخدم الأغراض للمساعدة في إنشاء نماذج الاستدعاء والمحادثات. وعند وقوع هذه الأحداث، يتطابق وقت تشغيل "مساعد Google" مع الغرض المقابل ويرسل النية إلى الإجراء الخاص بك لمعالجته. هناك نوعان رئيسيان من الأغراض، على النحو الموضح في القائمة التالية:
تتيح لك أهداف المستخدم توسيع نطاق قدرة "مساعد Google" على فهم طلبات المستخدمين الخاصة بعلامتك التجارية وخدماتك. يمكنك تحديد عبارات التدريب المخصّصة ضمن هدف معيّن، ما يؤدي بدوره إلى إنشاء نموذج لغة هدف محدّد. يعزّز هذا النموذج اللغوي تقنية NLU الخاصة بخدمة "مساعد Google"، ما يعزّز قدرتها على فهم المحتوى بشكل أكبر.
تتضمّن أهداف النظام بيانات تدريب أو إشارات إدخال غير حوارية أخرى يحدّدها "مساعد Google". هذا يعني أنك لست بحاجة إلى تحديد عبارات التدريب لهذه الأغراض. يطابق "مساعد Google" هذه الأهداف بطريقة عادية، وذلك خلال أحداث معروفة للنظام، مثل الاستدعاء الرئيسي، أو عندما لا يقدّم المستخدمون أي بيانات.
نوايا المستخدم
عند إنشاء المهام، يتم إنشاء نوايا للمستخدم تحتوي على عبارات تدريبية، ما يعزّز قدرة "مساعد Google" على الفهم أكثر. يستخدم "مساعد Google" عبارات التدريب لتعزيز فهم NLU عندما يفوّض المستخدمين بتنفيذ الإجراءات الخاصة بك.
في هذه الحالة، يتوسّط "مساعد Google" في عملية التواصل بين المستخدم والإجراءات الخاصة بك، ويربط البيانات التي أدخلها المستخدم بهدف لديه نموذج لغة مطابق. بعد ذلك، يرسل "مساعد Google" إشعارات إلى الإجراءات التي تم تنفيذها من خلال هدف مطابق، وذلك لتتمكّن من معالجته في مشهد.
عند إنشاء نوايا المستخدم، عليك تحديد العناصر التالية:
يحدد التصنيف العالمي لأهداف الجمهور ما إذا كان وقت تشغيل "مساعد Google" يمكن أن يتطابق مع نية المستخدم المحدّدة في وقت الاستدعاء وخلال إحدى المحادثات بالإضافة إلى ذلك. بشكل تلقائي، لا يمكن أن يطابق "مساعد Google" نوايا المستخدم إلا أثناء المحادثة. إنّ الأغراض التي تضع علامة عليها تشير إلى أنّها عالمية هي فقط المؤهَّلة لاستدعاء الروابط لصفحات في التطبيق.
عبارات التدريب هي أمثلة على ما قد يقوله المستخدم لمطابقة الهدف. ويعمل محرك Assistant NLU (فهم اللغات الطبيعية) بشكل طبيعي على توسيع عبارات التدريب هذه لتضمين عبارات أخرى مشابهة. إن تقديم مجموعة كبيرة من الأمثلة عالية الجودة يزيد من جودة الهدف ودقة المطابقة.
المَعلمات هي بيانات مكتوبة تريد استخراجها من البيانات التي أدخلها المستخدِم. لإنشاء مَعلمة، يجب إضافة تعليقات توضيحية لعبارات التدريب باستخدام أنواع لإعلام محرّك بحث NLU بأنّك تريد استخراج أجزاء من البيانات التي أدخلها المستخدم. يمكنك استخدام أنواع النظام أو إنشاء أنواع مخصصة خاصة بك للمعلمات.
عندما يكتشف محرّك NLU تطابق معلَمة في البيانات التي أدخلها المستخدم، فإنه يستخرج القيمة كمَعلمة مكتوبة، بحيث يمكنك تنفيذ المنطق باستخدامه في أي مشهد. إذا كانت مَعلمة القصد تحمل اسم خانة المشهد نفسه، يملأ وقت تشغيل "مساعد Google" خانة المشهد تلقائيًا بالقيمة الواردة من مَعلمة intent. راجع وثائق تعيين قيمة الشريحة للحصول على مزيد من المعلومات.
وتتيح مَعلمات الأهداف أيضًا المطابقات "الجزئية". على سبيل المثال، إذا حددت نوعًا من DateTime والمستخدم يقدم تاريخًا فقط، ستظل NLU تستخرج القيمة الجزئية كمَعلمة.
قد تريد استخدام NLU (NLU) الخاص بك لمعالجة جميع إدخالات المستخدم لإجراء ما. على سبيل المثال، قد تريد أن يستجيب الإجراء الخاص بك لجميع سيناريوهات عدم التطابق أثناء المحادثة. لضمان تسجيل كل البيانات التي أدخلها المستخدمون، أنشئ هدفًا باستخدام نوع نص مرن. ومع ذلك، عليك تجنُّب استخدام أغراض مخصّصة لتجاوز السلوك التلقائي لعدم المطابقة في "مساعد Google" بشكل عام، لأنّ ذلك قد يؤثّر سلبًا في قدرة المستخدمين على التنقّل بين المهام.
عند إنشاء غرض مخصّص حسب النية بالشراء في وحدة تحكّم المهام، تقترح أداة إنشاء الإجراءات أهدافًا للنظام قد تؤدي الدور نفسه الذي يؤديه نية المستخدم. لمزيد من المعلومات عن أغراض النظام، يُرجى الرجوع إلى القسم التالي.
أغراض النظام
يطابق "مساعد Google" أهداف النظام استنادًا إلى الأحداث العادية للنظام. وقد يكون لهذه الأحداث نموذج لغوي يحدّده النظام، مثل قول المستخدمين "pause" لإيقاف تشغيل مشغّل الوسائط مؤقتًا، أو قد لا يكون لديهم نموذج لغوي، مثل عدم تقديم المستخدمين أي مدخلات على الإطلاق. بما أنّ "مساعد Google" هذه الأغراض تقدّمها، فلا داعي للقلق بشأن كيفية مطابقتها، بل فقط كيفية التعامل مع الأهداف عند مطابقتها.
وتحل أغراض النظام أيضًا محل الحاجة إلى إنشاء أغراض المستخدم للإجراءات التي تلزم كثيرًا، مثل YES وNO. يتم تدريب أهداف النظام على جميع اللغات، ما يتيح لك تنفيذ تجربة متسقة للمستخدمين بلغات متعددة بسهولة أكبر.
يمكن أيضًا ضبط أغراض النظام كأهداف عالمية.
تم تحديد نُسخ من أغراض النظام. يمكنك استخدام إصدار محدّد من هدف النظام طالما أنّ هذا الإصدار متوافق مع "مساعد Google". إذا كان أحد الإجراءات يستخدم نسخة غير متوافقة من هدف النظام، يتم تحديث الغرض من النظام هذا تلقائيًا إلى إصدار متوافق.
قائمة الأهداف
| النيّة بالشراء | الوصف |
|---|---|
actions.intent.MAIN
|
يجب أن يحتوي كل مشروع "المهام" على هذا الاستدعاء الرئيسي التلقائي والمرتبط بالاسم المعروض الخاص بك. يقول المستخدمون عبارات مثل "Ok Google، التحدّث إلى <display name>" لاستدعاء الإجراء. |
|
|
تتم مطابقة هذه الأهداف عندما يقول المستخدم شيئًا لا يمكن مطابقته مع هدف في الإجراء الخاص بك. ويمكنك ضبط طلبات فردية ورسالة خروج في الغرض النهائي. |
|
|
تتم مطابقة هذه الأهداف عندما لا يتم إدخال أي بيانات من المستخدم بعد 8 ثوانٍ. يمكنك ضبط طلبات فردية لكل هدف ورسالة خروج في الغرض النهائي. |
actions.intent.CANCEL
|
تتم مطابقة هذا الهدف عندما يريد المستخدم الخروج من الإجراءات الخاصة بك أثناء المحادثة، مثلاً إذا قال المستخدم "أريد الخروج". |
actions.intent.MEDIA_STATUS_FINISHED
|
تتم مطابقة هذا الهدف ويتم إرساله إلى الإجراء الخاص بك عندما يُكمل المستخدم تشغيل الوسائط أو يتخطى إلى الجزء التالي من الوسائط. |
actions.intent.MEDIA_STATUS_PAUSED
|
تتم مطابقة هذا الهدف ويتم إرساله إلى الإجراء الخاص بك عندما يوقف المستخدم تشغيل الوسائط مؤقتًا في استجابة الوسائط. |
actions.intent.MEDIA_STATUS_STOPPED
|
تتم مطابقة هذا الهدف وإرساله إلى الإجراء الخاص بك عندما يوقف المستخدم تشغيل الوسائط أو يخرج منه من استجابة للوسائط. |
actions.intent.MEDIA_STATUS_FAILED
|
تتم مطابقة هذا الهدف ويتم إرساله إلى الإجراء الخاص بك عند تعذّر تشغيل مشغّل استجابة الوسائط. |
actions.intent.YES
|
تتم مطابقة هذا الهدف عندما يقدّم المستخدم ردًا تأكيديًا على الإجراء الخاص بك. |
actions.intent.NO
|
تتم مطابقة هذا الهدف عندما يقدّم المستخدم ردًا سلبيًا على الإجراء الخاص بك. |
actions.intent.REPEAT
|
تتم مطابقة هذا الهدف عندما يطلب المستخدم من الإجراء تكرار الرد الأخير. تعالج خدمة "مساعد Google" طلبات التكرار تلقائيًا إذا لم يتم تفعيل هدف النظام في الوكيل. يتيح لك تفعيل هدف النظام هذا تعديل كيفية التعامل مع الطلبات المتكرّرة، بالإضافة إلى الردود. |
actions.intent.PLAY_GAME
|
تتم مطابقة هذا الهدف عندما يطلب المستخدم تشغيل لعبة. يتيح لك هذا الغرض تفعيل استدعاء ضمني (استدعاء بدون استخدام اسمك المعروض) يوفّره "المهام مع مساعد Google". |
إضافة إتاحة اللغات الأخرى
تتوفّر بعض أغراض النظام، مثل YES وNO وNO_MATCH، باللغة الإنجليزية فقط.لإضافة لغات أخرى، يجب عليك إنشاء أغراض المستخدم
التي تتطابق مع أغراض النظام هذه. يجب التعامل مع الأغراض الجديدة في التعليمة البرمجية
بنفس طريقة أغراض النظام التي نفذتها.
على سبيل المثال، لنفترض أنّك تعمل على تطوير إجراء جديد ونفّذت
هدف نظام YES. يتوفر هدف نظام YES باللغة الإنجليزية فقط، ولكنك تريد أيضًا أن يدعم تطبيقك التفاعلات باللغتين الألمانية واليابانية.
لإتاحة استخدام اللغات الإضافية، عليك إنشاء هدف يتضمّن تدريبًا على العبارات الألمانية واليابانية، ثم تنفيذ طريقة المعالجة التي استخدمتها لغرض نظام YES.
مزيد من المعلومات حول إنشاء أهداف المستخدم.
اطّلع على مزيد من المعلومات عن ترجمة نوايا المستخدمين.
تحقيق نتائج غير مطابقة
إذا لم يتطابق ردّ المستخدم مع أحد أهدافك، يحاول "مساعد Google" التعامل مع الإدخال. يسهّل هذا السلوك المستخدمين من تغيير الإجراءات في منتصف المحادثة. على سبيل المثال، يسأل المستخدم، "ما الأفلام التي يتم عرضها هذا الأسبوع؟" ثم يغيّر السياق في منتصف المحادثة: "كيف سيكون الطقس غدًا؟" في هذا المثال، ولأنّ "كيف سيكون الطقس غدًا؟"، لا يعتبر "مساعد Google" ردًا صالحًا على المحادثة التي بدأت من خلال الطلب الأولي، يحاول تلقائيًا معالجة المطابقة ونقل المستخدم إلى محادثة مناسبة.
إذا تعذّر على "مساعد Google" العثور على إجراء مناسب يتطابق مع البيانات التي أدخلها المستخدم، يواصل المستخدم تنفيذ الإجراء في سياقه.
وبما أنّ "مساعد Google" قد يقاطع الإجراء الخاص بك للاستجابة لسيناريو صالح لعدم المطابقة، لا تستخدِم هدف نظام NO_MATCH لتنفيذ طلبات المستخدمين. يجب استخدام الغرض NO_MATCH فقط لإعادة الطلب إلى المستخدم.