提示會定義動作如何向使用者顯示回應,以及動作如何提示使用者繼續。建立操作時,您可以向叫用和不同場景中的提示新增提示。提示可能與文字或語音回應一樣簡單,甚至較為複雜,且包含資訊卡、圖片和資料表等多媒體內容。
回應類型
請為每個提示從各種互動回應類型中選取,讓 Google 助理向使用者顯示:
- 簡單回應:簡單的回應會以即時通訊對話框的形式呈現,然後以文字轉語音 (TTS) 或語音合成標記語言 (SSML) 的形式提供音效。簡單回應是所有裝置類型唯一支援的回應。
- 豐富的回應:豐富的回應內容則包含視覺或功能性元素,有助於吸引使用者與您的動作互動。透過多媒體回應,您可以顯示表格資料或播放較長的音訊內容。
- 視覺選取回應:視覺選取回應可為使用者提供視覺介面,讓使用者能夠輕鬆區分出多種標題或圖片。
- 媒體回應:媒體回應可讓動作播放音訊內容比 SSML 更長,並提供設有媒體控制項的視覺元件。
- 互動式畫布:互動式畫布會將回應顯示為全螢幕網頁檢視,並以互動網路應用程式的形式呈現,Google 助理會將此訊息以回應回應給使用者。Canvas 採用稍微不同的提示格式,可配合 HTML、CSS 和 JavaScript 等網路標準提供更靈活的彈性。
這些回應類型都使用相同的基本提示格式,並且可使用與下述相同的一般功能。
提示的格式
在 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
:裝置可以顯示互動式畫布回應。WEB_LINK
:裝置可透過複合式回應中的網頁連結開啟網路瀏覽器。HOME_STORAGE
:裝置可以儲存及存取住家儲存空間中的資料。
變化版本
使用 Variant 可以定義回應的多個版本。當 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 個純文字字元。
如要新增建議,請提供位於個別 title
欄位中的每項建議的 Suggestion
物件。每個建議方塊組合中的標題不得重複。在 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" }] }] }