Возможности платформы (Dialogflow)

Попробуйте фрагменты кода. Импортируйте, развертывайте и изучайте фрагменты кода в контексте с помощью нового агента Dialogflow.

Попробовать Dialogflow

Посмотреть в Dialogflow

Нажмите Continue (Продолжить), чтобы импортировать пример возможностей платформы в Dialogflow. Затем выполните следующие действия, чтобы развернуть и протестировать пример:

1. Введите название агента и создайте новый агент Dialogflow для примера.
2. После завершения импорта нажмите Перейти к агенту.
3. В главном меню навигации выберите Выполнение заказов.
4. Включите встроенный редактор и нажмите Развернуть. В редакторе появится образец кода.
5. В главном меню навигации выберите Integrations (Интеграции), а затем нажмите Google Assistant (Google Ассистент).
6. В появившемся модальном окне включите Auto-preview changes (Автоматический предпросмотр изменений) и нажмите Test (Протестировать), чтобы открыть симулятор действий.
7. Введите Talk to my test app в симуляторе, чтобы протестировать пример.

Продолжить Отмена

Ваши действия могут появляться на различных платформах, включая аудиоплатформы (умные колонки) и аудио- и видеоплатформы (например, умные дисплеи и мобильные устройства).

Чтобы создавать разговоры, которые будут хорошо работать на всех платформах, используйте возможности платформ для управления разговорами и их масштабирования.

Возможности платформ для Действий

Actions on Google позволяет контролировать, могут ли пользователи вызывать ваше действие, в зависимости от используемой ими платформы. Если пользователь попытается вызвать действие на неподдерживаемом устройстве, он получит сообщение об ошибке.

Поддержка платформ настраивается в проекте Actions.

Примечание. Выбирайте этот вариант, только если все действия в вашем проекте зависят от воспроизведения медиаконтента. Например, если ваше действие только воспроизводит аудиозапись, которая выводит медиаответ, выберите этот вариант. Если ваше действие также предоставляет другую информацию, например данные фондового рынка, не выбирайте этот вариант. В последнем случае вы можете программно проверить наличие функции воспроизведения медиаконтента и отреагировать соответствующим образом.

Ваше действие может появляться на различных платформах, поддерживаемых Ассистентом, например на смартфонах (Android и iOS) и устройствах Google Home.

Возможности платформы среды выполнения

Вы можете адаптировать пользовательский интерфейс с помощью возможностей поверхности среды выполнения двумя основными способами:

• Разветвление ответов. Вы можете предлагать пользователям разные ответы, но сохранять одну и ту же структуру и ход разговора на разных платформах. Например, действие, связанное с погодой, может показывать карточку с изображением на телефоне и воспроизводить аудиофайл на Google Home, но поток разговора одинаков для всех поверхностей.

• Разветвление разговора. Пользователи могут вести совершенно разные разговоры на разных поверхностях. Например, если вы создаете приложение для заказа еды, вы можете реализовать функцию повторного заказа на Google Home, а функцию сборки корзины – на мобильных телефонах. Чтобы создать ветвление диалога, ограничьте запуск намерений в Dialogflow определенными возможностями платформы с помощью контекстов Dialogflow. Намерения Dialogflow не активируются, если не поддерживается определенная функция платформы.

  Примечание. Возможности устройства пользователя могут измениться в процессе разговора. Не рассчитывайте на то, что набор возможностей останется неизменным после начала разговора.

• Разговоры на нескольких платформах. Пользователь начинает разговор на одной платформе, а продолжает на другой. Например, если пользователь вызывает действие с изображениями на устройстве, которое поддерживает только аудио, например Google Home, вы можете настроить действие так, чтобы оно искало другое устройство с поддержкой визуальных возможностей и переносило разговор туда, если это возможно.

Разветвление ответов

Каждый раз, когда ваш сервис получает запрос от Google Ассистента, вы можете запрашивать возможности следующих платформ (например, Google Home или телефона Android):

Node.js

