意圖是描述操作方式的訊息物件。有兩種方式可以使用意圖:
- 提供意圖的執行要求,或
- 透過要求 Google 助理執行意圖。
對於使用 Dialogflow 建構和使用 Actions SDK 建構的開發人員來說,您為意圖提供執行要求的程序不同。不過,在這兩種情況下,您都要提供意圖的名稱和執行要求 Webhook 的網址。這樣做可以告知 Actions on Google,您可以支援符合意圖的使用者查詢。
如要要求執行意圖,您可以在回應 Google 助理時,在 possibleIntents
物件中指定意圖。在對執行要求後續要求中,Google 助理會將已處理的意圖的結果傳回給您。詳情請參閱輔助程式使用情形總覽。
常用意圖
下表說明 Google 助理要求您執行的意圖。
Intent (意圖名稱) | 使用方法 | Dialogflow 事件 |
---|---|---|
actions.intent.MAIN |
必要:每個動作套件只宣告一個意圖,只有一個意圖做為使用者啟動對話的進入點。 | WELCOME 或 GOOGLE_ASSISTANT_WELCOME |
actions.intent.TEXT |
取得使用者要求的原始文字表示法。經常用到與使用者互動。 | |
actions.intent.CANCEL |
如果您在動作套件中選擇接收取消意圖,就會收到這個意圖。使用者說出「結束」等全域取消指令時,您會在下一個對執行要求發出的要求中收到此意圖,因此您可以使用最終訊息回應,並在執行要求邏輯中執行所有清理作業。 | actions_intent_CANCEL |
actions.intent.NO_INPUT |
如果您在動作套件中選擇接收無輸入意圖,就會收到這個意圖。如果使用者沒有回應提示,您會在下一個對執行要求發出的要求中收到此意圖。 | actions_intent_NO_INPUT |
協助人員
下表說明您可以要求 Google 助理完成哪些受支援的輔助程式。
Intent (意圖名稱) | 使用方法 | Dialogflow 事件 |
---|---|---|
actions.intent.PERMISSION |
取得使用者的全名、概略位置或精確位置,或是全部 3。 | actions_intent_PERMISSION |
actions.intent.OPTION |
透過清單或輪轉介面 UI 接收所選項目。或者,如果使用者不是從清單或輪轉介面 UI 中選取,則會接收與清單或輪轉介面 UI 中鍵相符的語音或文字輸入內容。 | 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 |
要求使用者授予其他 Google 助理途徑的權限。 | actions_intent_NEW_SURFACE |
內建意圖
內建意圖會模擬使用者嘗試的任務或需要的資訊,例如訂購餐點、預訂行程或查看帳戶餘額等。詳情請參閱「內建意圖參考資料」。
其他意圖
大多數的對話動作皆結合通用意圖、輔助程式和回應建構而成。不過,如果動作包含交易或每日更新等其他功能,就可以存取這些功能專屬的意圖。
交易小幫手
下表說明協助程式處理您可以要求 Google 助理完成的購買交易。如要進一步瞭解如何實作這些意圖及其他相關意圖,請參閱交易功能說明文件。
Intent (意圖名稱) | 使用方法 | 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 |
使用者參與度意圖
下表說明與使用者參與度功能相關的意圖。如要進一步瞭解如何實作這些意圖和其他相關意圖,請參閱「使用者參與度」功能說明文件。
Intent (意圖名稱) | 提供執行要求 | 要求履行 | 使用方法 | Dialogflow 事件 |
---|---|---|---|---|
actions.intent.REGISTER_UPDATE |
X | 要求使用者註冊更新內容。 | actions_intent_REGISTER_UPDATE |
|
actions.intent.CONFIGURE_UPDATES |
X | 當使用者嘗試註冊更新內容 (即應傳送 REGISTER_UPDATE 意圖) 時,您就會收到此意圖。 | actions_intent_CONFIGURE_UPDATES |
自訂意圖
您可以建立自己的意圖來定義對話的捷徑,協助使用者更有效率地完成工作。這些意圖位於您自己的命名空間中;您可以定義使用者觸發意圖的方式,而動作套件是唯一能支援這些意圖的動作套件。
詳情請參閱在 Dialogflow 中定義動作或使用 Actions SDK 定義動作。如要進一步瞭解動作套件,請參閱「動作套件參考資料」說明文件。
智慧型住宅意圖
如果您要建構智慧型住宅動作,就必須以稍微不同的方式定義意圖支援。詳情請參閱「智慧型住宅意圖」說明文件。