الاستكشاف في Dialogflow
انقر على متابعة لاستيراد نموذج المساعدين في Dialogflow. بعد ذلك، اتّبِع الخطوات أدناه لنشر النموذج واختباره:
- أدخِل اسم وكيل وأنشِئ وكيل Dialogflow جديدًا للنموذج.
- بعد الانتهاء من استيراد الوكيل، انقر على الانتقال إلى الوكيل.
- من قائمة التنقّل الرئيسية، انتقِل إلى توصيل الطلب.
- فعِّل المحرِّر المضمّن، ثم انقر على نشر. يحتوي المحرّر على الرمز النموذجي.
- من قائمة التنقّل الرئيسية، انتقِل إلى عمليات الدمج، ثم انقر على مساعد Google.
- في النافذة المشروطة التي تظهر، فعِّل معاينة التغييرات التلقائية وانقر على اختبار لفتح محاكي الإجراءات.
- في المحاكي، أدخِل
Talk to my test appلاختبار النموذج.
يطلب المساعدون من "مساعد Google" تولّي المحادثة بعد قليل للحصول على البيانات الشائعة، مثل الاسم الكامل للمستخدم أو التاريخ والوقت أو عنوان التسليم. وعندما تطلب الحصول على مساعدة، يعرض "مساعد Google" واجهة مستخدم عادية ومتّسقة للمستخدمين للحصول على هذه المعلومات، وبذلك لن تضطر إلى تصميم تطبيقك الخاص.
نظرة عامة على الاستخدام
وفي ما يلي وصف للعملية العامة لاستخدام المساعد في Dialogflow وحزمة تطوير البرامج "المهام". يمكنك الاطّلاع على الأقسام المحددة لمساعد Google للحصول على مزيد من المعلومات عن كل مقدِّم مساعد.
Dialogflow
Node.js
- اطلب
conv.ask()مع العنصر المناسب للمساعدة. عند طلب وظيفة مساعد، ترسل مكتبة البرامج ردًّا إلى "مساعد Google" يتضمّن الغرض من المساعد. استنادًا إلى النية بالشراء، يعرف "مساعد Google" أن ينفّذ مربّع الحوار للمساعد المناسب. - حدِّد هدف Dialogflow يحدّد حدثًا مطابقًا لأحد عناصر المساعدة. يمكنك الاطّلاع على قسم عناصر المساعدة للحصول على قائمة بالأحداث المتاحة. وليس من الضروري أن تتضمن هذه العبارة أي عبارات يقولها المستخدم، لأنه يتم تشغيلها دائمًا عند تنشيط الفعالية (عند انتهاء "مساعد Google" من تنفيذ المساعد).
- عندما يعرض "مساعد Google" نتيجة المساعد في الطلب اللاحق لتنفيذ الطلب، يتم عرض هدف Dialogflow المقابل وتعالج الغرض منه بشكل طبيعي.
JSON
- حدِّد نية المساعد في العنصر possibleIntent عند الاستجابة لخدمة "مساعد Google". عندما يتلقّى "مساعد Google" الاستجابة، سيعلم أنّ عليه تنفيذ مربّع الحوار للمساعد. يمكنك الاطّلاع على النوايا المساعِدة للحصول على معلومات عن الأهداف التي يمكنك طلبها.
- حدِّد هدف Dialogflow يحدّد حدثًا مطابقًا لأحد عناصر المساعدة. يمكنك الاطّلاع على قسم عناصر المساعدة للحصول على قائمة بالأحداث المتاحة. وليس من الضروري أن تتضمن هذه العبارة أي عبارات يقولها المستخدم، لأنه يتم تشغيلها دائمًا عند تنشيط الفعالية.
- عندما يعرض "مساعد Google" نتيجة المساعد في الطلب التالي لتنفيذ الطلب، عليك تحليل الطلب والبيانات التي تحتاج إليها.
حزمة تطوير برامج المهام
Node.js
- اطلب
askمع المعلَمات المناسبة. تطلب الدالة المساعِدة من "مساعد Google" تنفيذ أحد الأهداف الواردة في أغراض المساعدة. وعند طلب وظيفة مساعدة، تُرسل مكتبة البرامج ردًّا إلى "مساعد Google" يتضمّن أحد الأهداف التالية. استنادًا إلى النية بالشراء، يتعرّف "مساعد Google" على مربع الحوار الخاص بالمساعد المناسب. - عندما يعرض "مساعد Google" نتيجة المساعد في الطلب التالي لتنفيذ الطلب، ستتلقّى الغرض من الطلب في الطلب. يتيح لك ذلك اكتشاف أنّ المساعد قد عرض نتيجة بحث. استخدِم وظيفة الحصول على المعلومات المقابلة للمساعد للحصول على البيانات التي تحتاج إليها.
JSON
- حدِّد نية المساعد في العنصر possibleIntent عند الاستجابة لخدمة "مساعد Google". عندما يتلقّى "مساعد Google" الاستجابة، سيعلم أنّ عليه تنفيذ مربّع الحوار للمساعد. يمكنك الاطّلاع على النوايا المساعِدة للحصول على معلومات عن الأهداف التي يمكنك طلبها.
- عندما يعرض "مساعد Google" نتيجة المساعد في الطلب التالي لتنفيذ الطلب، عليك تحليل الطلب والبيانات التي تحتاج إليها.
نوايا المساعد
ويوضّح الجدول التالي الأهداف المتوفرة التي يمكنك طلبها من "مساعد Google". إذا كنت تستخدم Dialogflow، ستحتاج أيضًا إلى إنشاء هدف Dialogflow يحدّد الحدث المقابل لغرض intent.
| اسم النية بالشراء | اسم حدث Dialogflow | الاستخدام |
|---|---|---|
actions.intent.PERMISSION |
actions_intent_PERMISSION |
الحصول على الاسم الكامل للمستخدم أو الموقع الجغرافي التقريبي أو الموقع الجغرافي الدقيق أو جميعها 3 |
actions.intent.OPTION |
actions_intent_OPTION |
تلقّي العنصر المحدّد من قائمة واجهة مستخدم أو لوحة عرض دوّارة أما إذا لم يختَر المستخدم من القائمة أو واجهة المستخدم في لوحة العرض الدوّارة، فعليك تلقّي إدخال كلام أو نص يتطابق مع المفتاح في القائمة أو واجهة مستخدم لوحة العرض الدوّارة. |
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"
}
]
}
]
}
ويوضّح المقتطف أعلاه كيفية التحقق مما إذا كان المستخدم قد منحك المعلومات، ثم الوصول إلى البيانات.
وعند الحصول على معلومات المستخدم، ننصحك بالاحتفاظ بهذه المعلومات حتى لا تضطر إلى طلبها مرة أخرى. يمكنك استخدام مساحة تخزين المستخدم لتخزين معلومات المستخدم في جميع المحادثات. اطّلِع على نموذج Name Psychic في 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."
}
}
]
}
}
}
]
}
يمكنك عرض قائمة واجهة مستخدم أو لوحة عرض دوّارة والحصول على الخيار المحدّد من المستخدم بهدف 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"
}
التاريخ والوقت
يمكنك الحصول على التاريخ والوقت من المستخدمين من خلال طلب تنفيذ الغرض من 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"
}
]
}
]
}
تسجيل الدخول إلى الحساب
يمكنك أن تطلب من المستخدمين تسجيل الدخول إلى حساباتهم المرتبطة
بخدمتك من خلال طلب تنفيذ الغرض من 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"
}
]
}
]
}
المكان والموقع الجغرافي
يمكنك الحصول على موقع جغرافي من المستخدمين من خلال طلب تنفيذ الهدف actions.intent.PLACE. ويتم استخدام هذا المساعد لمطالبة المستخدم بالعناوين الجغرافية والمواقع الأخرى، بما في ذلك المواقع الجغرافية للمنازل/العمل/جهات الاتصال التي تم حفظها مع Google.
وستعرض المواقع الجغرافية المحفوظة العنوان فقط، وليس عملية الربط المرتبطة (على سبيل المثال، "123 الشارع الرئيسي" بدلاً من "الصفحة الرئيسية = 123 الشارع الرئيسي").
طلب المساعد
يوضّح مثال الرمز التالي كيفية طلب المساعد باستخدام مكتبة البرامج. تعرض مقتطفات 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"
}
]
}
]
}