Responses

As intenções têm um controlador de respostas incorporado que pode devolver respostas após a correspondência da intenção. Esta funcionalidade só suporta respostas estáticas, embora possa usar referências de parâmetros nestas respostas para as tornar um pouco dinâmicas. Isto é útil para resumir as informações fornecidas pelo utilizador final. Por exemplo, a resposta de intenção pode ter o seguinte aspeto: "OK. Reservei um quarto para si a $date".

Em alguns casos, isto é tudo o que precisa. Nos casos em que o seu código precisa de tomar alguma medida ou criar uma resposta mais dinâmica, deve usar uma das opções de resposta dinâmica abaixo. Normalmente, os agentes usam uma combinação de respostas estáticas e dinâmicas.

Podem ser fornecidos vários tipos de respostas. O tipo de resposta básico é uma resposta de texto. Estão disponíveis outros tipos de respostas (imagem, áudio, voz sintetizada, etc.), alguns dos quais são específicos da plataforma.

Se definir mais do que uma variação de resposta para uma intenção, o seu agente seleciona uma resposta aleatoriamente. Deve adicionar várias variações de respostas para tornar o seu agente mais conversacional.

Quando cria um agente, deve fornecer dados de resposta para cada intenção. Quando usa a API ou o processamento de pedidos para interagir com o Dialogflow, tecnicamente, pode não precisar de fornecer dados de resposta, porque ambos os métodos podem gerar dinamicamente qualquer resposta. No entanto, se quiser usar o simulador para testes ou definir intenções com uma resposta simples, deve fornecer dados de resposta.

Como regra geral, as respostas de intenção devem pedir ao utilizador final que forneça uma expressão que corresponda a outra intenção. As suas respostas também devem orientar o utilizador final para fornecer dados específicos. Por exemplo, uma pergunta como "Em que cidade nasceu?" é melhor do que uma pergunta mais aberta como "Onde nasceu?".

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:

1. Aceda à consola do Dialogflow ES.
2. Selecione um agente.
3. Selecione Intenções no menu da barra lateral esquerda.
4. Selecione uma intenção.
5. 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.

Plataformas de respostas

Cada resposta é definida para a plataforma Predefinição (denominada PLATFORM_UNSPECIFIED na API) ou uma plataforma de integração específica. Se não estiver a usar uma integração, todas as suas respostas podem usar a plataforma predefinida. Se estiver a usar integrações, cada integração pode ter uma resposta única ou pode ser configurada para usar a resposta predefinida.

Para mais informações sobre respostas específicas da plataforma, consulte o artigo Mensagens de resposta avançadas.

Crie respostas incorporadas

Para criar respostas incorporadas:

1. Selecione Predefinição ou uma plataforma específica.
2. Se o tipo de resposta pretendido (por exemplo, Resposta de texto) ainda não estiver na lista, clique em Adicionar respostas e selecione o tipo de resposta.
3. Introduza as informações necessárias para a resposta.
4. Clique em Guardar.

Respostas dinâmicas com processamento

Com o processamento de pedidos, pode criar respostas dinâmicas. Consulte os documentos de processamento para mais informações.

Respostas dinâmicas com a API

Através da API, pode criar respostas dinâmicas. Consulte a vista geral da API para mais informações.

Carateres especiais

Alguns carateres especiais requerem a interpretação literal na sua resposta.

Para usar o símbolo de dólar $ ou o símbolo de número # numa resposta, adicione chavetas {} em torno do conteúdo que segue imediatamente o símbolo. Por exemplo:

• ${100} é resolvido para $100
• ${$number} é resolvido como $100, onde $number é uma referência de parâmetro com um valor de 100
• #{hello} é resolvido para #hello

Para usar chavetas {} numa resposta, use chavetas duplas. Por exemplo:

• {{hello}} é resolvido para {hello}

Processamento de valores de parâmetros vazios

Se a sua intenção tiver um parâmetro que possa ser resolvido para um valor vazio, tem de fornecer, pelo menos, uma variante de resposta que não use esse parâmetro.

Por exemplo, se a sua intenção tiver 2 parâmetros (p1 e p2) e um ou ambos puderem estar vazios, deve fornecer, pelo menos, quatro variantes de resposta:

• OK. Disse $p1 e $p2.
• OK. Disse $p1.
• OK. Disse $p2.
• OK.