Funciones de superficie (Dialogflow)

Prueba los fragmentos: Importa, implementa y explora fragmentos de código en contexto con un nuevo agente de Dialogflow.

Explorar en Dialogflow

Explorar en Dialogflow

Haz clic en Continuar para importar nuestra muestra de funciones de Surface en Dialogflow. Luego, sigue los pasos que se indican a continuación para implementar y probar la muestra:

1. Ingresa un nombre de agente y crea un agente de Dialogflow nuevo para la muestra.
2. Cuando el agente termine de importarse, haz clic en Ir al agente.
3. En el menú de navegación principal, ve a Fulfillment (Entrega).
4. Habilita el Editor intercalado y, luego, haz clic en Implementar. El editor contiene el código de muestra.
5. En el menú de navegación principal, ve a Integraciones y, luego, haz clic en Asistente de Google.
6. En la ventana modal que aparece, habilita la opción Vista previa automática de cambios y haz clic en Probar para abrir el simulador de Actions.
7. En el simulador, ingresa Talk to my test app para probar la muestra.

Continuar Cancelar

Tus acciones pueden aparecer en varias plataformas, como plataformas de solo audio (bocinas inteligentes) y superficies de audio y pantalla (como pantallas inteligentes y dispositivos móviles).

A fin de diseñar y crear conversaciones que funcionen bien en todas las plataformas, usa sus capacidades para controlar y definir el alcance de tus conversaciones de forma adecuada.

Capacidades de superficie para acciones

Actions on Google te permite controlar si los usuarios pueden o no invocar tu acción, según la plataforma que usen. Si los usuarios intentan invocar tu acción en una plataforma no compatible, recibirán un mensaje de error en el que se les indicará que su dispositivo no es compatible.

Defines la compatibilidad de superficie de tu acción en tu proyecto de acciones.

Nota: Solo debes verificar la opción de capacidad de superficie de reproducción de contenido multimedia si toda tu acción depende de ella. Por ejemplo, si tu acción no hace más que reproducir una pista de audio que genera una respuesta multimedia, debes marcar esta opción. Si tu acción también proporciona otra información, como los datos del mercado de valores, no deberías marcar esta opción. En este último caso, debes verificar de forma programática la capacidad de la plataforma de reproducción de contenido multimedia y responder según corresponda.

Tu acción puede aparecer en una variedad de plataformas compatibles con Asistente, como smartphones (iOS y Android) y dispositivos Google Home.

Capacidades del entorno de ejecución

Puedes proporcionar la experiencia del usuario con capacidades de superficie de tiempo de ejecución de dos maneras principales:

• Rama de respuestas: Presenta diferentes respuestas para los usuarios, pero tiene la misma estructura y flujo para tu conversación en las diferentes plataformas. Por ejemplo, una acción meteorológica puede mostrar una tarjeta con una imagen en un teléfono y reproducir un archivo de audio en Google Home, pero el flujo de conversación es el mismo en todas las plataformas.

• Rama de conversación: Se presenta a los usuarios una conversación completamente diferente en cada plataforma. Por ejemplo, si compilas una app de pedidos de comida, es posible que quieras proporcionar un flujo de reordenamiento en Google Home, pero un flujo de ensamblado de carrito completo en teléfonos celulares. Para ramificarse las conversaciones, define el alcance de la activación de Dialogflow a ciertas capacidades de superficie con contextos de Dialogflow. Los intents reales de Dialogflow no se activan, a menos que se cumpla una capacidad específica de la superficie.

  Nota: Las capacidades de la superficie del dispositivo de un usuario pueden cambiar durante la conversación. No dependas de un conjunto constante de capacidades una vez que haya comenzado una conversación.

• Conversaciones en varias superficies: Se presenta a los usuarios una conversación en una superficie que pasa a otra en medio de la conversación. Por ejemplo, si un usuario invoca tu acción con imágenes en una superficie de solo audio, como Google Home, puedes compilar tu acción para buscar otra superficie con capacidades visuales y mover la conversación allí si es posible.

Ramificación de respuestas

