提示會定義動作轉譯回應呈現結果的方式,以及動作會如何提示使用者繼續操作。建構動作時,您可以為叫用以及情境中的各個位置新增提示。提示可能是簡單的文字或語音回應,或較為複雜,且包含資訊卡、圖片和資料表等多媒體內容。
回應類型
每次提示時,您可以從多種互動式回應類型中選取,以便 Google 助理向使用者顯示:
- 簡單回應:簡易回應會以視覺形式呈現即時通訊泡泡,並使用文字轉語音 (TTS) 或語音合成標記語言 (SSML) 來發出語音。簡易回應是所有類型裝置唯一支援的回應。
- 豐富的回應:複合式回應包含視覺元素或功能元素,可強化使用者與動作的互動情形。透過複合式回應,您還可以顯示表格資料或播放較長的音訊內容。
- 視覺選取回應:視覺選取回應提供視覺化介面,方便使用者選擇多種選項,最容易依標題或圖片區分。
- 媒體回應:媒體回應可讓動作播放大於 SSML 的音訊內容,並使用媒體控制項提供視覺元件。
- 互動式畫布:互動式 Canvas 會以全螢幕網頁檢視和回應的形式,以互動式網頁應用程式的形式呈現,供 Google 助理在對話中回應使用者。為使用 HTML、CSS 和 JavaScript 等網路標準,Canvas 使用格式略有不同的提示格式。
每種回應類型都使用相同的基本提示格式,並且可存取下述的一般功能。
提示格式
在 Actions 專案中,您可以定義 YAML 或 JSON 格式的提示。每個提示內最多可以包含兩個簡單的回應,可以選擇是否定義豐富的回應。回應的定義如下:
first_simple
:要傳送給使用者的初始文字或語音 (簡單) 回應。content
:可在傳送簡單回應後傳送的補充複合式搜尋結果。last_simple
最終傳送給使用者的文字或語音 (簡單) 回應。canvas
:參照與互動式畫布整合的網頁應用程式。
根據預設,提示訊息會按上述順序附加至另一個佇列佇列。使用者開始回應之前,Google 助理會向使用者顯示提示提示中所有提示。
您還可以使用下列功能,為提示迅速提供彈性:
- 候選:您可以利用候選功能,根據使用者的裝置功能定義回應。例如,只有當使用者在支援螢幕的裝置上與動作互動時,Google 助理才能顯示複合式回應。
- 變化版本:變化版本是單一訊息的替代變化版本。舉例來說,您可以讓 Google 助理在每次使用者叫用動作時,從五種不同的歡迎訊息變化版本中擇一使用。
- 建議:當 Google 助理顯示提示時,這些建議會在螢幕顯示裝置上為使用者提供建議方塊。
預設提示會使用一個候選項目、一個變化版本和 first_simple
回應。
候選人
在提示中,candidates
物件可讓您根據使用者的裝置功能定義回應。例如,只有當使用者在支援螢幕的裝置上與動作互動時,Google 助理才能顯示複合式回應。如要定義 Google 助理傳回候選裝置的裝置類型,請使用 candidates
物件的 selector
屬性。
在以下範例中,selector
屬性包含裝置功能資訊。第一個候選項目中設定的提示會傳送至裝置上可轉譯回應的使用者。第二個候選項目則提示使用者只能接收文字和語音回應。
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
:裝置可以播放音樂和 Podcast 等長篇音訊媒體。INTERACTIVE_CANVAS
:裝置可以顯示互動式 Canvas 回應。WEB_LINK
:裝置可以使用複合式回應中的網頁連結開啟網路瀏覽器。HOME_STORAGE
:裝置可以儲存及存取住家儲存空間中的資料。
變化版本
變化版本可讓您定義多種回應版本。當 Google 助理傳送提示給使用者時,系統會隨機選擇其中一個變化版本。對話設計的最佳做法是為了讓使用者與您的動作相反,提供替代回應。
舉例來說,提供不同的歡迎訊息變化版本,讓使用者每次叫用動作時都不會收到相同的回應:
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 和 JSON 表示為 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" }] }] }