Intent ها اشیاء پیام رسانی هستند که نحوه انجام کاری را توضیح می دهند. می توانید از Intent به یکی از دو روش استفاده کنید:
- با فراهم آوردن تحقق برای یک قصد، یا
- با درخواست تحقق یک هدف توسط Google Assistant.
فرآیندی که توسط آن شما برای یک intent انجام می دهید برای توسعه دهندگانی که با Dialogflow می سازند و برای توسعه دهندگانی که با Actions SDK می سازند متفاوت است. با این حال، در هر دو مورد، شما نام هدف و نشانی اینترنتی وب‌قلاب تکمیلی خود را ارائه می‌دهید. این به Actions on Google می‌گوید که می‌توانید از درخواست‌های کاربر مطابق با هدف پشتیبانی کنید.
برای درخواست تحقق یک intent، هنگام پاسخ به دستیار، هدف را در شی possibleIntents مشخص می‌کنید. در درخواست بعدی برای تحقق شما، دستیار نتیجه قصد پردازش شده را به شما برمی گرداند. برای اطلاعات بیشتر، نمای کلی استفاده از Helpers را بخوانید.
مقاصد مشترک
جدول زیر اهدافی را که «دستیار» از شما درخواست می‌کند، توضیح می‌دهد.
| نام قصد | استفاده | رویداد Dialogflow |
|---|---|---|
actions.intent.MAIN | مورد نیاز : هر بسته Action یک و تنها یک هدف را اعلام می کند که به عنوان نقطه ورود کاربران برای شروع مکالمات عمل می کند. | WELCOME یا GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT | دریافت نمایش متن خام درخواست کاربر. شما بیشتر اوقات هنگام مکالمه با کاربران از آن استفاده می کنید. | |
actions.intent.CANCEL | این هدف را زمانی دریافت می‌کنید که در بسته اقدام خود ، قصد لغو را انتخاب کنید . هنگامی که کاربران یک فرمان لغو جهانی مانند "خروج" را می گویند، شما این هدف را در درخواست بعدی برای انجام خود دریافت می کنید، بنابراین می توانید با یک پیام نهایی پاسخ دهید و هرگونه پاکسازی را در منطق تحقق خود انجام دهید. | actions_intent_CANCEL |
actions.intent.NO_INPUT | زمانی این هدف را دریافت می‌کنید که در بسته اکشن خود ، مقاصد بدون ورودی را دریافت کنید . هنگامی که کاربران به یک درخواست پاسخ نمی دهند، این هدف را در درخواست بعدی برای انجام خود دریافت می کنید. | actions_intent_NO_INPUT |
یاوران
جدول زیر کمک‌های پشتیبانی‌شده را توضیح می‌دهد که می‌توانید از «دستیار» درخواست کنید تا آنها را برآورده کند.
| نام قصد | استفاده | رویداد 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 | از کاربر اجازه می‌خواهد تا به سطح دستیار دیگری تحویل دهد . | actions_intent_NEW_SURFACE |
مقاصد داخلی
مقاصد داخلی برخی از روش‌های رایجی را که کاربران وظایفی را که می‌خواهند انجام دهند یا اطلاعاتی را که به دنبال آن هستند بیان می‌کنند، مانند سفارش غذا، رزرو سفر یا بررسی موجودی حساب، مدل‌سازی می‌کنند. برای اطلاعات بیشتر به مرجع intents داخلی مراجعه کنید.
مقاصد اضافی
بیشتر کنش‌های مکالمه با ترکیبی از اهداف، کمک‌کننده‌ها و پاسخ‌های مشترک ساخته می‌شوند. با این حال، اقداماتی که ویژگی‌های اضافی مانند تراکنش‌ها یا به‌روزرسانی‌های روزانه را در خود جای می‌دهند، به اهداف خاص آن ویژگی‌ها دسترسی دارند.
کمک های معاملاتی
جدول زیر کمک‌های مربوط به رسیدگی به خریدها را توضیح می‌دهد که می‌توانید از «دستیار» درخواست کنید تا انجام دهد. می توانید اطلاعات بیشتری در مورد نحوه پیاده سازی این اهداف و سایر اهداف مرتبط در اسناد ویژگی تراکنش ها بیابید.
| نام قصد | استفاده | رویداد 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 |
اهداف تعامل کاربر
جدول زیر اهداف مربوط به ویژگی های تعامل کاربر را توضیح می دهد. می‌توانید اطلاعات بیشتری درباره نحوه پیاده‌سازی این اهداف و سایر اهداف مرتبط در مستندات ویژگی تعامل کاربر بیابید.
| نام قصد | تحقق را فراهم کند | درخواست برآورده شدن | استفاده | رویداد Dialogflow |
|---|---|---|---|---|
actions.intent.REGISTER_UPDATE | ایکس | از کاربر می خواهد برای به روز رسانی ثبت نام کند. | actions_intent_REGISTER_UPDATE | |
actions.intent.CONFIGURE_UPDATES | ایکس | هنگامی که کاربر سعی می کند برای به روز رسانی ها ثبت نام کند، این هدف را دریافت می کنید (یعنی یک هدف REGISTER_UPDATE باید ارسال شود). | actions_intent_CONFIGURE_UPDATES |
مقاصد سفارشی
شما می توانید اهداف خود را ایجاد کنید تا میانبرهایی را برای مکالمه تعریف کنید تا به کاربران کمک کنید کارها را کارآمدتر انجام دهند. این مقاصد در فضای نام خود شما قرار دارند. شما تعریف می‌کنید که کاربران چگونه قصدها را راه‌اندازی می‌کنند، و بسته Action شما تنها بسته‌ای است که می‌تواند از آنها پشتیبانی کند.
برای اطلاعات بیشتر، درباره تعریف Actions در Dialogflow یا با Actions SDK بخوانید. شما می توانید اطلاعات بیشتر در مورد بسته های Action را در اسناد مرجع بسته Action بیابید.
اهداف خانه هوشمند
اگر در حال ساخت یک اکشن خانه هوشمند هستید، پشتیبانی از intent ها را به روشی کمی متفاوت تعریف می کنید. برای اطلاعات بیشتر به مستندات اهداف خانه هوشمند مراجعه کنید.