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”。操作包必须声明至少一个操作。

fulfillment

object (Fulfillment)

如何执行此操作。

intent

object (Intent)

此操作实现的 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 的字段。

useDialogflowFulfillment

boolean

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

意向

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

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

string

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

parameters[]

object (Parameter)

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

trigger

object (Trigger)

此 intent 的触发规范。

参数

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

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

string

参数的名称,例如color

type

string

参数的类型。可以是常见类型或声明为操作软件包一部分的自定义类型,例如Color

触发器

触发器的规范。

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

string

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