const hasScreen =
  conv.surface.capabilities.has('actions.capability.SCREEN_OUTPUT');
  // OR conv.screen;
const hasAudio =
  conv.surface.capabilities.has('actions.capability.AUDIO_OUTPUT');
const hasMediaPlayback =
  conv.surface.capabilities.has('actions.capability.MEDIA_RESPONSE_AUDIO');
const hasWebBrowser =
  conv.surface.capabilities.has('actions.capability.WEB_BROWSER');
// Interactive Canvas must be enabled in your project to see this
const hasInteractiveCanvas =
  conv.surface.capabilities.has('actions.capability.INTERACTIVE_CANVAS');
index.js

Java

boolean hasScreen = request.hasCapability(Capability.SCREEN_OUTPUT.getValue());
boolean hasAudio = request.hasCapability(Capability.AUDIO_OUTPUT.getValue());
boolean hasMediaPlayback = request.hasCapability(Capability.MEDIA_RESPONSE_AUDIO.getValue());
boolean hasWebBrowser = request.hasCapability(Capability.WEB_BROWSER.getValue());
// Interactive Canvas must be enabled in your project to see this
boolean hasInteractiveCanvas = request.hasCapability("INTERACTIVE_CANVAS");
MyActionsApp.java

Node.js

const hasScreen =
  conv.surface.capabilities.has('actions.capability.SCREEN_OUTPUT');
  // OR conv.screen;
const hasAudio =
  conv.surface.capabilities.has('actions.capability.AUDIO_OUTPUT');
const hasMediaPlayback =
  conv.surface.capabilities.has('actions.capability.MEDIA_RESPONSE_AUDIO');
const hasWebBrowser =
  conv.surface.capabilities.has('actions.capability.WEB_BROWSER');
// Interactive Canvas must be enabled in your project to see this
const hasInteractiveCanvas =
  conv.surface.capabilities.has('actions.capability.INTERACTIVE_CANVAS');
index.js

Java

boolean hasScreen = request.hasCapability(Capability.SCREEN_OUTPUT.getValue());
boolean hasAudio = request.hasCapability(Capability.AUDIO_OUTPUT.getValue());
boolean hasMediaPlayback = request.hasCapability(Capability.MEDIA_RESPONSE_AUDIO.getValue());
boolean hasWebBrowser = request.hasCapability(Capability.WEB_BROWSER.getValue());
// Interactive Canvas must be enabled in your project to see this
boolean hasInteractiveCanvas = request.hasCapability("INTERACTIVE_CANVAS");
MyActionsApp.java

Файл в формате JSON

Обратите внимание, что приведенный ниже код JSON описывает запрос вебхука.

{
  "responseId": "206a66fb-a572-4cfc-9e41-8e2eb62fdf18-712767ed",
  "queryResult": {
    "queryText": "Current capabilities",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentText": "Webhook failed for intent: Current Capabilities",
    "fulfillmentMessages": [
      {
        "text": {
          "text": [
            "Webhook failed for intent: Current Capabilities"
          ]
        }
      }
    ],
    "outputContexts": [
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_media_response_audio"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_audio_output"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_account_linking"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_web_browser"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_screen_output"
      },
      {
        "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/google_assistant_input_type_touch"
      }
    ],
    "intent": {
      "name": "projects/df-surface-caps-kohler/agent/intents/4e191eef-ba17-4f68-8a97-85a43cbc9ed1",
      "displayName": "Current Capabilities"
    },
    "intentDetectionConfidence": 1,
    "languageCode": "en"
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "user": {
        "locale": "en-US",
        "userVerificationStatus": "VERIFIED"
      },
      "conversation": {
        "conversationId": "ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ",
        "type": "ACTIVE",
        "conversationToken": "[]"
      },
      "inputs": [
        {
          "intent": "actions.intent.TEXT",
          "rawInputs": [
            {
              "inputType": "TOUCH",
              "query": "Current capabilities"
            }
          ],
          "arguments": [
            {
              "name": "text",
              "rawText": "Current capabilities",
              "textValue": "Current capabilities"
            }
          ]
        }
      ],
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.ACCOUNT_LINKING"
          },
          {
            "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-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ"
}

