在 Dialogflow 中探索
按一下「Continue」，即可在 Dialogflow 中匯入我們的回應範例。接著，請按照下列步驟部署及測試範例：
- 輸入虛擬服務專員名稱，並為範例建立新的 Dialogflow 代理程式。
- 代理程式匯入完成後，按一下「Go to agent」。
- 從主要導覽選單中，前往「Fulfillment」。
- 啟用「Inline Editor」(內嵌編輯器)，然後按一下「Deploy」(部署)。編輯器包含程式碼範例。
- 在主要導覽選單中，前往「Integrations」(整合)，然後按一下「Google Assistant」(Google 助理)。
- 在出現的互動視窗中，啟用「Auto-preview changes」，按一下「Test」，開啟動作模擬工具。
- 在模擬工具中輸入
Talk to my test app即可測試範例！
簡易回應會以視覺化的方式呈現聊天泡泡，並使用文字轉語音 (TTS) 或語音合成標記語言 (SSML) 來提供聲音。
根據預設，系統會使用文字轉語音文字做為即時通訊泡泡內容。如果文字的視覺呈現符合您的需求，您就不需要指定即時通訊泡泡的任何顯示文字。
您也可以前往「對話設計指南」，瞭解如何將這些視覺元素納入動作。
屬性
簡易回應具有下列要求和選用屬性，您可以設定：
- 支援具備
actions.capability.AUDIO_OUTPUT或actions.capability.SCREEN_OUTPUT功能的介面。 每個即時通訊泡泡最多 640 個半形字元。超出上限的字串會截斷至 640 個字元之前的第一個字詞分行 (或空白字元)。
即時通訊泡泡內容必須是 TTS/SSML 輸出內容的拼音子集或完整轉錄稿。這有助於使用者釐清您的說話方式，並增加不同條件的理解程度。
每輪最多只能顯示兩個即時通訊泡泡。
提交給 Google 的即時通訊頭像 (標誌) 必須為 192x192 像素，且不得為動畫。
程式碼範例
Node.js
app.intent('Simple Response', (conv) => {
conv.ask(new SimpleResponse({
speech: `Here's an example of a simple response. ` +
`Which type of response would you like to see next?`,
text: `Here's a simple response. ` +
`Which response would you like to see next?`,
}));
});
Java
@ForIntent("Simple Response")
public ActionResponse welcome(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder.add(
new SimpleResponse()
.setTextToSpeech(
"Here's an example of a simple response. "
+ "Which type of response would you like to see next?")
.setDisplayText(
"Here's a simple response. Which response would you like to see next?"));
return responseBuilder.build();
}
Node.js
conv.ask(new SimpleResponse({
speech: `Here's an example of a simple response. ` +
`Which type of response would you like to see next?`,
text: `Here's a simple response. ` +
`Which response would you like to see next?`,
}));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder.add(
new SimpleResponse()
.setTextToSpeech(
"Here's an example of a simple response. "
+ "Which type of response would you like to see next?")
.setDisplayText(
"Here's a simple response. Which response would you like to see next?"));
return responseBuilder.build();
JSON
請注意，以下 JSON 說明 Webhook 回應。
{
"payload": {
"google": {
"expectUserResponse": true,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Here's an example of a simple response. Which type of response would you like to see next?",
"displayText": "Here's a simple response. Which response would you like to see next?"
}
}
]
}
}
}
}
JSON
請注意，以下 JSON 說明 Webhook 回應。
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TEXT"
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Here's an example of a simple response. Which type of response would you like to see next?",
"displayText": "Here's a simple response. Which response would you like to see next?"
}
}
]
}
}
}
]
}
SSML 和聲音
在回應中使用 SSML 和音效，可讓回應內容更精美，並改善使用者體驗。下列程式碼片段顯示如何建立使用 SSML 的回應：
Node.js
app.intent('SSML', (conv) => {
conv.ask(`<speak>` +
`Here are <say-as interpet-as="characters">SSML</say-as> examples.` +
`Here is a buzzing fly ` +
`<audio src="https://actions.google.com/sounds/v1/animals/buzzing_fly.ogg"></audio>` +
`and here's a short pause <break time="800ms"/>` +
`</speak>`);
conv.ask('Which response would you like to see next?');
});
Java
@ForIntent("SSML")
public ActionResponse ssml(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder.add(
"<speak>"
+ "Here are <say-as interpet-as=\"characters\">SSML</say-as> examples."
+ "Here is a buzzing fly "
+ "<audio src=\"https://actions.google.com/sounds/v1/animals/buzzing_fly.ogg\"></audio>"
+ "and here's a short pause <break time=\"800ms\"/>"
+ "</speak>");
return responseBuilder.build();
}
Node.js
conv.ask(`<speak>` +
`Here are <say-as interpet-as="characters">SSML</say-as> examples.` +
`Here is a buzzing fly ` +
`<audio src="https://actions.google.com/sounds/v1/animals/buzzing_fly.ogg"></audio>` +
`and here's a short pause <break time="800ms"/>` +
`</speak>`);
conv.ask('Which response would you like to see next?');
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder.add(
"<speak>"
+ "Here are <say-as interpet-as=\"characters\">SSML</say-as> examples."
+ "Here is a buzzing fly "
+ "<audio src=\"https://actions.google.com/sounds/v1/animals/buzzing_fly.ogg\"></audio>"
+ "and here's a short pause <break time=\"800ms\"/>"
+ "</speak>");
return responseBuilder.build();
JSON
請注意，以下 JSON 說明 Webhook 回應。
{
"payload": {
"google": {
"expectUserResponse": true,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "<speak>Here are <say-as interpet-as=\"characters\">SSML</say-as> examples.Here is a buzzing fly <audio src=\"https://actions.google.com/sounds/v1/animals/buzzing_fly.ogg\"></audio>and here's a short pause <break time=\"800ms\"/></speak>"
}
},
{
"simpleResponse": {
"textToSpeech": "Which response would you like to see next?"
}
}
]
}
}
}
}
JSON
請注意，以下 JSON 說明 Webhook 回應。
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TEXT"
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "<speak>Here are <say-as interpet-as=\"characters\">SSML</say-as> examples.Here is a buzzing fly <audio src=\"https://actions.google.com/sounds/v1/animals/buzzing_fly.ogg\"></audio>and here's a short pause <break time=\"800ms\"/></speak>"
}
},
{
"simpleResponse": {
"textToSpeech": "Which response would you like to see next?"
}
}
]
}
}
}
]
}
詳情請參閱 SSML 參考說明文件。
音效庫
我們在音效庫中提供各式各樣免費的短音效，這些音效會為您託管，因此只需在 SSML 中加入這些音效即可。