Cada vez que tu entrega recibe una solicitud del Asistente de Google, puedes consultar las siguientes funciones (por ejemplo, Google Home o un teléfono 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

Ten en cuenta que el JSON a continuación describe una solicitud de webhook.

{
  "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

Ten en cuenta que el JSON a continuación describe una solicitud de webhook.

{
  "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"
        }
      ]
    }
  ]
}

Ramificación de conversaciones

Puedes configurar los intents de Dialogflow para que solo se activen en ciertas capacidades con contextos predefinidos de Dialogflow. Cada vez que se detecta una coincidencia con un intent, Dialogflow genera automáticamente contextos a partir del conjunto de funciones disponibles para el dispositivo. Puedes especificar uno o más de estos contextos como "contextos de entrada" para tus intents. Esto le permite controlar la activación de intents en función de la modalidad.

Por ejemplo, si solo quieres que se active un intent en dispositivos con salida de pantalla, puedes establecer un contexto de entrada en el intent para que sea actions_capability_screen_output.

Están disponibles los siguientes contextos:

• actions_capability_audio_output: El dispositivo tiene un altavoz.
• actions_capability_screen_output: El dispositivo tiene una pantalla de salida.
• actions_capability_media_response_audio: El dispositivo admite la reproducción de contenido multimedia.
• actions_capability_web_browser: El dispositivo es compatible con un navegador web. (Actualmente, esta función no está disponible para pantallas inteligentes).

El siguiente es un ejemplo de un intent que solo se activará en plataformas con pantallas:

Conversaciones sobre varias superficies

En cualquier momento durante el flujo de tu acción, puedes verificar si el usuario tiene otras plataformas con una capacidad específica. Si hay otra plataforma con la capacidad solicitada disponible, puedes transferir la conversación actual a esa plataforma nueva.

Nota: Una conversación solo se puede transferir en función de la capacidad de la pantalla con el teléfono Android o iOS como la plataforma de destino.

El flujo de una transferencia a superficie funcionará de la siguiente manera:

1. Verifica si el usuario tiene una plataforma disponible

   En el controlador de webhooks, puedes consultar si el usuario tiene una plataforma disponible con una capacidad específica. Ten en cuenta que esta plataforma debe estar vinculada a la misma Cuenta de Google que la plataforma de origen.

   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

   Ten en cuenta que el JSON a continuación describe una solicitud de webhook.

   {
     "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

   Ten en cuenta que el JSON a continuación describe una solicitud de webhook.

   {
     "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. Solicitar que el usuario se transfiera a la nueva plataforma

   Si hay una plataforma disponible con las capacidades necesarias, tu acción deberá preguntarle al usuario si quiere transferir la conversación.

   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

   Ten en cuenta que el JSON a continuación describe una respuesta de webhook.

   {
     "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

   Ten en cuenta que el JSON a continuación describe una respuesta de webhook.

   {
     "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!"
             }
           }
         ]
       }
     ]
   }

   Nota: Tu sesión actual y todos los datos asociados se conservan en la plataforma nueva. Esto significa que cualquier estado de tu plataforma anterior, incluido el conversationToken (si usas la API de webhook HTTP/JSON de conversación) y cualquier contexto de salida de Dialogflow, estará disponible en la plataforma nueva y el ID de la conversación seguirá siendo el mismo. Si usas la biblioteca cliente de Node.js, puedes usar la propiedad conv.data para almacenar datos.
   Advertencia: Si solicitas funciones que no existen en ninguna de las plataformas disponibles del usuario, verás un error en el entorno de ejecución.
3. Cómo manejar la respuesta del usuario

   Según la respuesta del usuario a tu solicitud, tu acción facilitará el traspaso o el control de la conversación a la superficie original. De cualquier manera, la siguiente solicitud al extremo contendrá el intent actions.intent.NEW_SURFACE, por lo que debes compilar un intent que se active en ese evento con el controlador correspondiente en el webhook. En el código de controlador, debes verificar si la transferencia se realizó de forma correcta o no.

   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

   Ten en cuenta que el JSON a continuación describe una solicitud de webhook.

   {
     "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

   Ten en cuenta que el JSON a continuación describe una solicitud de webhook.

   {
     "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"
           }
         ]
       }
     ]
   }