«کنشها» نقاط ورودی به برنامه شما هستند که مدل فراخوانی و کاوش را برای برنامهتان تعریف میکنند. «کنشها» را در فایل JSON که بهعنوان بسته کنش شناخته میشود اعلام میکنید، که بعداً وقتی میخواهید پروژه «کنشها» را برای تأیید آزمایش یا ارسال کنید، آن را در پروژه توسعهدهنده خود بارگذاری میکنید. بسته «کنش» فایل JSON است که «کنشها» را در پروژه «کنشها» تعریف میکند.
برای تعریف «کنشها» در بسته «کنش»، قصدی ایجاد میکنید که نحوه فراخوانی «کنش» و نقطه پایانی اجرای متناظر را برای زمانی که قصد راهاندازی میشود تعریف میکند. میتوانید انواع «کنشهای» زیر را ایجاد کنید:
- کنش پیشفرض: هر پروژه Actions باید قصد خوشامدگویی داشته باشد که بهعنوان نقطه ورودی برای کاربران برای شروع مکالمه عمل کند. قصد خوشامدگویی زمانی راهاندازی میشود که کاربران بهطور صریح با گفتن نام «کنش» آن را فراخوانی کنند (برای مثال، «Ok Google، با ExampleAction صحبت کن»). این قصد خوشامدگویی با نام قصد
actions.intent.MAINشناسایی میشود. - «کنشهای» اضافی برای پیوند عمیق: میتوانید «کنشهای» اضافی در بسته «کنش» خود با هدفهایی که خودتان تعریف میکنید ایجاد کنید. این کار به کاربران اجازه میدهد با گفتن نام «کنش» بههمراه هدف، عملکرد خاصی را فراخوانی کنند (برای مثال: «Ok Google، با ExampleAction صحبت کن تا چند کفش پیدا کند»).
برای اطلاعات بیشتر درباره نحوه عملکرد این مدلهای فراخوانی، هدفها و فراخوانی را ببینید.
تعریف کردن «کنش» پیشفرض
هر بسته «کنش» باید فقط و فقط یک قصد داشته باشد که قصد
actions.intent.MAIN را مدیریت کند. این هدف زمانی راهاندازی میشود که کاربران «کنش» شما را با نام فراخوانی کنند (برای مثال، «Ok Google، با ExampleAction صحبت کن»).
برای تولید فایل بسته «کنش» تکراری با نام action.json، مراحل زیر را دنبال کنید:
gactionsCLI را بارگیری کنید.- فهرست راهنمای محلی برای فایلهای منبع پروژه «کنش» خود ایجاد کنید.
فرمانهای زیر را در پایانه اجرا کنید:
$ cd PROJECT_DIRECTORY $ gactions init
وقتی فایل بسته Action تولید شد، محتوای جایبان را با مقادیر خودتان جایگزین کنید. در اینجا مثالی از action.json با تغییرات ExampleAction آورده شده است:
{
"actions": [
{
"description": "Default welcome intent",
"name": "MAIN",
"fulfillment": {
"conversationName": "ExampleAction"
},
"intent": {
"name": "actions.intent.MAIN",
"trigger": {
"queryPatterns": [
"talk to ExampleAction"
]
}
}
}
],
"conversations": {
"ExampleAction": {
"name": "ExampleAction",
"url": "https://www.example.com/ExampleAction"
}
},
"locale": "en"
}تعریف کردن کنشهای بیشتر
میتوانید «کنشهای» دیگری ارائه دهید که بهعنوان نقطه ورود عمل میکنند. این کار به کاربران اجازه میدهد با مشخص کردن جزئیات بیشتر درباره کاری که میخواهند انجام دهند، ابهام قصدشان را برطرف کنند (برای مثال، «Ok Google, talk to ExampleAction to find me some shoes.»).
برای تعریف کردن «کنشهای» بیشتر:
-
در آرایه
برای مثال، کد زیر «کنش» «خرید» دیگری را نشان میدهد که موارد زیر را تعریف میکند:actions، برای هر نقطه ورودی یک «کنش» مشخص کنید.- نام هدف
com.example.ExampleAction.BUY parametersبرای تجزیه کردن از ورودی کاربر هنگام فعال شدن این هدف. این زمانی مفید است که به دادههای خاصی از عبارت «کنش» نیاز دارید، وقتی کاربران «کنش» را فراخوانی میکنند.queryPatternsکه مشخص میکند کاربران برای راهاندازی قصد باید چه بگویند. الگوهای پُرسمان میتوانند شامل انواع Schema.org باشند که پارامترها را برای تجزیه تعریف میکنند.
{ "description": "Direct access", "name": "BUY", "fulfillment": { "conversationName": "ExampleAction" }, "intent": { "name": "com.example.ExampleAction.BUY", "parameters": [ { "name": "color", "type": "org.schema.type.Color" } ], "trigger": { "queryPatterns": [ "find some $org.schema.type.Color:color sneakers", "buy some blue suede shoes", "get running shoes" ] } } }
- نام هدف
-
با مشخص کردن
conversationNameکه با موردی در شیءconversationsمطابقت دارد، برآوردهسازی این قصد را مشخص کنید.{ "conversations": { "ExampleAction": { "name": "ExampleAction", "url": "https://www.example.com/ExampleAction" } } }
در اینجا نمونهای از بسته کامل «کنش» آورده شده است:
{ "actions": [ { "description": "Default welcome intent", "name": "MAIN", "fulfillment": { "conversationName": "ExampleAction" }, "intent": { "name": "actions.intent.MAIN", "trigger": { "queryPatterns": [ "talk to ExampleAction" ] } } }, { "description": "Direct access", "name": "BUY", "fulfillment": { "conversationName": "ExampleAction" }, "intent": { "name": "com.example.ExampleAction.BUY", "parameters": [ { "name": "color", "type": "org.schema.type.Color" } ], "trigger": { "queryPatterns": [ "find some $org.schema.type.Color:color sneakers", "buy some blue suede shoes", "get running shoes" ] } } } ], "conversations": { "ExampleAction": { "name": "ExampleAction", "url": "https://www.example.com/ExampleAction" } }, "locale": "en" }