تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحدد نموذج الاستدعاء كيفية استدعاء الإجراءات في مشروعك.
عندما يستدعي المستخدمون إجراءً، فإنهم يبدؤون محادثة معه، وهو
محدّدة في نموذج المحادثة. يمكنك تحديد عدد الاستدعاءات
بالطرق التالية:
الاستدعاء الرئيسي:
هو الاستدعاء الوحيد المطلوب لمشروع الإجراءات. يقول المستخدمون عبارة
على غرار "Ok Google، أريد التحدّث إلى <display name>" لمطابقة هذا الهدف،
والذي تتعامل معه عادةً من خلال تحية المستخدم برسالة ترحيب.
استدعاءات الروابط المؤدية إلى صفحات في التطبيق:
هذه استدعاءات اختيارية تتيح لك تحديد عبارات التدريب في
حسب النية بالشراء، بحيث يمكن للمستخدمين
إنشاء رابط لموضع معين في جزء محدد من
محادثة. يمكن للمستخدمين قول عبارة مشابهة لـ "Ok Google، تحدث إلى
<الاسم المعروض> إلى <deep link مصادقة>" لمطابقة هذه الأنواع من
الأهداف (على سبيل المثال، "Ok Google، التحدث إلى حقائق عن Google للحصول على
الحقائق")
أهداف مضمَّنة:
هذه استدعاءات اختيارية تتيح لك الاستفادة من استدعاءات النظام
نماذج الاستدعاء. من خلال إعلان الدعم لهدف مدمج، يمكن للمستخدمين
اكتشاف واستدعاء مشروع الإجراءات الخاص بك دون الحاجة إلى تحديد
اسم العرض. على سبيل المثال، يمكن للمستخدمين قول "Ok Google، أريد تشغيل لعبة".
يمكن أن يقدّم "مساعد Google" الإجراء الخاص بك كخيار للاستدعاء.
الشكل 1. يتكون نموذج الاستدعاء من جميع الأغراض
المؤهَّلة لبدء محادثات مع "المهام".
إنشاء الاستدعاء الرئيسي
يتضمّن كل مشروع في "المهام" استدعاءً تلقائيًا رئيسيًا يعمل كإعداد تلقائي.
نقطة الدخول إلى مشروع الإجراءات.النموذج اللغوي لهذا الاستدعاء
بالاسم المعروض لمشروعك، لذلك يحتاج المستخدمون فقط إلى قول
عبارة تشبه "Ok Google، التحدّث إلى <الاسم المعروض>" لاستخدام هذه
. وعند تنفيذ المستخدمين لـ "الإجراءات" على هذا النحو، يستخدم "مساعد Google"
يتطابق وقت التشغيل مع هدف النظام actions.intent.MAIN.
لإنشاء الاستدعاء الرئيسي:
إنشاء عمليات استدعاء الروابط المؤدية إلى صفحات في التطبيق
لإنشاء عمليات استدعاء الروابط المؤدية إلى صفحات في التطبيق، يمكنك إنشاء نوايا المستخدمين العالمية من خلال التدريب.
العبارات التي تحدد البيانات التي أدخلها المستخدم والتي تريد ضبطها لرابط الصفحة في التطبيق.
يقول المستخدمون إنّ الاسم المعروض الخاص بك مع عبارة الربط بصفحة معيّنة مطلوب حملها
استدعاء رابط لصفحة في التطبيق (على سبيل المثال، "Ok Google، تحدث إلى <display
name> إلى <deep link terms>")
إنشاء استدعاءات ضمنية
يتيح الاستدعاء الضمني للمستخدمين استدعاء الإجراء الخاص بك بدون استخدام
اسم العرض. للعثور على المهام المطابقة، تستخدم Google إشارات، مثل المستخدمين.
إخبار "مساعد Google" بتنفيذ إجراءات مشابهة لإحدى عبارات الاستدعاء
لنواياك التي تم ضبطها، أو عندما يكون المستخدِم في سياق تكون فيه إجراءاتك
سيكون مناسبًا.
التعامل مع أحداث الاستدعاء
عندما يطابق "مساعد Google" أحد الأهداف العالمية، فإنّه يؤدي إلى تشغيل حدث
يمكنها المعالجة باستخدام معالج. توضّح الأقسام التالية شكل المعالج
يمكنك تنفيذها (يمكنك اختيار واحد أو أي مزيج من الثلاثة).
تشغيل ردّ تلقائي على الويب
يمكن لمعالِج intent أن يفوّض خدمة ويب عن طريق تشغيل حدث ردّ تلقائي على الويب.
لتشغيل ردّ تلقائي على الويب وتجهيز خدمة ويب لمعالجة الاستدعاء:
الطلبات
يمكن أن يردّ معالج intent بطلب ثابت. عادةً، مطالبات
ترحّب أغراض الاستدعاء بالمستخدم أو توجّهه إلى طريقة استخدام الإجراء
والاستجابة بالمعلومات التي يحتاجها المستخدم على الفور (إجراءات لقطة واحدة).
للتعامل مع مطابقة الرغبة في الاستدعاء من خلال الطلب:
الانتقال إلى مشهد
يمكن أن ينتقل معالج الأهداف إلى مشهد لمعالجة الاستدعاء المطابق.
والنية. يمنحك هذا أكبر قدر من المرونة لتنفيذ المنطق. للانتقال إلى
مشهد:
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eActions Builder allows you to define how users initiate conversations with your Actions using an invocation model.\u003c/p\u003e\n"],["\u003cp\u003eYou can use a main invocation, deep link invocations, or built-in intents to enable users to trigger your Actions.\u003c/p\u003e\n"],["\u003cp\u003eWhen an Action is invoked, you can handle the event through webhooks, static prompts, or transitions to specific scenes within your conversation model.\u003c/p\u003e\n"],["\u003cp\u003eDeep link invocations allow users to jump to specific parts of your Action by using targeted phrases in their requests.\u003c/p\u003e\n"],["\u003cp\u003eImplicit invocation allows users to trigger your Action without needing to know your project's display name, relying on contextual cues and system intents.\u003c/p\u003e\n"]]],["Invocation models define how users start conversations with Actions. Key invocation types include: **Main invocation**, triggered by \"Ok Google, talk to [display name]\"; **Deep link invocations**, using custom phrases like \"talk to [display name] to [deep link phrase]\"; and **Built-in intents**, allowing invocation without the display name, such as \"Ok Google, play a game\". Upon invocation, a handler can trigger a webhook, respond with a prompt, or transition to a scene for further logic processing.\n"],null,[]]
