提示

提示定义了 Action 如何对用户做出响应，以及 Action 如何呈现给用户提示他们继续操作。构建 Action 时，你可以向调用和场景中的不同位置。提示可以像也可以是更复杂且包含丰富内容（如卡片、图片和表格

响应类型

对于每个问题，你都可以从各种有吸引力的回答类型中进行选择要向用户显示内容的 Google 助理：

简单响应：简单响应会直观地呈现聊天气泡的形式并使用文字转语音 (TTS) 或语音合成标记语言 (SSML) 声音。简单响应是所有设备类型唯一支持的响应。
丰富的响应：丰富的响应包含增强用户与 Action 的互动。借助丰富的响应，您还可以显示表格数据或播放较长的音频内容。
视觉选择响应：视觉选择响应会直观地提供供用户在通过标题或图片进行区分。
媒体响应：媒体响应可让您的 Action 播放较长的音频内容（而非 SSML），并提供带有媒体控件的可视组件。
Interactive Canvas：Interactive Canvas 以全屏模式呈现响应作为一种交互式 Web 应用，Google 助理会将其作为在对话中对用户作出响应。Canvas 使用的提示略有不同以便更灵活地满足 HTML、CSS 和 JavaScript。

这些响应类型都使用相同的基本提示格式，并且可以访问与下文所述的那些常规功能相同。

提示的格式

在 Actions 项目中，您可以定义 YAML 或 JSON 格式的提示。每个提示最多可以包含两个简单响应，并且可以选择性地定义响应。响应的定义方式如下：

first_simple：要发送给用户的初始文本或语音（简单）响应。
content：在简单响应后发送的补充富响应内容。
last_simple 发送给用户的最终文本或语音（简单）响应。
canvas：引用与 Interactive Canvas 集成的 Web 应用。

默认情况下，系统会在提示中按照上述顺序将各项提示附加到另一提示中队列。在用户可以回复之前，Google 助理会向用户显示所有提示输入到提示队列中。

您还可以使用以下功能灵活选择提示：

候选定位设置：借助候选定位设置，您可以根据用户的设备功能例如，您可以让 Google 助理显示响应。设备。
变体：变体是指某条消息的替代变体。例如，你可以让 Google 助理在五种不同的欢迎词之间进行选择消息变体。
建议：建议可为用户提供显示器在 Google 助理显示提示时显示建议内容信息卡的设备。

默认提示使用一个候选字词、一个变体和 first_simple 响应。

候选人

在提示中，candidates 对象允许您根据用户的设备功能例如，您可以让 Google 助理显示响应。设备。如需定义 Google 助理可以返回候选设备的设备类型，请使用 candidates 对象的 selector 属性。

在以下示例中，selector 属性包含设备功能信息。系统会将在第一个候选字词中设置的提示发送给设备用户可呈现丰富响应的高级 API。第二个候选字词包含只能接收文本和语音回复的用户。

YAML

candidates:
  - selector:
      surface_capabilities:
        capabilities:
          - RICH_RESPONSE
    first_simple:
      variants:
        - speech: Here's a simple message.
    content:
      card:
        title: Image card title
        text: Some details about the image
        image:
          url: 'https://www.example.com/image/'
  - first_simple:
      variants:
        - speech: Text explains what the image might have shown in more detail.

JSON

{
  "candidates": [{
    "selector": {
      "surface_capabilities": {
        "capabilities": ["RICH_RESPONSE"]
      }
    },
    "first_simple": {
      "variants": [{
        "speech": "Here's a simple message."
      }]
    },
    "content": {
      "card": {
        "title": "Image card title",
        "text": "Some details about the image",
        "image": {
          "url": "https://www.example.com/image/"
        }
      }
    }
  }, {
    "first_simple": {
      "variants": [{
        "speech": "Text explains what the image might have shown in more detail."
      }]
    }
  }]
}

您可以为指定的候选人提供一项或多项能力要求。通过以下列表介绍了各项可用的功能要求：

SPEECH：设备可以通过文字转语音或 SSML 与用户交谈。
RICH_RESPONSE：设备可以显示丰富的响应，例如卡片、列表和表格。
LONG_FORM_AUDIO：设备可以播放音乐等长篇幅音频媒体播客。
INTERACTIVE_CANVAS：设备可以显示 Interactive Canvas 响应。
WEB_LINK：设备可以使用富响应中的网页链接来打开网络浏览器。
HOME_STORAGE：设备可以存储和访问家庭存储空间中的数据。

变体

变体提供了一种定义响应的多个版本的方法。当 Google 助理时将提示发送给用户，系统会随机选择一个变体。最佳进行对话设计的练习，他们与您的 Action 对话。

例如，提供不同的欢迎辞变体，以便用户听不到每次调用您的 Action 时都返回相同的响应：

YAML

candidates:
  - first_simple:
      variants:
        - speech: Hello.
        - speech: Hi there.
        - speech: Welcome.

JSON

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Hello."
      },{
        "speech": "Hi there."
      },{
        "speech": "Welcome."
      }]
    }
  }]
}

建议

在以下情况下，建议会为支持显示的设备提供建议内容信息条： Google 助理会显示相应提示。使用建议内容信息卡提示用户继续对话或进行对话转换。用户点按后，建议内容信息卡会返回一字不差地显示文本到对话中，就好像用户已经输入了一样。

单个提示中最多可以包含 8 条建议，每条建议最多可以上限为 25 个明文字符。

如需添加建议，请提供包含每个建议的 Suggestion 对象显示在单独的 title 字段中。每个影视内容都必须在一组内容中是唯一的一系列建议内容信息卡在 Actions Builder 中，此对象以 YAML 格式表示，采用 suggestions 格式。

例如，您可以提供“是”。和“否”建议的做法：

YAML

candidates:
  - first_simple:
      variants:
        - speech: 'Welcome, do you want to play a game?'
    suggestions:
      - title: 'Yes'
      - title: 'No'

JSON

{
  "candidates": [{
    "first_simple": {
      "variants": [{
        "speech": "Welcome, do you want to play a game?"
      }]
    },
    "suggestions": [{
      "title": "Yes"
    }, {
      "title": "No"
    }]
  }]
}