Файл в формате JSON

Обратите внимание, что приведенный ниже код JSON описывает запрос вебхука.

{
  "user": {
    "locale": "en-US",
    "userVerificationStatus": "VERIFIED"
  },
  "conversation": {
    "conversationId": "ABwppHENuB8dw7LgVquXnW5Bmy9hwu1Qz4bsaL7uIb9vDSBYPAFhFgsMWnMV6m4JEDgaUWz9FUVuIhQqWh1KZ_jjTwKEIlza",
    "type": "NEW"
  },
  "inputs": [
    {
      "intent": "actions.intent.TEXT",
      "rawInputs": [
        {
          "inputType": "TOUCH",
          "query": "Current capabilities"
        }
      ],
      "arguments": [
        {
          "name": "text",
          "rawText": "Current capabilities",
          "textValue": "Current capabilities"
        }
      ]
    }
  ],
  "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.WEB_BROWSER"
        },
        {
          "name": "actions.capability.AUDIO_OUTPUT"
        },
        {
          "name": "actions.capability.SCREEN_OUTPUT"
        }
      ]
    }
  ]
}

Разветвление чата

Вы можете настроить намерения Dialogflow так, чтобы они активировались только при определенных возможностях с заранее заданными контекстами Dialogflow. Каждый раз, когда намерение совпадает, Dialogflow автоматически генерирует контексты из набора возможностей поверхности, доступных на устройстве. Вы можете указать один или несколько таких контекстов в качестве входных для своих намерений. Это позволяет ограничить активацию намерения в зависимости от модальности.

Например, если вы хотите, чтобы намерение срабатывало только на устройствах с экраном, вы можете задать для него входной контекст actions_capability_screen_output.

Доступны следующие контексты:

• actions_capability_audio_output – на устройстве есть динамик.
• actions_capability_screen_output – у устройства есть экран.
• actions_capability_media_response_audio – устройство поддерживает воспроизведение медиаконтента.
• actions_capability_web_browser – устройство поддерживает веб-браузер. (Эта функция пока недоступна на умных дисплеях.)

Вот пример намерения, которое будет срабатывать только на устройствах с экранами:

Разговоры на разных платформах

На любом этапе выполнения действия вы можете проверить, есть ли у пользователя другие устройства с определенной функцией. Если доступна другая платформа с нужной функцией, вы можете перенести текущий разговор на нее.

Примечание. Перенести разговор можно только на устройство с экраном, например телефон Android или iOS.

Перенос будет выполняться следующим образом:

