Muitas das plataformas de integração suportam mensagens de respostas avançadas específicas da plataforma. Estas mensagens podem ser usadas para fornecer ao utilizador final mais do que apenas respostas de texto. Existem vários tipos de respostas à sua escolha. Por exemplo, pode mostrar imagens, reproduzir áudio ou disponibilizar botões. Cada plataforma suporta um subconjunto dos tipos de respostas disponíveis.
Onde encontrar estes dados
Ao criar um agente, é mais comum usar a consola do Dialogflow ES (visite a documentação, abra a consola). As instruções abaixo focam-se na utilização da consola. Para aceder aos dados de resposta de intenção:
- Aceda à consola do Dialogflow ES.
- Selecione um agente.
- Selecione Intenções no menu da barra lateral esquerda.
- Selecione uma intenção.
- Desloque a página para baixo até à secção Respostas.
Se estiver a criar um agente através da API em vez da consola, consulte a referência de intenções. Os nomes dos campos da API são semelhantes aos nomes dos campos da consola. As instruções abaixo realçam as diferenças importantes entre a consola e a API.
Adicione mensagens de respostas avançadas
A secção Respostas tem separadores para cada plataforma, incluindo uma plataforma predefinida. Pode definir respostas para a plataforma predefinida, que podem ser usadas em todas as plataformas.
Pode definir respostas para separadores específicos da plataforma, que só funcionam nas plataformas correspondentes. Também pode optar por usar as respostas predefinidas para uma plataforma específica, para não ter de criar respostas de texto duplicadas para todas as plataformas.
Para adicionar mensagens de respostas avançadas:
- Selecione o separador da plataforma pretendida. Se o separador da plataforma pretendida não for apresentado, clique no botão de adição add e selecione-o.
- Clique no botão Adicionar respostas. Um menu pendente mostra os tipos de respostas suportados pela plataforma.
- Escolha o tipo de resposta. Estas são descritas abaixo.
- Introduza campos para o tipo de resposta selecionado.
- Adicione mais separadores de plataformas e respostas conforme necessário. Pode adicionar até 10 mensagens ordenadas em cada separador.
- Clique em Guardar.
Pode usar referências de parâmetros nas suas respostas para fazer referência a parâmetros fornecidos pelo utilizador final ou eventos em tempo de execução.
Respostas de texto
Por predefinição, as respostas de Texto enviam uma resposta de texto ao utilizador final.
Se a conversão de texto em voz estiver ativada para um agente ou pedida por solicitações de intenção de deteção, o texto fornecido é usado para sintetizar a voz e reproduzir o áudio. Neste caso, o texto fornecido pode usar opcionalmente a Linguagem de marcação de síntese de voz (SSML).
Os campos são:
- Lista de entradas de texto ou SSML
Quando introduzir uma resposta, prima Shift + Enter para introduzir uma nova linha ou apenas Enter para introduzir outra resposta de texto.
Aplicam-se as seguintes limitações:
- Máximo de 300 entradas de texto por resposta de texto
Respostas com imagens
As respostas de imagem enviam uma imagem ao utilizador final. Contêm os seguintes campos:
- URL acessível publicamente para a imagem
Respostas de cartões
As respostas do cartão enviam uma imagem, um título do cartão, um subtítulo do cartão e botões interativos ao utilizador final. O estilo do cartão varia consoante a plataforma.
Pode configurar botões para enviar o utilizador final para um URL ou para enviar texto pré-configurado para o Dialogflow, como se o utilizador final tivesse fornecido uma expressão.
Alguns dos campos são opcionais, consoante a plataforma:
- URL acessível publicamente de uma imagem
- Título do cartão
- Subtítulo do cartão
- Lista de botões com os seguintes campos:
- Título do botão
- Texto a enviar como expressão do utilizador final ou URL a abrir
Aplicam-se as seguintes limitações:
Máximo de 10 cartões por plataforma e por idioma para uma intenção. Por exemplo, se o seu agente suportar inglês, francês, a plataforma X e a plataforma Y, uma intenção pode ter, no máximo, 40 cartões:
- 10 cartões em inglês para a plataforma X
- 10 cartões em inglês para a plataforma Y
- 10 cartões franceses para a plataforma X
- 10 cartões franceses para a plataforma Y
Respostas rápidas
As respostas de Resposta rápida enviam um botão ao utilizador final. Pode configurar botões para enviar texto pré-configurado para o Dialogflow como se o utilizador final tivesse fornecido uma expressão.
Os campos são:
- Título do botão
- Lista de entradas de texto a enviar como expressão do utilizador final
Aplicam-se as seguintes limitações:
Máximo de uma resposta rápida por plataforma e por idioma para uma intenção. Por exemplo, se o seu agente for compatível com inglês, francês, a plataforma X e a plataforma Y, um objetivo pode ter, no máximo, 4 respostas rápidas:
- 1 resposta rápida em inglês para a plataforma X
- 1 resposta rápida em inglês para a plataforma Y
- 1 resposta rápida em francês para a plataforma X
- 1 resposta rápida em francês para a plataforma Y
Máximo de 10 entradas de texto por resposta rápida.
Máximo de 20 carateres por entrada de texto.
Sintetize respostas de voz
As respostas Synthesize Speech são usadas para sintetizar a fala a partir de respostas de texto e reproduzir o áudio. O texto fornecido pode usar opcionalmente a Speech Synthesis Markup Language (SSML).
Os campos são:
- Texto ou SSML
Aplicam-se as seguintes limitações:
- Apenas suportado pela integração do gateway telefónico do Dialogflow
- Máximo de 20 respostas de síntese de voz por intenção
Ouvir respostas de áudio
As respostas Play Audio são usadas para reproduzir ficheiros de áudio. Os ficheiros de áudio são fornecidos num contentor do Cloud Storage.
Os campos são:
- URI do objeto do Cloud Storage no formato
gs://bucket-name/object-name.
Aplicam-se as seguintes limitações:
- Apenas suportado pela integração do gateway telefónico do Dialogflow
- Especificações do ficheiro de áudio: um único canal (mono) de áudio PCM linear (2 bytes / amostra) a 8 kHz
- Máximo de 20 respostas de reprodução de áudio por intenção
Respostas de chamadas transferidas
As respostas Transferir chamada são usadas para transferir o autor da chamada para uma integração de telefonia.
Os campos são:
- O número de telefone para o qual a chamada vai ser transferida.
Aplicam-se as seguintes limitações:
Apenas suportado pela integração do gateway telefónico do Dialogflow
Apenas são suportados números de telefone dos EUA
Respostas de payload personalizadas
Algumas plataformas suportam uma resposta de payload personalizada para processar respostas avançadas não padrão. Estes payloads personalizados são fornecidos num formato JSON definido na documentação da plataforma.
Também pode enviar um payload personalizado para integrações que desenvolve. Não é processado pelo Dialogflow, pelo que tem de o processar na sua própria lógica empresarial.
Pode configurar um payload personalizado para várias plataformas. Para configurar esta opção, use a plataforma predefinida e um formato JSON semelhante ao seguinte:
{
"facebook": {
"attachment": {
"type": "",
"payload": {}
}
},
"slack": {
"text": "",
"attachments": []
}
}
Tipos de respostas do Assistente Google
A integração do Assistente Google oferece muitos tipos de mensagens de resposta. Para mais informações, consulte a referência de respostas do Assistente Google.
Tipos de respostas adicionais
Outros tipos de mensagens são suportados por várias plataformas. Pode ver a lista completa na referência REST da mensagem de resposta. Consulte a documentação de integração da plataforma para mais informações.