Funzionalità di Surface (Dialogflow)

Prova gli snippet: importa, esegui il deployment ed esplora gli snippet di codice nel contesto utilizzando un nuovo agente Dialogflow.

Esplora in Dialogflow

Esplora in Dialogflow

Fai clic su Continua per importare l'esempio delle funzionalità di Surface in Dialogflow. Quindi, segui questi passaggi per eseguire il deployment e testare l'esempio:

1. Inserisci un nome dell'agente e crea un nuovo agente Dialogflow per l'esempio.
2. Al termine dell'importazione, fai clic su Vai all'agente.
3. Nel menu di navigazione principale, vai a Fulfillment.
4. Attiva l'editor in linea, quindi fai clic su Esegui il deployment. L'editor contiene il codice campione.
5. Nel menu di navigazione principale, vai a Integrazioni e fai clic su Google Assistant.
6. Nella finestra modale che viene visualizzata, abilita Modifiche dell'anteprima automatica e fai clic su Test per aprire il simulatore di Actions.
7. Nel simulatore, inserisci Talk to my test app per testare l'esempio.

Continua Annulla

Le azioni possono essere visualizzate su diverse piattaforme, tra cui solo piattaforme audio (smart speaker) e audio e display (ad esempio smart display e dispositivi mobili).

Per progettare e creare conversazioni che funzionino bene su tutte le piattaforme, utilizza le funzionalità di Surface per controllare e limitare l'ambito delle conversazioni.

Eseguire la visualizzazione delle funzionalità per le azioni

Le azioni su Google ti consentono di controllare se gli utenti possono richiamare o meno l'azione in base alla piattaforma utilizzata. Se gli utenti tentano di richiamare l'azione su una piattaforma non supportata, ricevono un messaggio di errore che li informa che il loro dispositivo non è supportato.

Sei tu a definire il supporto della tua azione nel progetto Actions.

Nota: dovresti controllare l'opzione della funzionalità di riproduzione dei contenuti multimediali solo se l'intera azione dipende dalla riproduzione dei contenuti multimediali. Ad esempio, se l'azione non esegue alcuna azione tranne la riproduzione di una traccia audio che genera una risposta multimediale, seleziona questa opzione. Se l'Azione fornisce anche altre informazioni, come i dati del mercato azionario, non selezionare questa opzione. Nel secondo caso, controllerai in modo programmatico la funzionalità di visualizzazione della riproduzione di contenuti multimediali e risponderai di conseguenza.

L'azione può apparire su una serie di piattaforme supportate dall'assistente, ad esempio smartphone (Android e iOS) e dispositivi Google Home.

Funzionalità della piattaforma di runtime

Puoi offrire all'utente un'esperienza con le funzionalità di superficie di runtime in due modi principali:

• Ramo di risposta: mostra agli utenti risposte diverse, ma con la stessa struttura e lo stesso flusso per la conversazione su diverse piattaforme. Ad esempio, un'azione meteo potrebbe mostrare una scheda con un'immagine su un telefono e riprodurre un file audio su Google Home, ma il flusso di conversazione è lo stesso sulle piattaforme.

• Raggio di conversazione. Presenta agli utenti conversazioni completamente diverse su ogni piattaforma. Ad esempio, se stai creando un'app per l'ordinazione di cibo, potresti voler fornire un flusso di riordinamento su Google Home, ma un flusso di assemblaggio completo del carrello sui telefoni cellulari. Per eseguire la diramazione della conversazione, l'ambito dell'intenzione di attivazione in Dialogflow per determinate funzionalità di superficie con i contesti Dialogflow. Gli intent Dialogflow effettivi non vengono attivati, a meno che non venga soddisfatta una funzionalità specifica della superficie.

  Nota: le funzionalità di superficie del dispositivo di un utente potrebbero cambiare nel corso della conversazione. Non dipendere da un insieme costante di funzionalità dopo l'avvio di una conversazione.

• Conversazioni multi-superficie: presenta agli utenti una conversazione su una superficie che passa a un'altra piattaforma a metà conversazione. Ad esempio, se un utente richiama l'azione con immagini su una superficie solo audio come Google Home, puoi creare l'azione per cercare un'altra piattaforma con funzionalità visive e spostare la conversazione lì, se possibile.