1. Проверьте, есть ли у пользователя доступная поверхность

   В обработчике вебхука вы можете запросить, есть ли у пользователя поверхность с определенной возможностью. Обратите внимание, что эта платформа должна быть связана с тем же аккаунтом Google, что и исходная платформа.

   Node.js

   const screenAvailable =
     conv.available.surfaces.capabilities.has(
       'actions.capability.SCREEN_OUTPUT');
   index.js

   Java

   String screen = Capability.SCREEN_OUTPUT.getValue();
   boolean screenAvailable = false;
   for (Surface surface : request.getAvailableSurfaces()) {
     for (com.google.api.services.actions_fulfillment.v2.model.Capability capability :
         surface.getCapabilities()) {
       if (capability.getName().equals(screen)) {
         screenAvailable = true;
         break;
       }
     }
   }
   MyActionsApp.java

   Node.js

   const screenAvailable =
     conv.available.surfaces.capabilities.has(
       'actions.capability.SCREEN_OUTPUT');
   index.js

   Java

   String screen = Capability.SCREEN_OUTPUT.getValue();
   boolean screenAvailable = false;
   for (Surface surface : request.getAvailableSurfaces()) {
     for (com.google.api.services.actions_fulfillment.v2.model.Capability capability :
         surface.getCapabilities()) {
       if (capability.getName().equals(screen)) {
         screenAvailable = true;
         break;
       }
     }
   }
   MyActionsApp.java

   Файл в формате JSON

   Обратите внимание, что приведенный ниже код JSON описывает запрос вебхука.

   {
     "responseId": "206a66fb-a572-4cfc-9e41-8e2eb62fdf18-712767ed",
     "queryResult": {
       "queryText": "Current capabilities",
       "parameters": {},
       "allRequiredParamsPresent": true,
       "fulfillmentText": "Webhook failed for intent: Current Capabilities",
       "fulfillmentMessages": [
         {
           "text": {
             "text": [
               "Webhook failed for intent: Current Capabilities"
             ]
           }
         }
       ],
       "outputContexts": [
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_media_response_audio"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_audio_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_account_linking"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_web_browser"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/actions_capability_screen_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ/contexts/google_assistant_input_type_touch"
         }
       ],
       "intent": {
         "name": "projects/df-surface-caps-kohler/agent/intents/4e191eef-ba17-4f68-8a97-85a43cbc9ed1",
         "displayName": "Current Capabilities"
       },
       "intentDetectionConfidence": 1,
       "languageCode": "en"
     },
     "originalDetectIntentRequest": {
       "source": "google",
       "version": "2",
       "payload": {
         "user": {
           "locale": "en-US",
           "userVerificationStatus": "VERIFIED"
         },
         "conversation": {
           "conversationId": "ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ",
           "type": "ACTIVE",
           "conversationToken": "[]"
         },
         "inputs": [
           {
             "intent": "actions.intent.TEXT",
             "rawInputs": [
               {
                 "inputType": "TOUCH",
                 "query": "Current capabilities"
               }
             ],
             "arguments": [
               {
                 "name": "text",
                 "rawText": "Current capabilities",
                 "textValue": "Current capabilities"
               }
             ]
           }
         ],
         "surface": {
           "capabilities": [
             {
               "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
             },
             {
               "name": "actions.capability.AUDIO_OUTPUT"
             },
             {
               "name": "actions.capability.ACCOUNT_LINKING"
             },
             {
               "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-surface-caps-kohler/agent/sessions/ABwppHG7pYytu-kJGJApvrFTk2iNkshy-NLsjlzJg2ntVbxZkoz-rdFch3Fd8Vmlgf0VxmNSK1woelx1otayGwCnE8gzAQ"
   }

   Файл в формате JSON

   Обратите внимание, что приведенный ниже код JSON описывает запрос вебхука.

   {
     "user": {
       "locale": "en-US",
       "userVerificationStatus": "VERIFIED"
     },
     "conversation": {
       "conversationId": "ABwppHENuB8dw7LgVquXnW5Bmy9hwu1Qz4bsaL7uIb9vDSBYPAFhFgsMWnMV6m4JEDgaUWz9FUVuIhQqWh1KZ_jjTwKEIlza",
       "type": "NEW"
     },
     "inputs": [
       {
         "intent": "actions.intent.TEXT",
         "rawInputs": [
           {
             "inputType": "TOUCH",
             "query": "Current capabilities"
           }
         ],
         "arguments": [
           {
             "name": "text",
             "rawText": "Current capabilities",
             "textValue": "Current capabilities"
           }
         ]
       }
     ],
     "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.WEB_BROWSER"
           },
           {
             "name": "actions.capability.AUDIO_OUTPUT"
           },
           {
             "name": "actions.capability.SCREEN_OUTPUT"
           }
         ]
       }
     ]
   }

