构建调用模型

调用模型指定用户如何调用项目中的 Action。当用户调用某个 Action 时,他们便会与 Action 开始对话,该对话由您的对话模型定义。您可以通过以下方式定义调用:

  • 主调用 - 这是您的 Actions 项目唯一必需的调用。用户说出类似于“Ok Google, talk to <display name>”的语句,即可匹配该 intent。您通常采用欢迎辞来问候用户,以此方式处理该 intent。

  • 深层链接调用 - 这些是可选的调用,可让您在自定义 intent 中定义训练短语,以便用户可以深层链接到对话中的特定部分。用户可以说类似于“Ok Google,与<display name>对话” 和<deep linkphrase>"来匹配这些类型的意图(例如,“Ok Google,跟 Google 的真相交谈,了解公司事实”

  • 内置 intent - 这些是可选调用,可让您利用系统定义的调用模型。通过声明对内置 intent 的支持,用户可以发现和调用您的 Actions 项目,而无需指定您的显示名称。例如,用户可以说“Ok Google,玩游戏”,然后 Google 助理就可以显示您的 Action 作为调用选项。

图 1.调用模型由有资格与您的 Action 开始对话的所有 intent 组成。

创建主调用

每个 Actions 项目都有一个默认的主调用,充当您的 Actions 项目的默认入口点。此调用的语言模型与项目的显示名称相关联,因此用户只需说类似于“Ok Google, talk to <display name>”的指令即可使用此调用。当用户以这种方式调用您的 Action 时,Google 助理运行时会与 actions.intent.MAIN 系统 intent 匹配。

如需创建主调用,请执行以下操作:

如需构建深层链接调用,您可以使用训练短语创建全局用户 intent,这些短语用于定义您要为深层链接设置的用户输入。用户说出您的显示名称与深层链接短语的组合,以执行深层链接调用(例如,“Ok Google,跟 <display name> 交谈”对<deep linkphrase>"

创建隐式调用

隐式调用可让用户在不使用项目的显示名称的情况下调用您的 Action。为了查找匹配的 Action,Google 会使用各种信号,例如用户指示 Google 助理执行类似于您配置的其中一个 intent 的调用短语的操作,或者在用户处于您的 Action 合适的上下文中时。

处理调用事件

当 Google 助理与您的某个全局 intent 匹配时,它会触发一个事件,您可以使用处理程序对其进行处理。下面几部分介绍了处理程序可以执行的操作(您可以选择其中一项,也可以三者的任意组合)。

触发网络钩子

您的 intent 处理程序可以通过触发 webhook 事件来将 intent 委托给网络服务。如需触发 webhook 并让网络服务处理调用,请执行以下操作:

提示

intent 处理程序可以使用静态提示进行响应。通常,调用 intent 的提示会欢迎用户,为他们提供如何使用 Action 的指导,或者直接提供用户所需的信息作为响应(一次性 Action)。

如需处理包含提示的调用 intent 匹配,请执行以下操作:

过渡到场景

您的 intent 处理程序可以过渡到场景来处理匹配的调用 intent。这样可以以极大的灵活性执行逻辑。如需过渡到场景,请执行以下操作: