สํารวจใน Dialogflow
คลิกต่อไปเพื่อนําเข้าตัวอย่างตัวช่วยใน Dialogflow จากนั้นทําตามขั้นตอนด้านล่างเพื่อทําให้ใช้งานได้และทดสอบตัวอย่าง
- ป้อนชื่อ Agent แล้วสร้าง Agent ใหม่ของ Dialogflow สําหรับตัวอย่าง
- หลังจากตัวแทนนําเข้าเสร็จแล้ว ให้คลิกไปที่ตัวแทน
- จากเมนูการนําทางหลัก ให้ไปที่การดําเนินการ
- เปิดใช้ตัวแก้ไขในบรรทัด แล้วคลิกทําให้ใช้งานได้ ตัวแก้ไขมีโค้ดตัวอย่าง
- จากเมนูการนําทางหลัก ให้ไปที่ Integrations แล้วคลิก Google Assistant
- ในหน้าต่างโมดัลที่ปรากฏขึ้น ให้เปิดใช้แสดงตัวอย่างการเปลี่ยนแปลงอัตโนมัติ แล้วคลิกทดสอบเพื่อเปิดเครื่องจําลองการดําเนินการ
- ป้อน
Talk to my test appในเครื่องมือจําลองเพื่อทดสอบตัวอย่าง
ผู้ช่วยจะบอกให้ Assistant หยุดการสนทนาชั่วคราวเพื่อรับข้อมูลทั่วไป เช่น ชื่อเต็มของผู้ใช้ วันที่และเวลา หรือที่อยู่การจัดส่ง เมื่อคุณขอให้ผู้ช่วยเหลือ Assistant จะแสดง UI มาตรฐานที่สอดคล้องกันเพื่อให้ผู้ใช้รับข้อมูลนี้ คุณจึงไม่ต้องออกแบบเอง
ภาพรวมการใช้งาน
กระบวนการทั่วไปสําหรับการใช้ตัวช่วยกับ Dialogflow และ Actions SDK อธิบายไว้ด้านล่างสําหรับ Dialogflow และ Actions SDK ดูหัวข้อผู้ช่วยที่เจาะจง สําหรับข้อมูลเพิ่มเติมเกี่ยวกับผู้ช่วยแต่ละราย
Dialogflow
Node.js
- เรียกใช้
conv.ask()ด้วยออบเจ็กต์ตัวช่วยที่เหมาะสม เมื่อคุณเรียกใช้ฟังก์ชันตัวช่วย ไลบรารีไคลเอ็นต์จะส่งการตอบกลับไปยัง Assistant ที่มี Intent ของตัวช่วยที่เกี่ยวข้อง Assistant จะโต้ตอบในกล่องโต้ตอบสําหรับผู้ช่วยที่เกี่ยวข้องโดยอิงตามความตั้งใจ - ประกาศ Intent ของ Dialogflow ที่ระบุเหตุการณ์ที่สอดคล้องกับ Intent ตัวช่วยเหลืออย่างใดอย่างหนึ่ง ดูรายชื่อเหตุการณ์ที่รองรับได้ที่หัวข้อIntent ของตัวช่วย ความตั้งใจนี้ไม่จําเป็นต้องมีวลีผู้ใช้พูดว่า เนื่องจากระบบจะทริกเกอร์เสมอเมื่อเหตุการณ์เริ่มทํางาน (เมื่อ Assistant ดําเนินการช่วยเหลือเสร็จแล้ว)
- เมื่อ Assistant แสดงผลลัพธ์ของตัวช่วยในคําขอที่ตามมาเมื่อดําเนินการตามคําสั่งซื้อ ระบบจะทริกเกอร์ Intent ของ Dialogflow ที่เกี่ยวข้องและคุณจะจัดการ Intent ตามปกติ
JSON
- ระบุ Intent ของตัวช่วยในออบเจ็กต์ possibleIntent เมื่อตอบ Assistant เมื่อ Assistant ได้รับการตอบกลับแล้ว Assistant จะรู้ว่าควรมีกล่องโต้ตอบแสดงขึ้นสําหรับผู้ช่วย ดูIntent ของ Assistant เพื่อดูข้อมูลเกี่ยวกับ Intent ที่คุณขอให้ทําได้
- ประกาศ Intent ของ Dialogflow ที่ระบุเหตุการณ์ที่สอดคล้องกับ Intent ตัวช่วยเหลืออย่างใดอย่างหนึ่ง ดูรายชื่อเหตุการณ์ที่รองรับได้ที่หัวข้อIntent ของตัวช่วย จุดประสงค์นี้ไม่จําเป็นต้องมีวลีผู้ใช้พูดว่า เนื่องจากระบบจะทริกเกอร์เสมอเมื่อเหตุการณ์เริ่มทํางาน
- เมื่อ Assistant แสดงผลลัพธ์ของตัวช่วยในคําขอที่ตามมาจนเสร็จสิ้น ให้แยกวิเคราะห์คําขอและข้อมูลที่คุณต้องการ
Actions SDK
Node.js
- เรียกใช้
askด้วยพารามิเตอร์ที่เหมาะสม ฟังก์ชันตัวช่วยจะขอให้ Assistant ทําตาม Intent 1 ที่อธิบายไว้ในIntent Intent เมื่อคุณเรียกใช้ฟังก์ชันตัวช่วย ไลบรารีไคลเอ็นต์จะส่งการตอบกลับไปยัง Assistant ที่มี Intent ดังกล่าวรายการใดรายการหนึ่ง Assistant จะโต้ตอบในกล่องโต้ตอบเพื่อรับความช่วยเหลือที่เกี่ยวข้องโดยอิงตามความตั้งใจ - เมื่อ Assistant แสดงผลลัพธ์ของตัวช่วยในคําขอที่ตามมาเมื่อดําเนินการตามคําสั่งซื้อ คุณจะได้รับ Intent ที่เกี่ยวข้องในคําขอ วิธีนี้จะช่วยให้คุณตรวจพบว่าผู้ช่วยเหลือได้แสดงผลการค้นหาแล้ว ใช้ฟังก์ชัน Getter ที่ตรงกันสําหรับตัวช่วยดึงข้อมูลที่คุณต้องการ
JSON
- ระบุ Intent ของตัวช่วยในออบเจ็กต์ possibleIntent เมื่อตอบ Assistant เมื่อ Assistant ได้รับการตอบกลับแล้ว Assistant จะรู้ว่าควรมีกล่องโต้ตอบแสดงขึ้นสําหรับผู้ช่วย ดูIntent ของ Assistant เพื่อดูข้อมูลเกี่ยวกับ Intent ที่คุณขอให้ทําได้
- เมื่อ Assistant แสดงผลลัพธ์ของตัวช่วยในคําขอที่ตามมาจนเสร็จสิ้น ให้แยกวิเคราะห์คําขอและข้อมูลที่คุณต้องการ
ความตั้งใจของผู้ช่วย
ตารางต่อไปนี้อธิบาย Intent ที่รองรับซึ่งคุณขอให้ Assistant ดําเนินการได้ หากใช้ Dialogflow อยู่ คุณจะต้องสร้าง Intent ของ Dialogflow ที่ระบุเหตุการณ์ที่เกี่ยวข้องสําหรับ Intent ของ Helper ด้วย
| ชื่อ Intent | ชื่อเหตุการณ์ Dialogflow | การใช้งาน |
|---|---|---|
actions.intent.PERMISSION |
actions_intent_PERMISSION |
รับชื่อเต็มของผู้ใช้ ตําแหน่งคร่าวๆ หรือตําแหน่งที่แน่นอนหรือทั้ง 3 อย่าง |
actions.intent.OPTION |
actions_intent_OPTION |
รับรายการที่เลือกจากรายการหรือ UI แบบหมุน หรือหากผู้ใช้ไม่ได้เลือกจากรายการหรือ UI ของภาพหมุน จะได้รับอินพุตคําพูดหรือข้อความที่ตรงกับคีย์ในรายการหรือ UI ของภาพหมุน |
actions.intent.DATETIME |
actions_intent_DATETIME |
รับข้อมูลวันที่และเวลาจากผู้ใช้ |
actions.intent.SIGN_IN |
actions_intent_SIGN_IN |
ส่งคําขอลิงก์บัญชีเพื่อลิงก์บัญชีของผู้ใช้ |
actions.intent.PLACE |
actions_intent_PLACE |
รับที่อยู่หรือตําแหน่งที่บันทึกไว้จากผู้ใช้ |
actions.intent.CONFIRMATION |
actions_intent_CONFIRMATION |
รับการยืนยันจากผู้ใช้ (เช่น คําตอบสําหรับคําถามใช่หรือไม่) |
ส่วนต่อไปนี้จะอธิบายถึงตัวช่วยที่มีให้และความตั้งใจที่เกี่ยวข้องซึ่งคุณต้องขอใช้ผู้ช่วย
ข้อมูลผู้ใช้
คุณสามารถขอรับข้อมูลผู้ใช้ต่อไปนี้ได้ด้วยผู้ช่วยนี้
- ชื่อที่แสดง
- ชื่อ
- นามสกุล
- ตําแหน่งคร่าวๆ ของอุปกรณ์ (รหัสไปรษณีย์และเมือง)
- ตําแหน่งที่แน่นอนของอุปกรณ์ (พิกัดและที่อยู่ถนน)
กําลังโทรหาผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีที่คุณสามารถเรียกใช้ผู้ช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงการตอบสนองของเว็บฮุคที่เกี่ยวข้อง
Node.js
app.intent('Permission', (conv) => {
const permissions = ['NAME'];
let context = 'To address you by name';
// Location permissions only work for verified users
// https://developers.google.com/actions/assistant/guest-users
if (conv.user.verification === 'VERIFIED') {
// Could use DEVICE_COARSE_LOCATION instead for city, zip code
permissions.push('DEVICE_PRECISE_LOCATION');
context += ' and know your location';
}
const options = {
context,
permissions,
};
conv.ask(new Permission(options));
});
Java
@ForIntent("Permission")
public ActionResponse getPermission(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
String[] permissions = new String[] {ConstantsKt.PERMISSION_NAME};
String context = "To address you by name";
// Location permissions only work for verified users
// https://developers.google.com/actions/assistant/guest-users
if (request.getUser().getUserVerificationStatus().equals("VERIFIED")) {
// Could use PERMISSION_DEVICE_COARSE_LOCATION instead for city, zip code
permissions =
new String[] {
ConstantsKt.PERMISSION_NAME, ConstantsKt.PERMISSION_DEVICE_PRECISE_LOCATION
};
}
responseBuilder
.add("PLACEHOLDER")
.add(new Permission().setPermissions(permissions).setContext(context));
return responseBuilder.build();
}
Node.js
const permissions = ['NAME'];
let context = 'To address you by name';
// Location permissions only work for verified users
// https://developers.google.com/actions/assistant/guest-users
if (conv.user.verification === 'VERIFIED') {
// Could use DEVICE_COARSE_LOCATION instead for city, zip code
permissions.push('DEVICE_PRECISE_LOCATION');
context += ' and know your location';
}
const options = {
context,
permissions,
};
conv.ask(new Permission(options));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
String[] permissions = new String[] {ConstantsKt.PERMISSION_NAME};
String context = "To address you by name";
// Location permissions only work for verified users
// https://developers.google.com/actions/assistant/guest-users
if (request.getUser().getUserVerificationStatus().equals("VERIFIED")) {
// Could use PERMISSION_DEVICE_COARSE_LOCATION instead for city, zip code
permissions =
new String[] {
ConstantsKt.PERMISSION_NAME, ConstantsKt.PERMISSION_DEVICE_PRECISE_LOCATION
};
}
responseBuilder
.add("PLACEHOLDER")
.add(new Permission().setPermissions(permissions).setContext(context));
return responseBuilder.build();
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.PERMISSION",
"data": {
"@type": "type.googleapis.com/google.actions.v2.PermissionValueSpec",
"optContext": "To address you by name and know your location",
"permissions": [
"NAME",
"DEVICE_PRECISE_LOCATION"
]
}
}
}
}
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.PERMISSION",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.PermissionValueSpec",
"optContext": "To address you by name and know your location",
"permissions": [
"NAME",
"DEVICE_PRECISE_LOCATION"
]
}
}
]
}
]
}
การรับผลลัพธ์ของผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีเข้าถึงผลลัพธ์ของตัวช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงคําขอที่มีผลลัพธ์ของตัวช่วยที่จะมีการตอบสนอง
Node.js
app.intent('Permission Handler', (conv, params, confirmationGranted) => {
// Also, can access latitude and longitude
// const { latitude, longitude } = location.coordinates;
const {location} = conv.device;
const {name} = conv.user;
if (confirmationGranted && name && location) {
conv.ask(`Okay ${name.display}, I see you're at ` +
`${location.formattedAddress}`);
} else {
conv.ask(`Looks like I can't get your information.`);
}
conv.ask(`Would you like to try another helper?`);
conv.ask(new Suggestions([
'Confirmation',
'DateTime',
'Place',
]));
});
Java
@ForIntent("Permission Handler")
public ActionResponse handlePermission(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
Location location = request.getDevice().getLocation();
String name = request.getUser().getProfile().getDisplayName();
if (request.isPermissionGranted()) {
responseBuilder.add("Okay " + name + ", I see you're at " + location.getFormattedAddress());
} else {
responseBuilder.add("Looks like I can't get your information");
}
responseBuilder
.add("Would you like to try another helper?")
.addSuggestions(new String[] {"Confirmation", "DateTime", "Place"});
return responseBuilder.build();
}
Node.js
app.intent('actions.intent.PERMISSION', (conv, confirmationGranted) => {
// Also, can access latitude and longitude
// const { latitude, longitude } = location.coordinates;
const {location} = conv.device;
const {name} = conv.user;
if (confirmationGranted && name && location) {
conv.ask(`Okay ${name.display}, I see you're at ` +
`${location.formattedAddress}`);
} else {
conv.ask(`Looks like I can't get your information.`);
}
conv.ask(`Would you like to try another helper?`);
conv.ask(new Suggestions([
'Confirmation',
'DateTime',
'Place',
]));
});
Java
@ForIntent("actions.intent.PERMISSION")
public ActionResponse handlePermission(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
Location location = request.getDevice().getLocation();
String name = request.getUser().getProfile().getDisplayName();
if (request.isPermissionGranted()) {
responseBuilder.add("Okay " + name + ", I see you're at " + location.getFormattedAddress());
} else {
responseBuilder.add("Looks like I can't get your information");
}
responseBuilder
.add("Would you like to try another helper?")
.addSuggestions(new String[] {"Confirmation", "DateTime", "Place"});
return responseBuilder.build();
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"responseId": "f26883c9-0283-4827-85bf-533f4442b4f9-712767ed",
"queryResult": {
"queryText": "actions_intent_PERMISSION",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Webhook failed for intent: Permission Handler",
"fulfillmentMessages": [
{
"text": {
"text": [
"Webhook failed for intent: Permission Handler"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y/contexts/actions_intent_permission",
"parameters": {
"PERMISSION": true,
"text": "yes"
}
}
],
"intent": {
"name": "projects/df-helpers-kohler/agent/intents/6475b0ef-dd52-4afa-a1b9-7a19e7e93a80",
"displayName": "Permission Handler"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"profile": {
"displayName": "Sachit Mishra",
"givenName": "Sachit",
"familyName": "Mishra"
},
"permissions": [
"NAME",
"DEVICE_PRECISE_LOCATION"
],
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y",
"type": "ACTIVE",
"conversationToken": "[]"
},
"inputs": [
{
"intent": "actions.intent.PERMISSION",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "yes"
}
],
"arguments": [
{
"name": "PERMISSION",
"boolValue": true,
"textValue": "true"
},
{
"name": "text",
"rawText": "yes",
"textValue": "yes"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
}
]
},
"device": {
"location": {
"coordinates": {
"latitude": 37.42241550000001,
"longitude": -122.0840805
},
"formattedAddress": "Google Building 40 1600 Amphitheatre Parkway, Mountain View, California 94043",
"zipCode": "94043",
"city": "Mountain View"
}
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
}
]
}
},
"session": "projects/df-helpers-kohler/agent/sessions/ABwppHGu7m_m6bTsKuLb6noyG_o-9BMSf8J9cfY8dpJIPN_hHT79qfqRrZPtyx515K-sl9SU8Jy3auH6pLmy99Y"
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"user": {
"profile": {
"displayName": "Sachit Mishra",
"givenName": "Sachit",
"familyName": "Mishra"
},
"permissions": [
"DEVICE_PRECISE_LOCATION",
"NAME"
],
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHEcidO2jguO4hS8maDeMVx8aasSCcBWZHrF3EmOMIaWRP9qF0BcACistiIoeyiSNTW6KD_tqN_U-xAIOXhPvA",
"type": "NEW"
},
"inputs": [
{
"intent": "actions.intent.PERMISSION",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "yes"
}
],
"arguments": [
{
"name": "PERMISSION",
"boolValue": true,
"textValue": "true"
},
{
"name": "text",
"rawText": "yes",
"textValue": "yes"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"device": {
"location": {
"coordinates": {
"latitude": 37.4197238,
"longitude": -122.08212759999999
},
"formattedAddress": "Google Building 45 1585 Charleston Road, Mountain View, California 94043",
"zipCode": "94043",
"city": "Mountain View"
}
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
}
]
}
ตัวอย่างข้างต้นแสดงวิธีตรวจสอบว่าผู้ใช้ให้ข้อมูล แก่คุณหรือไม่ จากนั้นเข้าถึงข้อมูล
เมื่อได้รับข้อมูลของผู้ใช้แล้ว เราขอแนะนําให้คุณเก็บข้อมูลนี้ไว้เพื่อคุณจะได้ไม่ต้องถามอีก คุณสามารถใช้พื้นที่เก็บข้อมูลของผู้ใช้ เพื่อจัดเก็บข้อมูลผู้ใช้ในการสนทนาต่างๆ ได้ ดูตัวอย่างผู้มีความสามารถทางจิตวิญญาณของเราใน Node.js และ Java เพื่อดูตัวอย่าง UserStorage
ตัวเลือกรายการและภาพหมุน
กําลังโทรหาผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีที่คุณสามารถเรียกใช้ผู้ช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงการตอบสนองของเว็บฮุคที่เกี่ยวข้อง
Node.js
app.intent('List', (conv) => {
if (!conv.screen) {
conv.ask('Sorry, try this on a screen device or select the ' +
'phone surface in the simulator.');
return;
}
conv.ask('This is a list example.');
// Create a list
conv.ask(new List({
title: 'List Title',
items: {
// Add the first item to the list
'SELECTION_KEY_ONE': {
synonyms: [
'synonym 1',
'synonym 2',
'synonym 3',
],
title: 'Title of First List Item',
description: 'This is a description of a list item.',
image: new Image({
url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png',
alt: 'Image alternate text',
}),
},
// Add the second item to the list
'SELECTION_KEY_GOOGLE_HOME': {
synonyms: [
'Google Home Assistant',
'Assistant on the Google Home',
],
title: 'Google Home',
description: 'Google Home is a voice-activated speaker powered by ' +
'the Google Assistant.',
image: new Image({
url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png',
alt: 'Google Home',
}),
},
// Add the third item to the list
'SELECTION_KEY_GOOGLE_PIXEL': {
synonyms: [
'Google Pixel XL',
'Pixel',
'Pixel XL',
],
title: 'Google Pixel',
description: 'Pixel. Phone by Google.',
image: new Image({
url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png',
alt: 'Google Pixel',
}),
},
},
}));
});
Java
@ForIntent("List")
public ActionResponse list(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
return responseBuilder
.add("Sorry, try ths on a screen device or select the phone surface in the simulator.")
.add("Which response would you like to see next?")
.build();
}
responseBuilder
.add("This is a list example.")
.add(
new SelectionList()
.setTitle("List Title")
.setItems(
Arrays.asList(
new ListSelectListItem()
.setTitle("Title of First List Item")
.setDescription("This is a description of a list item.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Image alternate text"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList("synonym 1", "synonym 2", "synonym 3"))
.setKey("SELECTION_KEY_ONE")),
new ListSelectListItem()
.setTitle("Google Home")
.setDescription(
"Google Home is a voice-activated speaker powered by the Google Assistant.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Google Home"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList(
"Google Home Assistant",
"Assistant on the Google Home"))
.setKey("SELECTION_KEY_GOOGLE_HOME")),
new ListSelectListItem()
.setTitle("Google Pixel")
.setDescription("Pixel. Phone by Google.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Google Pixel"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList("Google Pixel XL", "Pixel", "Pixel XL"))
.setKey("SELECTION_KEY_GOOGLE_PIXEL")))));
return responseBuilder.build();
}
Node.js
if (!conv.screen) {
conv.ask('Sorry, try this on a screen device or select the ' +
'phone surface in the simulator.');
return;
}
conv.ask('This is a list example.');
// Create a list
conv.ask(new List({
title: 'List Title',
items: {
// Add the first item to the list
'SELECTION_KEY_ONE': {
synonyms: [
'synonym 1',
'synonym 2',
'synonym 3',
],
title: 'Title of First List Item',
description: 'This is a description of a list item.',
image: new Image({
url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png',
alt: 'Image alternate text',
}),
},
// Add the second item to the list
'SELECTION_KEY_GOOGLE_HOME': {
synonyms: [
'Google Home Assistant',
'Assistant on the Google Home',
],
title: 'Google Home',
description: 'Google Home is a voice-activated speaker powered by ' +
'the Google Assistant.',
image: new Image({
url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png',
alt: 'Google Home',
}),
},
// Add the third item to the list
'SELECTION_KEY_GOOGLE_PIXEL': {
synonyms: [
'Google Pixel XL',
'Pixel',
'Pixel XL',
],
title: 'Google Pixel',
description: 'Pixel. Phone by Google.',
image: new Image({
url: 'https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png',
alt: 'Google Pixel',
}),
},
},
}));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
return responseBuilder
.add("Sorry, try ths on a screen device or select the phone surface in the simulator.")
.add("Which response would you like to see next?")
.build();
}
responseBuilder
.add("This is a list example.")
.add(
new SelectionList()
.setTitle("List Title")
.setItems(
Arrays.asList(
new ListSelectListItem()
.setTitle("Title of First List Item")
.setDescription("This is a description of a list item.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Image alternate text"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList("synonym 1", "synonym 2", "synonym 3"))
.setKey("SELECTION_KEY_ONE")),
new ListSelectListItem()
.setTitle("Google Home")
.setDescription(
"Google Home is a voice-activated speaker powered by the Google Assistant.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Google Home"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList(
"Google Home Assistant",
"Assistant on the Google Home"))
.setKey("SELECTION_KEY_GOOGLE_HOME")),
new ListSelectListItem()
.setTitle("Google Pixel")
.setDescription("Pixel. Phone by Google.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Google Pixel"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList("Google Pixel XL", "Pixel", "Pixel XL"))
.setKey("SELECTION_KEY_GOOGLE_PIXEL")))));
return responseBuilder.build();
JSON
โปรดทราบว่า JSON ด้านล่างอธิบายการตอบสนองของเว็บฮุค
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.OPTION",
"data": {
"@type": "type.googleapis.com/google.actions.v2.OptionValueSpec",
"listSelect": {
"title": "List Title",
"items": [
{
"optionInfo": {
"key": "SELECTION_KEY_ONE",
"synonyms": [
"synonym 1",
"synonym 2",
"synonym 3"
]
},
"description": "This is a description of a list item.",
"image": {
"url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png",
"accessibilityText": "Image alternate text"
},
"title": "Title of First List Item"
},
{
"optionInfo": {
"key": "SELECTION_KEY_GOOGLE_HOME",
"synonyms": [
"Google Home Assistant",
"Assistant on the Google Home"
]
},
"description": "Google Home is a voice-activated speaker powered by the Google Assistant.",
"image": {
"url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png",
"accessibilityText": "Google Home"
},
"title": "Google Home"
},
{
"optionInfo": {
"key": "SELECTION_KEY_GOOGLE_PIXEL",
"synonyms": [
"Google Pixel XL",
"Pixel",
"Pixel XL"
]
},
"description": "Pixel. Phone by Google.",
"image": {
"url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png",
"accessibilityText": "Google Pixel"
},
"title": "Google Pixel"
}
]
}
}
},
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "This is a list example."
}
}
]
}
}
}
}
JSON
โปรดทราบว่า JSON ด้านล่างอธิบายการตอบสนองของเว็บฮุค
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.OPTION",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.OptionValueSpec",
"listSelect": {
"title": "List Title",
"items": [
{
"optionInfo": {
"key": "SELECTION_KEY_ONE",
"synonyms": [
"synonym 1",
"synonym 2",
"synonym 3"
]
},
"description": "This is a description of a list item.",
"image": {
"url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png",
"accessibilityText": "Image alternate text"
},
"title": "Title of First List Item"
},
{
"optionInfo": {
"key": "SELECTION_KEY_GOOGLE_HOME",
"synonyms": [
"Google Home Assistant",
"Assistant on the Google Home"
]
},
"description": "Google Home is a voice-activated speaker powered by the Google Assistant.",
"image": {
"url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png",
"accessibilityText": "Google Home"
},
"title": "Google Home"
},
{
"optionInfo": {
"key": "SELECTION_KEY_GOOGLE_PIXEL",
"synonyms": [
"Google Pixel XL",
"Pixel",
"Pixel XL"
]
},
"description": "Pixel. Phone by Google.",
"image": {
"url": "https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png",
"accessibilityText": "Google Pixel"
},
"title": "Google Pixel"
}
]
}
}
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "This is a list example."
}
}
]
}
}
}
]
}
คุณแสดง UI ของรายการหรือภาพหมุน และรับตัวเลือกที่เลือกไว้จากผู้ใช้ที่มีความตั้งใจ actions.intent.OPTION ได้
การรับผลลัพธ์ของผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเข้าถึงผลลัพธ์ของตัวช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงคําขอที่มีผลลัพธ์ของตัวช่วยที่จะมีการตอบสนอง
ข้อมูลโค้ดต่อไปนี้แสดงวิธีตรวจสอบว่าผู้ใช้เลือกตัวเลือกใด
Node.js
app.intent('List - OPTION', (conv, params, option) => {
const SELECTED_ITEM_RESPONSES = {
'SELECTION_KEY_ONE': 'You selected the first item',
'SELECTION_KEY_GOOGLE_HOME': 'You selected the Google Home!',
'SELECTION_KEY_GOOGLE_PIXEL': 'You selected the Google Pixel!',
};
conv.ask(SELECTED_ITEM_RESPONSES[option]);
conv.ask('Which response would you like to see next?');
});
Java
@ForIntent("List - OPTION")
public ActionResponse listSelected(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
String selectedItem = request.getSelectedOption();
String response;
if (selectedItem.equals("SELECTION_KEY_ONE")) {
response = "You selected the first item";
} else if (selectedItem.equals("SELECTION_KEY_GOOGLE_HOME")) {
response = "You selected the Google Home!";
} else if (selectedItem.equals("SELECTION_KEY_GOOGLE_PIXEL")) {
response = "You selected the Google Pixel!";
} else {
response = "You did not select a valid item";
}
return responseBuilder.add(response).add("Which response would you like to see next?").build();
}
Node.js
app.intent('actions.intent.OPTION', (conv, params, option) => {
const SELECTED_ITEM_RESPONSES = {
'SELECTION_KEY_ONE': 'You selected the first item',
'SELECTION_KEY_GOOGLE_HOME': 'You selected the Google Home!',
'SELECTION_KEY_GOOGLE_PIXEL': 'You selected the Google Pixel!',
};
conv.ask(SELECTED_ITEM_RESPONSES[option]);
conv.ask('Which response would you like to see next?');
});
Java
@ForIntent("actions.intent.OPTION")
public ActionResponse listSelected(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
String selectedItem = request.getSelectedOption();
String response;
if (selectedItem.equals("SELECTION_KEY_ONE")) {
response = "You selected the first item";
} else if (selectedItem.equals("SELECTION_KEY_GOOGLE_HOME")) {
response = "You selected the Google Home!";
} else if (selectedItem.equals("SELECTION_KEY_GOOGLE_PIXEL")) {
response = "You selected the Google Pixel!";
} else {
response = "You did not select a valid item";
}
return responseBuilder.add(response).add("Which response would you like to see next?").build();
}
public ActionResponse carousel(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (!request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
return responseBuilder
.add("Sorry, try ths on a screen device or select the phone surface in the simulator.")
.add("Which response would you like to see next?")
.build();
}
responseBuilder
.add("This is a carousel example.")
.add(
new SelectionCarousel()
.setItems(
Arrays.asList(
new CarouselSelectCarouselItem()
.setTitle("Title of First List Item")
.setDescription("This is a description of a list item.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Image alternate text"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList("synonym 1", "synonym 2", "synonym 3"))
.setKey("SELECTION_KEY_ONE")),
new CarouselSelectCarouselItem()
.setTitle("Google Home")
.setDescription(
"Google Home is a voice-activated speaker powered by the Google Assistant.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Google Home"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList(
"Google Home Assistant",
"Assistant on the Google Home"))
.setKey("SELECTION_KEY_GOOGLE_HOME")),
new CarouselSelectCarouselItem()
.setTitle("Google Pixel")
.setDescription("Pixel. Phone by Google.")
.setImage(
new Image()
.setUrl(
"https://storage.googleapis.com/actionsresources/logo_assistant_2x_64dp.png")
.setAccessibilityText("Google Pixel"))
.setOptionInfo(
new OptionInfo()
.setSynonyms(
Arrays.asList("Google Pixel XL", "Pixel", "Pixel XL"))
.setKey("SELECTION_KEY_GOOGLE_PIXEL")))));
return responseBuilder.build();
}
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"responseId": "5d7732d1-d22d-4a0e-ad34-8bc0a7fde20c-21947381",
"queryResult": {
"queryText": "actions_intent_OPTION",
"action": "List.List-custom",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Webhook failed for intent: List - OPTION",
"fulfillmentMessages": [
{
"text": {
"text": [
"Webhook failed for intent: List - OPTION"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/google_assistant_input_type_touch"
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/list-followup",
"lifespanCount": 1
},
{
"name": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA/contexts/actions_intent_option",
"parameters": {
"OPTION": "SELECTION_KEY_GOOGLE_PIXEL",
"text": "Google Pixel"
}
}
],
"intent": {
"name": "projects/df-responses-kohler/agent/intents/88904350-193e-4472-a2de-977eb5d9e26e",
"displayName": "List - OPTION"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"lastSeen": "2019-08-04T23:56:32Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA",
"type": "ACTIVE",
"conversationToken": "[\"list-followup\"]"
},
"inputs": [
{
"intent": "actions.intent.OPTION",
"rawInputs": [
{
"inputType": "TOUCH",
"query": "Google Pixel"
}
],
"arguments": [
{
"name": "OPTION",
"textValue": "SELECTION_KEY_GOOGLE_PIXEL"
},
{
"name": "text",
"rawText": "Google Pixel",
"textValue": "Google Pixel"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"isInSandbox": true,
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
}
],
"requestType": "SIMULATOR"
}
},
"session": "projects/df-responses-kohler/agent/sessions/ABwppHHsebncupHK11oKhsCTgyH96GRNYH-xpeeMTqb-cvOxbd67QenbRlZM4bGAIB8_KXdTfI7-7lYVKN1ovAhCaA"
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"user": {
"locale": "en-US",
"lastSeen": "2019-08-06T07:37:53Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGcqunXh1M6IE0lu2sVqXdpJfdpC5FWMkMSXQskK1nzb4IkSUSRqQzoEr0Ly0z_G3mwyZlk5rFtd1w",
"type": "NEW"
},
"inputs": [
{
"intent": "actions.intent.OPTION",
"rawInputs": [
{
"inputType": "TOUCH",
"query": "Google Home"
}
],
"arguments": [
{
"name": "OPTION",
"textValue": "SELECTION_KEY_GOOGLE_HOME"
},
{
"name": "text",
"rawText": "Google Home",
"textValue": "Google Home"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"isInSandbox": true,
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
}
],
"requestType": "SIMULATOR"
}
วันที่และเวลา
คุณจะขอวันที่และเวลาจากผู้ใช้ได้โดยส่งคําขอตาม Intent ของ actions.intent.DATETIME
กําลังโทรหาผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีที่คุณสามารถเรียกใช้ผู้ช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงการตอบสนองของเว็บฮุคที่เกี่ยวข้อง
คุณระบุข้อความแจ้งที่กําหนดเองเมื่อขอวันที่และเวลากับผู้ใช้ได้โดยใช้ออบเจ็กต์ options ขณะสร้างสิทธิ์ DateTime
Node.js
app.intent('Date Time', (conv) => {
const options = {
prompts: {
initial: 'When would you like to schedule the appointment?',
date: 'What day was that?',
time: 'What time works for you?',
},
};
conv.ask(new DateTime(options));
});
Java
@ForIntent("Date Time")
public ActionResponse getDateTime(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder
.add("PLACEHOLDER")
.add(
new DateTimePrompt()
.setDateTimePrompt("When would you like to schedule the appointment?")
.setDatePrompt("What day was that?")
.setTimePrompt("What time works for you?"));
return responseBuilder.build();
}
Node.js
const options = {
prompts: {
initial: 'When would you like to schedule the appointment?',
date: 'What day was that?',
time: 'What time works for you?',
},
};
conv.ask(new DateTime(options));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder
.add("PLACEHOLDER")
.add(
new DateTimePrompt()
.setDateTimePrompt("When would you like to schedule the appointment?")
.setDatePrompt("What day was that?")
.setTimePrompt("What time works for you?"));
return responseBuilder.build();
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.DATETIME",
"data": {
"@type": "type.googleapis.com/google.actions.v2.DateTimeValueSpec",
"dialogSpec": {
"requestDatetimeText": "When would you like to schedule the appointment?",
"requestDateText": "What day was that?",
"requestTimeText": "What time works for you?"
}
}
}
}
}
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.DATETIME",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.DateTimeValueSpec",
"dialogSpec": {
"requestDatetimeText": "When would you like to schedule the appointment?",
"requestDateText": "What day was that?",
"requestTimeText": "What time works for you?"
}
}
}
]
}
]
}
การรับผลลัพธ์ของผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีเข้าถึงผลลัพธ์ของตัวช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงคําขอที่มีผลลัพธ์ของตัวช่วยที่จะมีการตอบสนอง
ตัวอย่างข้อมูลด้านล่างจะแสดงวิธีตรวจสอบว่าผู้ใช้ให้สิทธิ์เข้าถึง และวิธีการเข้าถึงข้อมูลหรือไม่
Node.js
app.intent('Date Time Handler', (conv, params, datetime) => {
const {month, day} = datetime.date;
const {hours, minutes} = datetime.time;
conv.ask(`<speak>` +
`Great, we will see you on ` +
`<say-as interpret-as="date" format="dm">${day}-${month}</say-as>` +
`<say-as interpret-as="time" format="hms12" detail="2">${hours}` +
`:${minutes || '00'}</say-as>` +
`</speak>`);
conv.ask('Would you like to try another helper?');
conv.ask(new Suggestions([
'Confirmation',
'Permission',
'Place',
]));
});
Java
@ForIntent("Date Time Handler")
public ActionResponse handleDateTime(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
DateTime dateTimeValue = request.getDateTime();
Integer day = dateTimeValue.getDate().getDay();
Integer month = dateTimeValue.getDate().getMonth();
Integer hours = dateTimeValue.getTime().getHours();
Integer minutes = dateTimeValue.getTime().getMinutes();
String minutesStr = (minutes != null) ? String.valueOf(minutes) : "00";
responseBuilder.add(
"<speak>"
+ "Great, we will see you on "
+ "<say-as interpret-as=\"date\" format=\"dm\">"
+ day
+ "-"
+ month
+ "</say-as>"
+ "<say-as interpret-as=\"time\" format=\"hms12\" detail=\"2\">"
+ hours
+ ":"
+ minutesStr
+ "</say-as>"
+ "</speak>");
responseBuilder
.add("Would you like to try another helper?")
.addSuggestions(new String[] {"Confirmation", "Permission", "Place"});
return responseBuilder.build();
}
Node.js
app.intent('actions.intent.DATETIME', (conv) => {
const datetime = conv.arguments.get('DATETIME');
const {month, day} = datetime.date;
const {hours, minutes} = datetime.time;
conv.ask(`<speak>` +
`Great, we will see you on ` +
`<say-as interpret-as="date" format="dm">${day}-${month}</say-as>` +
`<say-as interpret-as="time" format="hms12" detail="2">${hours}` +
`:${minutes || '00'}</say-as>` +
`</speak>`);
conv.ask('Would you like to try another helper?');
conv.ask(new Suggestions([
'Confirmation',
'Permission',
'Place',
]));
});
Java
@ForIntent("actions.intent.DATETIME")
public ActionResponse datetimeHandler(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
DateTime dateTimeValue = request.getDateTime();
Integer day = dateTimeValue.getDate().getDay();
Integer month = dateTimeValue.getDate().getMonth();
Integer hours = dateTimeValue.getTime().getHours();
Integer minutes = dateTimeValue.getTime().getMinutes();
String minutesStr = (minutes != null) ? String.valueOf(minutes) : "00";
responseBuilder.add(
"<speak>"
+ "Great, we will see you on "
+ "<say-as interpret-as=\"date\" format=\"dm\">"
+ day
+ "-"
+ month
+ "</say-as>"
+ "<say-as interpret-as=\"time\" format=\"hms12\" detail=\"2\">"
+ hours
+ ":"
+ minutesStr
+ "</say-as>"
+ "</speak>");
responseBuilder
.add("Would you like to try another helper?")
.addSuggestions(new String[] {"Confirmation", "Permission", "Place"});
return responseBuilder.build();
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"responseId": "2b0a039d-b033-4256-bd8a-ebb1f0ad90b4-712767ed",
"queryResult": {
"queryText": "actions_intent_DATETIME",
"action": "DateTime.DateTime-custom",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Webhook failed for intent: Date Time Handler",
"fulfillmentMessages": [
{
"text": {
"text": [
"Webhook failed for intent: Date Time Handler"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/datetime-followup",
"lifespanCount": 1
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY/contexts/actions_intent_datetime",
"parameters": {
"DATETIME": "2019-08-14T10:30:00",
"text": "1030am"
}
}
],
"intent": {
"name": "projects/df-helpers-kohler/agent/intents/3c145f18-32fe-40aa-842e-b99ab28c3f2a",
"displayName": "Date Time Handler"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY",
"type": "ACTIVE",
"conversationToken": "[\"datetime-followup\"]"
},
"inputs": [
{
"intent": "actions.intent.DATETIME",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "1030am"
}
],
"arguments": [
{
"name": "DATETIME",
"datetimeValue": {
"date": {
"year": 2019,
"month": 8,
"day": 14
},
"time": {
"hours": 10,
"minutes": 30
}
}
},
{
"name": "text",
"rawText": "1030am",
"textValue": "1030am"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}
},
"session": "projects/df-helpers-kohler/agent/sessions/ABwppHHnU7RSIOU994H8vd2wLYXbnoIAs3rk-4zUeiRAaX3aJ0dp68Y50MgvddE2stYuI6Hlu-MfWO75Gz76EeY"
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"user": {
"profile": {
"displayName": "Sachit Mishra",
"givenName": "Sachit",
"familyName": "Mishra"
},
"permissions": [
"DEVICE_PRECISE_LOCATION",
"NAME"
],
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHEcidO2jguO4hS8maDeMVx8aasSCcBWZHrF3EmOMIaWRP9qF0BcACistiIoeyiSNTW6KD_tqN_U-xAIOXhPvA",
"type": "NEW"
},
"inputs": [
{
"intent": "actions.intent.DATETIME",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "430pm"
}
],
"arguments": [
{
"name": "DATETIME",
"datetimeValue": {
"date": {
"year": 2019,
"month": 8,
"day": 18
},
"time": {
"hours": 16,
"minutes": 30
}
}
},
{
"name": "text",
"rawText": "430pm",
"textValue": "430pm"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
},
"device": {
"location": {
"coordinates": {
"latitude": 37.4197238,
"longitude": -122.08212759999999
},
"formattedAddress": "Google Building 45 1585 Charleston Road, Mountain View, California 94043",
"zipCode": "94043",
"city": "Mountain View"
}
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}
การลงชื่อเข้าใช้บัญชี
คุณให้ผู้ใช้ลงชื่อเข้าใช้บัญชีที่เชื่อมโยงกับบริการได้โดยขอใช้ Intent ของ actions.intent.SIGN_IN ผู้ใช้
ไม่สามารถลงชื่อเข้าใช้ด้วยเสียงผ่าน OAuth
กําลังโทรหาผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีที่คุณสามารถเรียกใช้ผู้ช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงการตอบสนองของเว็บฮุคที่เกี่ยวข้อง
Node.js
const {SignIn} = require('actions-on-google');
app.intent('ask_for_sign_in_detail', (conv) => {
conv.ask(new SignIn());
});
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
return responseBuilder.add("This is the SignIn helper intent").add(new SignIn()).build();
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.SIGN_IN",
"data": {
"@type": "type.googleapis.com/google.actions.v2.SignInValueSpec"
}
}
}
}
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.SIGN_IN",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.SignInValueSpec"
}
}
]
}
]
}
การรับผลลัพธ์ของผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีเข้าถึงผลลัพธ์ของตัวช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงคําขอที่มีผลลัพธ์ของตัวช่วยที่จะมีการตอบสนอง
ตัวอย่างข้อมูลด้านล่างจะแสดงวิธีตรวจสอบว่าผู้ใช้ให้สิทธิ์เข้าถึง และวิธีการเข้าถึงข้อมูลหรือไม่
Node.js
app.intent('ask_for_sign_in_confirmation', (conv, params, signin) => {
if (signin.status !== 'OK') {
return conv.ask('You need to sign in before using the app.');
}
// const access = conv.user.access.token;
// possibly do something with access token
return conv.ask('Great! Thanks for signing in.');
});
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
boolean signedIn = request.isSignInGranted();
return responseBuilder
.add(signedIn ? "Great! Thanks for signin in." : "You must sign in before using the app.")
.build();
JSON
{
"responseId": "",
"queryResult": {
"queryText": "",
"action": "",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "",
"fulfillmentMessages": [],
"outputContexts": [],
"intent": {
"name": "ask_for_sign_in_confirmation",
"displayName": "ask_for_sign_in_confirmation"
},
"intentDetectionConfidence": 1,
"diagnosticInfo": {},
"languageCode": ""
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"isInSandbox": true,
"surface": {
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"inputs": [
{
"rawInputs": [],
"intent": "",
"arguments": [
{
"name": "SIGN_IN",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
}
}
]
}
],
"user": {},
"conversation": {},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}
},
"session": ""
}
JSON
{
"user": {},
"device": {},
"surface": {
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"conversation": {},
"inputs": [
{
"rawInputs": [],
"intent": "ask_for_sign_in_confirmation",
"arguments": [
{
"name": "SIGN_IN",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
}
}
]
}
],
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}
สถานที่และตําแหน่ง
คุณจะรับตําแหน่งจากผู้ใช้ได้โดยขอดําเนินการตาม Intent ของ actions.intent.PLACE ตัวช่วยนี้ใช้เพื่อแจ้งให้ผู้ใช้ทราบที่อยู่และตําแหน่งอื่น รวมถึงตําแหน่งบ้าน/ที่ทํางาน/ที่อยู่ติดต่อที่ผู้ใช้ได้บันทึกไว้กับ Google
สถานที่ที่บันทึกไว้จะแสดงที่อยู่เท่านั้น ไม่แสดงการแมปที่เกี่ยวข้อง (เช่น "123 Main St" แทนที่จะเป็น "HOME = 123 Main St")
กําลังโทรหาผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีที่คุณสามารถเรียกใช้ผู้ช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงการตอบสนองของเว็บฮุคที่เกี่ยวข้อง
Node.js
app.intent('Place', (conv) => {
const options = {
context: 'To find a location',
prompt: 'Where would you like to go?',
};
conv.ask(new Place(options));
});
Java
@ForIntent("Place")
public ActionResponse getPlace(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder
.add("PLACEHOLDER")
.add(
new Place()
.setRequestPrompt("Where would you like to go?")
.setPermissionContext("To find a location"));
return responseBuilder.build();
}
Node.js
const options = {
context: 'To find a location',
prompt: 'Where would you like to go?',
};
conv.ask(new Place(options));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder
.add("PLACEHOLDER")
.add(
new Place()
.setRequestPrompt("Where would you like to go?")
.setPermissionContext("To find a location"));
return responseBuilder.build();
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.PLACE",
"data": {
"@type": "type.googleapis.com/google.actions.v2.PlaceValueSpec",
"dialogSpec": {
"extension": {
"@type": "type.googleapis.com/google.actions.v2.PlaceValueSpec.PlaceDialogSpec",
"permissionContext": "To find a location",
"requestPrompt": "Where would you like to go?"
}
}
}
}
}
}
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.PLACE",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.PlaceValueSpec",
"dialogSpec": {
"extension": {
"@type": "type.googleapis.com/google.actions.v2.PlaceValueSpec.PlaceDialogSpec",
"permissionContext": "To find a location",
"requestPrompt": "Where would you like to go?"
}
}
}
}
]
}
]
}
การรับผลลัพธ์ของผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีเข้าถึงผลลัพธ์ของตัวช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงคําขอที่มีผลลัพธ์ของตัวช่วยที่จะมีการตอบสนอง
ตัวอย่างข้อมูลด้านล่างจะแสดงวิธีตรวจสอบว่าผู้ใช้ให้สิทธิ์เข้าถึง และวิธีการเข้าถึงข้อมูลหรือไม่
Node.js
app.intent('Place Handler', (conv, params, place) => {
if (!place) {
conv.ask(`Sorry, I couldn't get a location from you.`);
} else {
// Place also contains formattedAddress and coordinates
const {name} = place;
conv.ask(`${name} sounds like a great place to go!`);
}
conv.ask('Would you like to try another helper?');
conv.ask(new Suggestions([
'Confirmation',
'DateTime',
'Permission',
]));
});
Java
@ForIntent("Place Handler")
public ActionResponse handlePlace(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
Location location = request.getPlace();
if (location == null) {
responseBuilder.add("Sorry, I couldn't get a location from you.");
} else {
responseBuilder.add(location.getName() + " sounds like a great place to go!");
}
responseBuilder
.add("Would you like to try another helper?")
.addSuggestions(new String[] {"Confirmation", "DateTime", "Permission"});
return responseBuilder.build();
}
Node.js
app.intent('actions.intent.PLACE', (conv) => {
const place = conv.arguments.get('PLACE');
if (!place) {
conv.ask(`Sorry, I couldn't get a location from you.`);
} else {
// Place also contains formattedAddress and coordinates
const {name} = place;
conv.ask(`${name} sounds like a great place to go!`);
}
conv.ask('Would you like to try another helper?');
conv.ask(new Suggestions([
'Confirmation',
'DateTime',
'Permission',
]));
});
Java
@ForIntent("actions.intent.PLACE")
public ActionResponse handlePlace(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
Location location = request.getPlace();
if (location == null) {
responseBuilder.add("Sorry, I couldn't get a location from you.");
} else {
responseBuilder.add(location.getName() + " sounds like a great place to go!");
}
responseBuilder
.add("Would you like to try another helper?")
.addSuggestions(new String[] {"Confirmation", "DateTime", "Permission"});
return responseBuilder.build();
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"responseId": "ce99fd40-b9ed-4151-bc99-f25db9eda8c5-712767ed",
"queryResult": {
"queryText": "actions_intent_PLACE",
"action": "Place.Place-custom",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Webhook failed for intent: Place Handler",
"fulfillmentMessages": [
{
"text": {
"text": [
"Webhook failed for intent: Place Handler"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/place-followup",
"lifespanCount": 1
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_intent_place",
"parameters": {
"PLACE": "KFC, 2523 North Carson Street, Carson City, NV 89706, United States",
"text": "yes"
}
}
],
"intent": {
"name": "projects/df-helpers-kohler/agent/intents/4cf9e154-e151-44db-ae79-84d8c5a707de",
"displayName": "Place Handler"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"permissions": [
"DEVICE_PRECISE_LOCATION"
],
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA",
"type": "ACTIVE",
"conversationToken": "[\"place-followup\"]"
},
"inputs": [
{
"intent": "actions.intent.PLACE",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "Query handled by Actions on Google"
}
],
"arguments": [
{
"name": "PLACE",
"placeValue": {
"coordinates": {
"latitude": 39.182895,
"longitude": -119.7679113
},
"formattedAddress": "KFC, 2523 North Carson Street, Carson City, NV 89706, United States",
"name": "KFC",
"placeId": "ChIJZfBpmMEKmYARFsfc574LgB8"
}
},
{
"name": "text",
"rawText": "yes",
"textValue": "yes"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"device": {
"location": {
"coordinates": {
"latitude": 39.2814592,
"longitude": -120.12421119999999
},
"formattedAddress": "Currant Road, Truckee, California 96161",
"zipCode": "96161",
"city": "Truckee"
}
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
}
]
}
}
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"user": {
"permissions": [
"DEVICE_PRECISE_LOCATION"
],
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHEcidO2jguO4hS8maDeMVx8aasSCcBWZHrF3EmOMIaWRP9qF0BcACistiIoeyiSNTW6KD_tqN_U-xAIOXhPvA",
"type": "NEW"
},
"inputs": [
{
"intent": "actions.intent.PLACE",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "Query handled by Actions on Google"
}
],
"arguments": [
{
"name": "PLACE",
"placeValue": {
"coordinates": {
"latitude": 37.4219999,
"longitude": -122.0840575
},
"formattedAddress": "Googleplex, 1600 Amphitheatre Parkway, Mountain View, CA 94043, United States",
"name": "Googleplex",
"placeId": "ChIJj61dQgK6j4AR4GeTYWZsKWw"
}
},
{
"name": "text",
"rawText": "googleplex",
"textValue": "googleplex"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"device": {
"location": {
"coordinates": {
"latitude": 37.4197238,
"longitude": -122.08212759999999
},
"formattedAddress": "Google Building 45 1585 Charleston Road, Mountain View, California 94043",
"zipCode": "94043",
"city": "Mountain View"
}
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
}
]
}
การยืนยัน
คุณขอการยืนยันทั่วไปจากผู้ใช้ (คําถามใช่/ไม่ใช่) และหาคําตอบที่ต้องการได้ ไวยากรณ์สําหรับคําว่า "ใช่" และ "ไม่" นั้นโดยธรรมชาติขยายไปเป็นสิ่งต่างๆ เช่น "ใช่" หรือ "ไม่" ทําให้ใช้งานได้ในหลายสถานการณ์
กําลังโทรหาผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีที่คุณสามารถเรียกใช้ผู้ช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงการตอบสนองของเว็บฮุคที่เกี่ยวข้อง
คุณจะระบุข้อความแจ้งที่กําหนดเองเมื่อขอการยืนยันจากผู้ใช้ได้
Node.js
app.intent('Confirmation', (conv) => {
conv.ask(new Confirmation('Can you confirm?'));
});
Java
@ForIntent("Confirmation")
public ActionResponse getConfirmation(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder
.add("PLACEHOLDER")
.add(new Confirmation().setConfirmationText("Can you confirm?"));
return responseBuilder.build();
}
Node.js
conv.ask(new Confirmation('Can you confirm?'));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
responseBuilder
.add("PLACEHOLDER")
.add(new Confirmation().setConfirmationText("Can you confirm?"));
return responseBuilder.build();
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.CONFIRMATION",
"data": {
"@type": "type.googleapis.com/google.actions.v2.ConfirmationValueSpec",
"dialogSpec": {
"requestConfirmationText": "Can you confirm?"
}
}
}
}
}
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.CONFIRMATION",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.ConfirmationValueSpec",
"dialogSpec": {
"requestConfirmationText": "Can you confirm?"
}
}
}
]
}
]
}
การรับผลลัพธ์ของผู้ช่วย
ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีเข้าถึงผลลัพธ์ของตัวช่วยเหลือโดยใช้ไลบรารีของไคลเอ็นต์ ข้อมูลโค้ด JSON จะแสดงคําขอที่มีผลลัพธ์ของตัวช่วยที่จะมีการตอบสนอง
หลังจากที่ผู้ใช้ตอบกลับผู้ช่วยเหลือแล้ว คุณจะได้รับคําขอให้ดําเนินการตามคําสั่งซื้อและตรวจสอบได้ว่าผู้ใช้ยืนยันแล้วหรือไม่
Node.js
app.intent('Confirmation Handler', (conv, params, confirmationGranted) => {
conv.ask(confirmationGranted
? 'Thank you for confirming'
: 'No problem, you have not confirmed');
conv.ask('Would you like to try another helper?');
conv.ask(new Suggestions([
'DateTime',
'Permission',
'Place',
]));
});
Java
@ForIntent("Confirmation Handler")
public ActionResponse handleConfirmation(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
boolean userConfirmation = request.getUserConfirmation();
responseBuilder
.add(userConfirmation ? "Thank you for confirming" : "No problem, you have not confirmed")
.addSuggestions(new String[] {"Place", "DateTime", "Permission"});
return responseBuilder.build();
}
Node.js
app.intent('actions.intent.CONFIRMATION', (conv, confirmationGranted) => {
conv.ask(confirmationGranted
? 'Thank you for confirming'
: 'No problem, you have not confirmed');
conv.ask('Would you like to try another helper?');
conv.ask(new Suggestions([
'DateTime',
'Permission',
'Place',
]));
});
Java
@ForIntent("actions.intent.CONFIRMATION")
public ActionResponse handleConfirmation(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
boolean userConfirmation = request.getUserConfirmation();
responseBuilder
.add(userConfirmation ? "Thank you for confirming" : "No problem, you have not confirmed")
.addSuggestions(new String[] {"Place", "DateTime", "Permission"});
return responseBuilder.build();
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"responseId": "26c3dd46-321c-4ab5-9f6c-a445f6d5de01-712767ed",
"queryResult": {
"queryText": "actions_intent_CONFIRMATION",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Webhook failed for intent: Confirmation Handler",
"fulfillmentMessages": [
{
"text": {
"text": [
"Webhook failed for intent: Confirmation Handler"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA/contexts/actions_intent_confirmation",
"parameters": {
"CONFIRMATION": true,
"text": "yes"
}
}
],
"intent": {
"name": "projects/df-helpers-kohler/agent/intents/11cc7c8e-0710-42ea-9cd9-723aff03e97f",
"displayName": "Confirmation Handler"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA",
"type": "ACTIVE",
"conversationToken": "[]"
},
"inputs": [
{
"intent": "actions.intent.CONFIRMATION",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "yes"
}
],
"arguments": [
{
"name": "CONFIRMATION",
"boolValue": true
},
{
"name": "text",
"rawText": "yes",
"textValue": "yes"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}
},
"session": "projects/df-helpers-kohler/agent/sessions/ABwppHEdLCo3vaqVs-pED_sPQDIUr_Ls5JYICyNks9vKbfUaIF8n4P7fYsKEYSiKvD3Vmnli9deu_uTB8s3nPeA"
}
JSON
โปรดทราบว่า JSON ด้านล่างจะอธิบายคําขอเว็บฮุค
{
"user": {
"locale": "en-US",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGY8XRtymCExS313Cc6Vp42zR0uQuGf6BwpSW0772Er-rxSTtFjs3KfGYu6jCDgHbA8IKVWjB8Gr9odc4yHhg",
"type": "NEW"
},
"inputs": [
{
"intent": "actions.intent.CONFIRMATION",
"rawInputs": [
{
"inputType": "KEYBOARD",
"query": "yes"
}
],
"arguments": [
{
"name": "CONFIRMATION",
"boolValue": true
},
{
"name": "text",
"rawText": "yes",
"textValue": "yes"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}