Action

Action 表示 Action 项目支持的特定互动。互动可以是单样本,也可以是多步。

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

string

Action 的名称。即使您使用的是常用的 Action on Google intent(以“actions.”开头),也必须提供一个名称。例如,如果您使用的是“actions.intent.MAIN” intent,则按照惯例,操作名称为“MAIN”。Action 包必须声明至少一个 Action。

fulfillment

object (Fulfillment)

如何执行此操作。

intent

object (Intent)

此 Action 执行的 intent。常见 Action on Google intent 的名称以“actions.”开头。对话代理的操作包必须具有名为“actions.intent.MAIN”的 intent。请访问 https://developers.google.com/actions/reference/rest/intents

description

string

关于 Action 用途的英文说明。这主要供 Google 审核 Action 或用于调试目的。此说明不会向用户显示。必须少于 100 个 ASCII 字母。

signInRequired

boolean

指明此操作是否需要登录。请注意,仅当 ActionPackage 对象指定了 AccountLinking 属性时,此属性才有效。

source
(deprecated)

string

创建此操作的工具的字符串标识符

履单

如何执行操作。

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

通过对话执行方式执行操作。这里引用了 ActionPackage.conversations 字段中 Conversations 的“name”字段。

useDialogflowFulfillment

boolean

此字段指示是否使用 dialogflow 执行方式。

意向

intent 及其相关查询句式,用于匹配用户的查询。用于初始触发。

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

string

指示此 intent 的名称,例如,BOOK_A_TABLE。可以是从 actions. 开始的内置 intent,在这种情况下,参数和查询格式是隐式的,因此会被忽略。

parameters[]

object (Parameter)

queryPatterns 中的参数列表。必须提供 queryPatterns 中的所有参数。

trigger

object (Trigger)

此 intent 的触发规范。

参数

查询模式中使用的参数。这是 queryPatterns 中的参数的结构化表示法(例如 $Color:color)。

JSON 表示法
{
  "name": string,
  "type": string
}
字段
name

string

参数的名称,例如 color

type

string

参数的类型。可以是通用类型,也可以是在 Action 包中声明的自定义类型,例如 Color

触发器

触发器的规范。

JSON 表示法
{
  "queryPatterns": [
    string
  ]
}
字段
queryPatterns[]

string

用于标识指定 intent 的模式列表。查询句式必须仅引用参数字段中声明的参数。