2. Запрос на перенос пользователя на новую платформу

   Если доступна поверхность с нужными возможностями, ваше действие должно спросить пользователя, хочет ли он перенести разговор.

   Node.js

   if (conv.screen) {
     conv.ask(`You're already on a screen device.`);
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Current Capabilities',
       'Check Audio Capability',
       'Check Screen Capability',
       'Check Media Capability',
       'Check Web Capability',
     ]));
     return;
   } else if (screenAvailable) {
     const context =
       `Let's move you to a screen device for cards and other visual responses`;
     const notification = 'Try your Action here!';
     const capabilities = ['actions.capability.SCREEN_OUTPUT'];
     return conv.ask(new NewSurface({context, notification, capabilities}));
   } else {
     conv.ask('It looks like there is no screen device ' +
       'associated with this user.');
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Current Capabilities',
       'Check Audio Capability',
       'Check Screen Capability',
       'Check Media Capability',
       'Check Web Capability',
     ]));
   };
   index.js

   Java

   ResponseBuilder responseBuilder = getResponseBuilder(request);
   if (request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
     responseBuilder.add("You're already on a screen device");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Transfer surface",
           "Check Audio Capability",
           "Check Screen Capability",
           "Check Media Capability",
           "Check Web Capability",
         });
     return responseBuilder.build();
   } else if (screenAvailable) {
     responseBuilder.add(
         new NewSurface()
             .setContext("Let's move you to a screen device for cards and other visual responses")
             .setNotificationTitle("Try your Action here!")
             .setCapabilities(Collections.singletonList(screen)));
     return responseBuilder.build();
   } else {
     responseBuilder.add("It looks like there is no screen device associated with this user.");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Transfer surface",
           "Check Audio Capability",
           "Check Screen Capability",
           "Check Media Capability",
           "Check Web Capability",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   Node.js

   if (conv.screen) {
     conv.ask(`You're already on a screen device.`);
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Transfer surface',
       'Current capabilities',
     ]));
     return;
   } else if (screenAvailable) {
     const context =
       `Let's move you to a screen device for cards and other visual responses`;
     const notification = 'Try your Action here!';
     const capabilities = ['actions.capability.SCREEN_OUTPUT'];
     return conv.ask(new NewSurface({context, notification, capabilities}));
   } else {
     conv.ask('It looks like there is no screen device ' +
       'associated with this user.');
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Transfer surface',
       'Current capabilities',
     ]));
   };
   index.js

   Java

   ResponseBuilder responseBuilder = getResponseBuilder(request);
   if (request.hasCapability(Capability.SCREEN_OUTPUT.getValue())) {
     responseBuilder.add("You're already on a screen device");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Current capabilities", "Transfer surface",
         });
     return responseBuilder.build();
   } else if (screenAvailable) {
     responseBuilder.add(
         new NewSurface()
             .setContext("Let's move you to a screen device for cards and other visual responses")
             .setNotificationTitle("Try your Action here!")
             .setCapabilities(Collections.singletonList(screen)));
     return responseBuilder.build();
   } else {
     responseBuilder.add("It looks like there is no screen device associated with this user.");
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Current capabilities", "Transfer surface",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   Файл в формате JSON

   Обратите внимание, что приведенный ниже код JSON описывает ответ вебхука.

   {
     "payload": {
       "google": {
         "expectUserResponse": true,
         "systemIntent": {
           "intent": "actions.intent.NEW_SURFACE",
           "data": {
             "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValueSpec",
             "capabilities": [
               "actions.capability.SCREEN_OUTPUT"
             ],
             "context": "Let's move you to a screen device for cards and other visual responses",
             "notificationTitle": "Try your Action here!"
           }
         }
       }
     }
   }

   Файл в формате JSON

   Обратите внимание, что приведенный ниже код JSON описывает ответ вебхука.

   {
     "expectUserResponse": true,
     "expectedInputs": [
       {
         "possibleIntents": [
           {
             "intent": "actions.intent.NEW_SURFACE",
             "inputValueData": {
               "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValueSpec",
               "capabilities": [
                 "actions.capability.SCREEN_OUTPUT"
               ],
               "context": "Let's move you to a screen device for cards and other visual responses",
               "notificationTitle": "Try your Action here!"
             }
           }
         ]
       }
     ]
   }

   Примечание. Текущий сеанс и все связанные с ним данные сохраняются на новом устройстве. Это означает, что на новом устройстве будут доступны все данные с предыдущего, включая conversationToken (если вы используете API вебхука HTTP/JSON для разговоров) и любой контекст вывода Dialogflow, а идентификатор разговора останется прежним. Если вы используете клиентскую библиотеку Node.js, то можете хранить данные в свойстве conv.data.
   Предупреждение. Если вы запросите функции, которые не поддерживаются ни на одном из доступных пользователю устройств, во время выполнения возникнет ошибка.
3. Как обрабатывать ответы пользователей

   В зависимости от ответа пользователя действие либо выполнит перенос, либо вернет управление разговором на исходное устройство. В любом случае следующий запрос к вашей конечной точке будет содержать намерение actions.intent.NEW_SURFACE, поэтому вам нужно создать намерение, которое активируется при этом событии, с соответствующим обработчиком в вашем вебхуке. В коде обработчика следует проверить, была ли передача успешной.

   Node.js

   app.intent('Transfer Surface - NEW_SURFACE', (conv, input, newSurface) => {
     if (newSurface.status === 'OK') {
       conv.ask('Welcome to a screen device!');
       conv.ask(new BasicCard({
         title: `You're on a screen device!`,
         text: `Screen devices support basic cards and other visual responses!`,
       }));
     } else {
       conv.ask(`Ok, no problem.`);
     }
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Current Capabilities',
       'Check Audio Capability',
       'Check Screen Capability',
       'Check Media Capability',
       'Check Web Capability',
     ]));
   });
   index.js

   Java

   @ForIntent("Transfer Surface - NEW_SURFACE")
   public ActionResponse newSurface(ActionRequest request) {
     ResponseBuilder responseBuilder = getResponseBuilder(request);
     Map<String, Object> newSurfaceStatus = request.getArgument("NEW_SURFACE").getExtension();
     if (newSurfaceStatus.get("status").equals("OK")) {
       responseBuilder.add("Welcome to a screen device!");
       responseBuilder.add(
           new BasicCard()
               .setTitle("You're on a screened device!")
               .setFormattedText("Screen devices support basic cards and other visual responses!"));
     } else {
       responseBuilder.add("Ok, no problem.");
     }
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Transfer surface",
           "Check Audio Capability",
           "Check Screen Capability",
           "Check Media Capability",
           "Check Web Capability",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   Node.js

   app.intent('actions.intent.NEW_SURFACE', (conv) => {
     if (conv.arguments.get('NEW_SURFACE').status === 'OK') {
       conv.ask('Welcome to a screen device!');
       conv.ask(new BasicCard({
         title: `You're on a screen device!`,
         text: `Screen devices support basic cards and other visual responses!`,
       }));
     } else {
       conv.ask(`Ok, no problem.`);
     }
     conv.ask('What else would you like to try?');
     conv.ask(new Suggestions([
       'Transfer surface',
       'Current capabilities',
     ]));
   });
   index.js

   Java

   @ForIntent("actions.intent.NEW_SURFACE")
   public ActionResponse newSurface(ActionRequest request) {
     ResponseBuilder responseBuilder = getResponseBuilder(request);
     Map<String, Object> newSurfaceStatus = request.getArgument("NEW_SURFACE").getExtension();
     if (newSurfaceStatus.get("status").equals("OK")) {
       responseBuilder.add("Welcome to a screen device!");
       responseBuilder.add(
           new BasicCard()
               .setTitle("You're on a screened device!")
               .setFormattedText("Screen devices support basic cards and other visual responses!"));
     } else {
       responseBuilder.add("Ok, no problem.");
     }
     responseBuilder.add("What else would you like to try?");
     responseBuilder.addSuggestions(
         new String[] {
           "Current capabilities", "Transfer surface",
         });
     return responseBuilder.build();
   }
   MyActionsApp.java

   Файл в формате JSON

   Обратите внимание, что приведенный ниже код JSON описывает запрос вебхука.

   {
     "responseId": "94b74485-cd7a-4b3b-b96a-fec15f3a496c-712767ed",
     "queryResult": {
       "queryText": "actions_intent_NEW_SURFACE",
       "parameters": {},
       "allRequiredParamsPresent": true,
       "fulfillmentText": "Webhook failed for intent: Transfer Surface - NEW_SURFACE",
       "fulfillmentMessages": [
         {
           "text": {
             "text": [
               "Webhook failed for intent: Transfer Surface - NEW_SURFACE"
             ]
           }
         }
       ],
       "outputContexts": [
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_screen_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_web_browser"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_audio_output"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_media_response_audio"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_capability_account_linking"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/google_assistant_input_type_voice"
         },
         {
           "name": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q/contexts/actions_intent_new_surface",
           "parameters": {
             "NEW_SURFACE": {
               "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValue",
               "status": "OK"
             },
             "text": ""
           }
         }
       ],
       "intent": {
         "name": "projects/df-surface-caps-kohler/agent/intents/9db3798d-bdac-4dc8-a8e7-52349a3af0e8",
         "displayName": "Transfer Surface - NEW_SURFACE"
       },
       "intentDetectionConfidence": 1,
       "languageCode": "en"
     },
     "originalDetectIntentRequest": {
       "source": "google",
       "version": "2",
       "payload": {
         "user": {
           "locale": "en-US",
           "userVerificationStatus": "VERIFIED"
         },
         "conversation": {
           "conversationId": "ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q",
           "type": "ACTIVE",
           "conversationToken": "[]"
         },
         "inputs": [
           {
             "intent": "actions.intent.NEW_SURFACE",
             "rawInputs": [
               {
                 "inputType": "VOICE"
               }
             ],
             "arguments": [
               {
                 "name": "NEW_SURFACE",
                 "extension": {
                   "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValue",
                   "status": "OK"
                 }
               },
               {
                 "name": "text"
               }
             ]
           }
         ],
         "surface": {
           "capabilities": [
             {
               "name": "actions.capability.SCREEN_OUTPUT"
             },
             {
               "name": "actions.capability.WEB_BROWSER"
             },
             {
               "name": "actions.capability.AUDIO_OUTPUT"
             },
             {
               "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
             },
             {
               "name": "actions.capability.ACCOUNT_LINKING"
             }
           ]
         },
         "availableSurfaces": [
           {
             "capabilities": [
               {
                 "name": "actions.capability.SCREEN_OUTPUT"
               },
               {
                 "name": "actions.capability.WEB_BROWSER"
               },
               {
                 "name": "actions.capability.AUDIO_OUTPUT"
               }
             ]
           }
         ]
       }
     },
     "session": "projects/df-surface-caps-kohler/agent/sessions/ABwppHEfQy-JgH7nmiW5gHWiDEyvqNRSPv9zkd3qTVF7F8G8YXJFI2_yal335Co0Z-_N5oUBTmVO_DJUlQONqd5lUgZz-Q"
   }

   Файл в формате JSON

   Обратите внимание, что приведенный ниже код JSON описывает запрос вебхука.

   {
     "user": {
       "locale": "en-US",
       "userVerificationStatus": "VERIFIED"
     },
     "conversation": {
       "conversationId": "ABwppHENAOzBH5swn9iKb5QgUliTw4JLu5f86gS373tGtNvYcz1C3qHdorjcIb77o_PUleXGzIEFdPsl3-kmIAARvx67A7Ym",
       "type": "NEW"
     },
     "inputs": [
       {
         "intent": "actions.intent.NEW_SURFACE",
         "rawInputs": [
           {
             "inputType": "VOICE"
           }
         ],
         "arguments": [
           {
             "name": "NEW_SURFACE",
             "extension": {
               "@type": "type.googleapis.com/google.actions.v2.NewSurfaceValue",
               "status": "OK"
             }
           },
           {
             "name": "text"
           }
         ]
       }
     ],
     "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"
         }
       ]
     },
     "availableSurfaces": [
       {
         "capabilities": [
           {
             "name": "actions.capability.WEB_BROWSER"
           },
           {
             "name": "actions.capability.AUDIO_OUTPUT"
           },
           {
             "name": "actions.capability.SCREEN_OUTPUT"
           }
         ]
       }
     ]
   }