提示定义了 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." }] } }] }
建议
![智能显示屏上的建议内容信息卡示例](https://developers.google.cn/static/assistant/conversational/images/smart-display/chips.png?authuser=0000&hl=ro)
在以下情况下,建议会为支持显示的设备提供建议内容信息条: 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" }] }] }