Saídas de conversa (Dialogflow)

Explorar no Dialogflow

Clique em Continuar para importar a amostra de saídas de conversa para o Dialogflow. Depois, siga as etapas abaixo para implantar e testar a amostra:

  1. Digite um nome de agente e crie um novo agente do Dialogflow para a amostra.
  2. Depois que a importação do agente terminar, clique em Go to agent.
  3. No menu de navegação principal, acesse Fulfillment.
  4. Ative o Editor in-line e clique em Implantar. O editor contém a amostra o código-fonte é alterado.
  5. No menu de navegação principal, acesse Integrações e clique em Google Google Assistente.
  6. Na janela modal exibida, ative a opção Mudanças na visualização automática e clique em Testar. para abrir o simulador do Actions.
  7. No simulador, insira Talk to my test app para testar a amostra.
Continuar

Sempre que os usuários quiserem sair no meio da conversa, eles podem dizer coisas como:

  • "exit"
  • "cancelar"
  • "parar"
  • "deixa para lá"
  • "tchau"

Por padrão, o Google Assistente sai da conversa e toca um ícone auditivo. Para substituir esse comportamento, você pode ativar o recebimento da última solicitação que pode usar para limpar a lógica de fulfillment e responder ao usuário uma última vez. A resposta final precisa ser uma resposta simples única. com um limite de 60 caracteres nos valores textToSpeech e displayText.

O tempo máximo de execução permitido para solicitações de saída de conversa é de dois segundos. caso contrário for recebida, a conversa será encerrada com o ícone auditivo de saída padrão. Se sua resposta de cancelamento personalizada falhar (por exceder o limite de caracteres, tipo de resposta incorreto etc.), a conversa também será encerrada com o ícone auditivo de saída padrão.

Dialogflow

Para receber eventos de saída de conversa:

  1. No painel de navegação à esquerda, clique no ícone + ao lado do item de menu Intents.
  2. Dê um nome à intent (como Exit Conversation) e clique na seção Events.
  3. Insira actions_intent_CANCEL no campo Adicionar evento.
  4. Especifique uma resposta em Resposta ou configure sua própria resposta para essa intent no código do webhook.
  5. Ative a opção Set this intent as end of conversation.
  6. Clique em Salvar.
  7. No painel de navegação à esquerda, clique em Integrações.
  8. Escolha Google Assistente, clique em Atualizar rascunho e depois em Testar para fazer garantir que as alterações sejam refletidas no projeto.

Quando um usuário solicita a saída de uma conversa, a intent que você criou é acionada e sua é retornada ao usuário. Para exemplo, veja um código de fulfillment que usa a biblioteca de cliente para lidar com uma a intent de cancelar e retornar uma resposta.

Node.jsJavaJSON de solicitaçãoResposta JSON
const {dialogflow} = require('actions-on-google');
const functions = require('firebase-functions');

const app = dialogflow({debug: true});

app.intent('Exit Conversation', (conv) => {
  conv.close(`Okay, talk to you next time!`);
});

exports.dialogflowFirebaseFulfillment = functions.https.onRequest(app);
index.js
 
package com.example;

import com.google.actions.api.ActionRequest;
import com.google.actions.api.ActionResponse;
import com.google.actions.api.DialogflowApp;
import com.google.actions.api.ForIntent;
import com.google.actions.api.response.ResponseBuilder;

public class MyActionsApp extends DialogflowApp {

  @ForIntent("Exit Conversation")
  public ActionResponse exit(ActionRequest request) {
    ResponseBuilder responseBuilder = getResponseBuilder(request);
    responseBuilder.add("Okay, talk to you next time!");
    responseBuilder.endConversation();
    return responseBuilder.build();
  }
}
MyActionsApp.java

O JSON abaixo descreve uma solicitação de webhook.

{
  "responseId": "e0c9d47f-aa99-4d03-bd48-a64c79e9c2a2-712767ed",
  "queryResult": {
    "queryText": "actions_intent_CANCEL",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentText": "Webhook failed for intent: Exit Conversation",
    "fulfillmentMessages": [
      {
        "text": {
          "text": [
            "Webhook failed for intent: Exit Conversation"
          ]
        }
      }
    ],
    "outputContexts": [
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_audio_output"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_media_response_audio"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_account_linking"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_screen_output"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_capability_web_browser"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/google_assistant_input_type_keyboard"
      },
      {
        "name": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0/contexts/actions_intent_cancel"
      }
    ],
    "intent": {
      "name": "projects/df-exits-kohler/agent/intents/b506991f-ad7a-4c4b-8adc-5e6c62727381",
      "displayName": "Exit Conversation"
    },
    "intentDetectionConfidence": 1,
    "languageCode": "en"
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "user": {
        "locale": "en-US",
        "userVerificationStatus": "VERIFIED"
      },
      "conversation": {
        "conversationId": "ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0",
        "type": "ACTIVE",
        "conversationToken": "[]"
      },
      "inputs": [
        {
          "intent": "actions.intent.CANCEL",
          "rawInputs": [
            {
              "inputType": "KEYBOARD",
              "query": "cancel"
            }
          ]
        }
      ],
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.ACCOUNT_LINKING"
          },
          {
            "name": "actions.capability.SCREEN_OUTPUT"
          },
          {
            "name": "actions.capability.WEB_BROWSER"
          }
        ]
      },
      "availableSurfaces": [
        {
          "capabilities": [
            {
              "name": "actions.capability.SCREEN_OUTPUT"
            },
            {
              "name": "actions.capability.WEB_BROWSER"
            },
            {
              "name": "actions.capability.AUDIO_OUTPUT"
            }
          ]
        }
      ]
    }
  },
  "session": "projects/df-exits-kohler/agent/sessions/ABwppHGVnlRtMz1RhGGmDOSlCFAbc2QaM12xYtw0raWvv-R5GYM6tkqiVOpIOexm_LTBCvmARwpbZ_onRuX0"
}