Diramazione della risposta

Ogni volta che il tuo fulfillment riceve una richiesta dall'Assistente Google, puoi eseguire query sulle seguenti piattaforme (ad esempio, Google Home o un telefono 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

Tieni presente che il codice JSON che segue descrive una richiesta di 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

Tieni presente che il codice JSON che segue descrive una richiesta di 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"
        }
      ]
    }
  ]
}

Ramificazione conversazione

Puoi configurare gli intent Dialogflow in modo che si attivino solo su determinate funzionalità con contesti predefiniti. Ogni volta che un intent viene abbinato, Dialogflow genera automaticamente i contesti dal set di funzionalità di superficie disponibili sul dispositivo. Puoi specificare uno o più di questi contesti come "contesti di input" per i tuoi intent. Questo ti permette di limitare l'attivazione degli intent in base alla modalità.

Ad esempio, se vuoi che un intent venga attivato solo su dispositivi con output dello schermo, puoi impostare un contesto di input sull'intent su actions_capability_screen_output.

Sono disponibili i seguenti contesti:

• actions_capability_audio_output: il dispositivo ha un altoparlante.
• actions_capability_screen_output: il dispositivo ha uno schermo di output.
• actions_capability_media_response_audio: il dispositivo supporta la riproduzione di contenuti multimediali.
• actions_capability_web_browser: il dispositivo supporta un browser web. Al momento questa funzionalità non è disponibile per gli smart display.

Ecco un esempio di intenzione che si attiva solo su piattaforme con schermate:

Conversazioni multi-superficie

In qualsiasi momento durante il flusso dell'azione, puoi controllare se l'utente ha altre piattaforme con una funzionalità specifica. Se è disponibile un'altra piattaforma con la capacità richiesta, puoi trasferire la conversazione corrente su questa nuova piattaforma.

Nota: una conversazione può essere trasferita solo in base alla funzionalità di visualizzazione dello schermo con un telefono Android/iOS come piattaforma di destinazione.

Il flusso per un trasferimento di superficie funzionerà come segue:

1. Verifica se l'utente ha una piattaforma disponibile

   Nel gestore webhook, puoi eseguire una query per specificare se l'utente ha una piattaforma disponibile con una funzionalità specifica. Tieni presente che questa piattaforma deve essere collegata allo stesso Account Google della piattaforma di origine.

   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

   Tieni presente che il codice JSON che segue descrive una richiesta di 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

   Tieni presente che il codice JSON che segue descrive una richiesta di 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. Richiedi di trasferire l'utente sulla nuova piattaforma

   Se è disponibile una piattaforma con le funzionalità necessarie, l'azione dovrà chiedere all'utente se vuole trasferire la conversazione.

   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

   Tieni presente che il codice JSON seguente descrive una risposta 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

   Tieni presente che il codice JSON seguente descrive una risposta 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: La sessione attuale e tutti i dati associati vengono mantenuti sulla nuova piattaforma. Ciò significa che qualsiasi stato della piattaforma precedente, tra cui conversationToken (se utilizzi l'API HTTP/JSON di conversazione) e qualsiasi contesto di output di Dialogflow, saranno disponibili sulla nuova piattaforma e l'ID conversazione rimarrà invariato. Se utilizzi la libreria client di Node.js, puoi utilizzare la proprietà conv.data per archiviare i dati.
   Avviso: se richiedi funzionalità che non esistono su nessuna delle piattaforme disponibili, verrà visualizzato un errore in fase di runtime.
3. Gestisci la risposta dell'utente

   In base alla risposta dell'utente alla tua richiesta, l'azione faciliterà il passaggio o il controllo della conversazione alla piattaforma originale. In ogni caso, la richiesta successiva al tuo endpoint conterrà l'intent actions.intent.NEW_SURFACE, quindi devi creare un intent che si attivi su quell'evento con un gestore corrispondente nel tuo webhook. Nel codice gestore devi controllare se il trasferimento è andato a buon fine.

   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

   Tieni presente che il codice JSON che segue descrive una richiesta di 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

   Tieni presente che il codice JSON che segue descrive una richiesta di 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"
           }
         ]
       }
     ]
   }