意圖總覽 (Dialogflow)

意圖是描述操作方式的訊息物件。有兩種方式可以使用意圖:

  • 提供意圖的執行要求,或
  • 透過要求 Google 助理執行意圖。

對於使用 Dialogflow 建構使用 Actions SDK 建構的開發人員來說,您為意圖提供執行要求的程序不同。不過,在這兩種情況下,您都要提供意圖的名稱和執行要求 Webhook 的網址。這樣做可以告知 Actions on Google,您可以支援符合意圖的使用者查詢。

如要要求執行意圖,您可以在回應 Google 助理時,在 possibleIntents 物件中指定意圖。在對執行要求後續要求中,Google 助理會將已處理的意圖的結果傳回給您。詳情請參閱輔助程式使用情形總覽

常用意圖

下表說明 Google 助理要求您執行的意圖。

Intent (意圖名稱) 使用方法 Dialogflow 事件
actions.intent.MAIN 必要:每個動作套件只宣告一個意圖,只有一個意圖做為使用者啟動對話的進入點。 WELCOMEGOOGLE_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 定義動作。如要進一步瞭解動作套件,請參閱「動作套件參考資料」說明文件。

智慧型住宅意圖

如果您要建構智慧型住宅動作,就必須以稍微不同的方式定義意圖支援。詳情請參閱「智慧型住宅意圖」說明文件。