O JSON abaixo descreve uma resposta do webhook.

{
  "payload": {
    "google": {
      "expectUserResponse": false,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "Okay, talk to you next time!"
            }
          }
        ]
      }
    }
  }
}

SDK do Actions

Para receber intents de saída de conversa:

  1. Em um objeto conversations dentro do pacote de ações, declare você quer receber a intent actions.intent.CANCEL sempre que um usuário quiser sair no meio de uma conversa.


    {
          "actions": [
            {
              "description": "Default Welcome Intent",
              "name": "MAIN",
              "fulfillment": {
                "conversationName": "conversation_1"
              },
              "intent": {
                "name": "actions.intent.MAIN"
              }
            }
          ],
          "conversations": {
            "conversation_1": {
              "name": "conversation_1",
              "url": "YOUR_ENDPOINT_URL",
          "inDialogIntents": [
            {
              "name": "actions.intent.CANCEL"
            }
          ]
            }
          }
    }
    action.json

  2. Quando você recebe uma solicitação com o actions.intent.CANCEL , limpe qualquer lógica de fulfillment que quiser e retorne uma frase de saída apropriada para o usuário. Por exemplo, este é um código de fulfillment que usa a biblioteca de cliente para processar uma intent de cancelamento.

    Node.jsJavaJSON de solicitaçãoResposta JSON
    const {actionssdk} = require('actions-on-google');
    const functions = require('firebase-functions');

    const app = actionssdk({debug: true});

    app    .intent('actions.intent.MAIN', (conv) => {
      conv    .ask(`Hi! Try saying 'exit' or 'cancel'`);
    });

    app    .intent('actions.intent.TEXT', (conv, input) => {
      conv    .ask(`You said ${input}`);
      conv    .ask(`Try saying 'exit' or 'cancel'`);
    });

    app    .intent('actions.intent.CANCEL', (conv) => {
      conv    .close(`Okay, talk to you next time!`);
    });

    exports    .dialogflowFirebaseFulfillment = functions.https.onRequest(app);
    index.js
     
    package com.example;

    import com.google.actions.api.ActionRequest;
    import com.google.actions.api.ActionResponse;
    import com.google.actions.api.ActionsSdkApp;
    import com.google.actions.api.ConstantsKt;
    import com.google.actions.api.ForIntent;
    import com.google.actions.api.response.ResponseBuilder;
    import com.google.actions.api.response.helperintent.Confirmation;
    import com.google.actions.api.response.helperintent.DateTimePrompt;
    import com.google.actions.api.response.helperintent.Permission;
    import com.google.actions.api.response.helperintent.Place;
    import com.google.api.services.actions_fulfillment.v2.model.DateTime;
    import com.google.api.services.actions_fulfillment.v2.model.Location;

    public class MyActionsApp extends ActionsSdkApp {

          @ForIntent("actions.intent.MAIN")
          public ActionResponse welcome(ActionRequest request) {
            ResponseBuilder responseBuilder = getResponseBuilder(request);
        responseBuilder    .add("Hi! Try saying 'exit' or 'cancel'");
            return responseBuilder.build();
          }

          @ForIntent("actions.intent.TEXT")
          public ActionResponse fallback(ActionRequest request) {
            ResponseBuilder responseBuilder = getResponseBuilder(request);
        responseBuilder    .add("You said " + request.getRawInput().getQuery());
        responseBuilder    .add("Try saying 'exit' or 'cancel'");
            return responseBuilder.build();
          }

          @ForIntent("actions.intent.CANCEL")
          public ActionResponse exit(ActionRequest request) {
            ResponseBuilder responseBuilder = getResponseBuilder(request);
        responseBuilder    .add("Okay, talk to you next time!");
        responseBuilder    .endConversation();
            return responseBuilder.build();
          }

    }
    MyActionsApp.java

    O JSON abaixo descreve uma solicitação de webhook.

    {
          "user": {
            "locale": "en-US",
            "userVerificationStatus": "VERIFIED"
          },
          "conversation": {
            "conversationId": "ABwppHEtH6XptryyLGWDBOVnLgy8EkOclTPETd4lcLh_f6ghQAzzg0seUuq3YocyFT8B17N6AGD6YPPjQw5CXBM",
            "type": "NEW"
          },
          "inputs": [
            {
              "intent": "actions.intent.CANCEL",
              "rawInputs": [
                {
                  "inputType": "KEYBOARD",
                  "query": "exit"
                }
              ]
            }
          ],
          "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.AUDIO_OUTPUT"
                },
                {
                  "name": "actions.capability.SCREEN_OUTPUT"
                },
                {
                  "name": "actions.capability.WEB_BROWSER"
                }
              ]
            }
          ]
    }

    O JSON abaixo descreve uma resposta do webhook.

    {
          "expectUserResponse": false,
          "finalResponse": {
            "richResponse": {
              "items": [
                {
                  "simpleResponse": {
                    "textToSpeech": "Okay, talk to you next time!"
                  }
                }
              ]
            }
          }
    }