Actions SDK 總覽 (Dialogflow)

Actions on Google 可讓你利用 動作。動作可讓使用者透過對話式介面完成工作 無論是透過快捷指令來開燈或更長的時間 像是玩益智問答遊戲

Actions SDK 是在沒有的情況下開發對話執行要求的方法 您將能透過 Dialogflow 檢視這些圖片使用 Actions SDK 時,您需要使用 Action 套件 可將意圖對應至其執行要求您也必須在 動作套件,用來定義使用者可能會說的範例詞組。

Gactions CLI

使用 Actions SDK 進行開發時,需使用 gactions 指令列 介面 (CLI),測試及更新 Actions 專案。gactions CLI 亦可協助您建立及管理 Conversational Action 動作套件。

在 Action 套件中建立動作

只要將意圖對應至執行要求,即可在動作套件中建立動作。 動作會定義進入點,以不重複的位置發起對話 稱為意圖的 ID意圖會對應至處理 意圖。

舉例來說,假設您想建構的專案含有動作 購買商品、查看訂單狀態,以及顯示一些每日特惠。 您可以說出下列指令來定義所觸發的意圖:

  • 「Ok Google,跟 ExampleAction 交談。」
  • 「Ok Google,使用 ExampleAction 購買一些鞋款。」
  • 「Ok Google,使用範例動作查詢我的訂單。」
  • 「Ok Google,說出 ExampleAction,顯示今日特惠。」

動作套件 JSON 檔案可能如下所示:

{
  "actions": [
    {
      "name": "MAIN",
      "intent": {
        "name": "actions.intent.MAIN"
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "BUY",
      "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"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "ORDER_STATUS",
      "intent": {
        "name": "com.example.ExampleAction.ORDER_STATUS",
        "trigger": {
          "queryPatterns": [
            "check on my order",
            "see order updates",
            "check where my order is"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    },
    {
      "name": "DAILY_DEALS",
      "intent": {
        "name": "com.example.ExampleAction.DAILY_DEALS",
        "trigger": {
          "queryPatterns": [
            "hear about daily deals",
            "buying some daily deals",
            "get today's deals"
          ]
        }
      },
      "fulfillment": {
        "conversationName": "ExampleAction"
      }
    }
  ],
  "conversations": {
    "ExampleAction": {
      "name": "ExampleAction",
      "url": "https://www.example.com/ExampleAction"
    }
  }
}

建構及部署執行要求 Webhook

叫用專案中的動作時,Actions on Google 會呼叫 應用程式執行要求,來與使用者展開對話,協助他們執行動作。

在每個傳送至執行要求 Webhook 的要求中,您會收到使用者輸入內容 文字字串。為了處理意圖,您通常會剖析文字輸入內容 傳回回應。此次來回交換會持續到動作發生 對話結束。

上傳 Action 套件

建立 Action 套件部署執行要求後, 你可以將動作套件上傳至 Actions 主控台動作控制台 透過 Action 專案,將 Conversational Action 與中繼資料等中繼資料分組 「Google 助理」目錄中的狀態和顯示名稱這項專案還可讓您 定義動作的中繼資料,以及透過 核准程序。

建立專案後,您可以上傳 Action 套件,當中定義了 使用 gactions CLI 的動作。

將專案送交核准並向使用者發布

範例

如要探索已完成的專案,請參閱 Node.js 和 Java Actions SDK 範例