Action

動作代表動作專案支援的特定互動。互動可以是單一或多個步驟。

JSON 表示法
{
  "name": string,
  "fulfillment": {
    object (Fulfillment)
  },
  "intent": {
    object (Intent)
  },
  "description": string,
  "signInRequired": boolean,
  "source": string
}
欄位
name

string

動作名稱即使您使用的是常見的「在 Google 上執行動作」意圖 (開頭為「actions」),您仍須提供名稱。舉例來說,如果您使用「actions.intent.MAIN」意圖,依慣例顯示的動作名稱為「MAIN」。動作套件必須宣告至少一個動作。

fulfillment

object (Fulfillment)

如何執行這項動作。

intent

object (Intent)

這個動作執行的意圖。常見 Actions on Google 意圖的名稱會以「actions」開頭。對話型代理程式的動作套件必須具備名為「actions.intent.MAIN」的意圖。詳情請參閱 https://developers.google.com/actions/reference/rest/intents

description

string

動作的英文說明。這些資訊主要用於 Google 審查動作或偵錯。使用者不會看到這項說明。而且不得超過 100 個 ASCII 字母。

signInRequired

boolean

指出此動作是否需要登入。請注意,只有在 ActionPackage 物件指定了 AccountLinking 屬性的情況下,才有效。

source
(deprecated)

string

建立這項動作的工具所使用的字串 ID

Fulfillment

如何執行動作。

JSON 表示法
{

  // Union field conversation can be only one of the following:
  "conversationName": string,
  "useDialogflowFulfillment": boolean
  // End of list of possible types for union field conversation.
}
欄位

聯集欄位 conversation

conversation 只能採用下列其中一種設定:

conversationName

string

透過對話執行要求執行動作。這會參照「name」「ActionPackage.conversations」欄位中 Conversations 的欄位。

useDialogflowFulfillment

boolean

這個欄位會指出是否要使用 Dialogflow 執行要求。

Intent

意圖及其相關聯的查詢模式,用於比對使用者的查詢。用於初始觸發。

JSON 表示法
{
  "name": string,
  "parameters": [
    {
      object (Parameter)
    }
  ],
  "trigger": {
    object (Trigger)
  }
}
欄位
name

string

表示這項意圖的名稱,例如BOOK_A_TABLE。可以是內建意圖 (從 actions. 開始)。在這種情況下,系統會隱含參數和查詢模式,因此會遭到忽略。

parameters[]

object (Parameter)

queryPatterns 中的參數清單。必須提供 queryPatterns 中的所有參數。

trigger

object (Trigger)

這項意圖的觸發規格。

參數

查詢定位器中使用的參數。這是 queryPatterns 中參數的結構化表示法 (例如 $Color:color)。

JSON 表示法
{
  "name": string,
  "type": string
}
欄位
name

string

參數的名稱,例如color

type

string

參數類型。可以是動作套件中宣告的常見類型或自訂類型,例如Color

觸發條件

觸發條件的規格。

JSON 表示法
{
  "queryPatterns": [
    string
  ]
}
欄位
queryPatterns[]

string

用於識別指定意圖的模式清單。查詢模式只能參照參數欄位中宣告的參數。