یک intent داخلی یک شناسه منحصر به فرد است که می توانید آن را مشخص کنید تا به Assistant بگویید که Action شما می تواند دسته خاصی از درخواست های کاربر را برآورده کند. مقاصد داخلی به کاربران اجازه می دهد تا بدون استفاده از نام نمایشی پروژه شما، اقدام شما را فراخوانی کنند. برای یافتن کنش‌های منطبق، دستیار Google تعیین می‌کند که آیا کاربر می‌خواهد کاری مشابه عبارت فراخوانی را برای یکی از مقاصد پیکربندی‌شده شما انجام دهد، یا زمانی که کاربر در زمینه‌ای است که اقدامات شما مناسب است.
برای مثال، در اینجا برخی از درخواست‌های کاربر وجود دارد که Assistant با اهداف داخلی مطابقت دارد:
- هدف داخلی "بازی بازی" : "Ok Google. یک بازی حافظه بازی کنید"
- هدف داخلی "Teach me something new" : "Ok Google. Teach me something new"
- هدف داخلی "داستان سرایی" : "Ok Google. Tell me a story time time"
در حین کشف Action ، Assistant می‌تواند از فراداده‌های مربوط به Action شما، از جمله اهداف داخلی که مشخص کرده‌اید، استفاده کند تا Action شما را به کاربران توصیه کند. برای به حداقل رساندن رفت‌وآمدهای مکالمه‌ای، دستیار همچنین سعی می‌کند پارامترهای درخواست‌های کاربر را اسکن کند و آنها را به Action شما منتقل کند.
اگر Action خود را با استفاده از Actions SDK توسعه می‌دهید، مطمئن شوید که از نسخه 3.1.0 یا بالاتر باینری gactions برای استفاده از مقاصد داخلی استفاده می‌کنید.
پارامترهای فراخوانی
برخی از intent های داخلی دارای مقادیر پارامتر هستند که برای دسته بندی بیشتر Action برای کشف شما استفاده می شود. به عنوان مثال، قصد داخلی داستان سرایی دارای مقادیر پارامتر ژانر است. کاربران می‌توانند با درخواست‌هایی مانند «Ok Google. Tell Me a Adventure Story» ، این مقادیر را در جستجوی خود برای «دستیار» بگنجانند.
برای جزئیات بیشتر در مورد مقادیر پارامترهای خاص، بخش داستان سرایی و آموزشی را ببینید.
بازی با هدف داخلی بازی کنید
هدف داخلی Play Game قابلیت شناسایی اضافی Action شما را به کاربران Assistant می‌دهد که درخواست‌هایی مانند «Okay Google. Play a game» را ارائه می‌کنند.
برای اطلاعات بیشتر در مورد توسعه و راهنمایی بازی Assistant، به راهنمای طراحی بازی برای Google Assistant مراجعه کنید.
راه اندازی کنید
برای تنظیم برنامه Play Game intent داخلی، این مراحل را دنبال کنید:
- به کنسول Actions بروید.
- پروژه جدید را کلیک کنید، نام پروژه را وارد کنید و روی ایجاد پروژه کلیک کنید.
داستان سرایی با هدف داخلی
هدف داخلی داستان‌گویی، اقدام شما را برای کشف داستان‌سرایی بیشتر از طریق درخواست‌های «دستیار» مانند «Okay Google. Tell me a princess story» ثبت می‌کند.
اقدامات داستان گویی باید از این دستورالعمل های سطح بالا پیروی کند:
- اکشن شما به تبدیل متن به گفتار به عنوان صدای داستان سرایی اصلی متکی نیست
- از اکشن شما باید با صفحه یا بدون صفحه لذت ببرید
- اقدام شما باید خانواده پسند باشد
پارامترهای فراخوانی
پارامترهای فراخوانی برای هدف داخلی داستان سرایی نشان دهنده ژانرهایی است که کاربران می توانند در درخواست خود برای شنیدن یک داستان بگنجانند. این پارامترها می توانند کشف شما را در ژانرهای درخواستی بهبود بخشند:
| ژانر (اکشن ساز) | مقدار پارامتر (SDK) |
|---|---|
| ماجراجویی | ADVENTURE |
| زمان خواب | BEDTIME |
| فانتزی | FANTASY |
| تعاملی | INTERACTIVE |
| شاهزاده خانم | PRINCESS |
راه اندازی کنید
برای تنظیم هدف داخلی داستان گویی، این مراحل را دنبال کنید:
- به کنسول Actions بروید.
- پروژه جدید را کلیک کنید، نام پروژه را وارد کنید و روی ایجاد پروژه کلیک کنید.
آموزش ساخته شده در قصد
هدف آموزشی داخلی، اقدام شما برای کشف آموزش اضافی را از طریق درخواست‌های «دستیار» مانند «Okay Google. Teach me something new» ثبت می‌کند.
اقدامات آموزشی باید از این دستورالعمل های سطح بالا پیروی کند:
هدف شما باید آموزش یا کمک به یادگیری باشد
Action شما برای تبلیغات یا ابزارهای استخدام در نظر گرفته نشده است
اکشن شما بر مهارت ها و دانش متمرکز است
اکشن شما مهارت ها و دانش تثبیت شده را می آموزد
اطلاعاتی که Action شما آموزش می دهد مبتنی بر عقیده یا نتیجه رویدادهای جاری نیست
پارامترهای فراخوانی
پارامترهای فراخوانی برای هدف آموزشی، موضوعات یادگیری را نشان می‌دهند که کاربران می‌توانند در درخواست‌های خود بگنجانند. این پارامترها می توانند کشف شما را در موضوعات یادگیری درخواستی بهبود بخشند:
| موضوع آموزشی (Actions Builder) | مقدار پارامتر (SDK) |
|---|---|
| یک زبان جدید یاد بگیرید | LANGUAGE |
| درباره دنیای طبیعی بیشتر بدانید | WORLD |
| یک مهارت جدید یاد بگیرید | SKILL |
| با خانواده یاد بگیرید | FAMILY |
راه اندازی کنید
برای تنظیم هدف آموزشی داخلی، این مراحل را دنبال کنید:
- به کنسول Actions بروید.
- پروژه جدید را کلیک کنید، نام پروژه را وارد کنید و روی ایجاد پروژه کلیک کنید.