Início rápido: processamento de encomendas

Este guia mostra como integrar o seu agente com os seus serviços através do cumprimento. A integração do seu serviço permite-lhe tomar medidas com base nas expressões do utilizador final e enviar respostas dinâmicas ao utilizador final.

Nota: se estiver a usar o Assistente Google, verifique as opções na página do Assistente Google.

Antes de começar

Se não planeia usar o processamento de pedidos, pode ignorar este início rápido.

Estes passos usam as Cloud Functions e pressupõem conhecimentos básicos de Node.js. Se quiser criar o processamento de pedidos através do seu próprio servidor ou de outro idioma, consulte a documentação de processamento de pedidos mais detalhada.

Antes de ler este guia, deve fazer o seguinte:

1. Leia as noções básicas do Dialogflow.
2. Realize os passos de configuração.
3. Execute os passos no guia de início rápido Crie um agente. Os passos abaixo continuam a funcionar no mesmo agente. Se já não tiver esse agente, pode transferir build-agent-quickstart.zip e importar o ficheiro.

O editor inline

A consola do Dialogflow tem um editor de código integrado, denominado editor inline que pode usar para criar código de processamento e implementar o código nas Cloud Functions. O Cloud Functions tem custos associados, mas o serviço está disponível sem custos financeiros até um número significativo de invocações mensais. Tenha em atenção que ainda tem de se registar e indicar uma conta de faturação válida. Cancele em qualquer altura.

Quando ativa inicialmente o editor inline, o código de processamento Node.js é pré-preenchido com processadores predefinidos para intencionalidades predefinidas incluídas para todos os agentes. O código também tem instruções comentadas para adicionar controladores para intenções definidas pelo programador.

O editor inline destina-se a testes e prototipagem de processamento simples. Quando tiver tudo pronto para criar uma aplicação de produção, deve criar um serviço de webhook.

Ative e implemente o processamento com o editor inline

Para ativar e implementar o código de processamento predefinido através do editor inline:

1. Clique em Cumprimento no menu da barra lateral do lado esquerdo.
2. Ative o Editor inline.
3. Se não ativou a faturação nos passos de configuração, é-lhe pedido que a ative agora. O Cloud Functions tem custos associados, mas o serviço está disponível sem custos financeiros até um número significativo de invocações mensais. Tenha em atenção que continua a ter de se registar e fornecer uma conta de faturação. Cancele em qualquer altura.
4. Clique em Implementar na parte inferior do formulário e aguarde até que as caixas de diálogo indiquem que foi implementado.

Para cada intenção que requer o processamento, tem de ativar o processamento para a intenção. Para ativar o preenchimento da intenção de boas-vindas predefinida:

1. Clique em Intenções no menu da barra lateral esquerda.
2. Clique em Intenção de boas-vindas predefinida.

3. Desloque a página para baixo até à secção Fulfillment e ative a opção Ativar chamada de webhook para este objetivo.

   Nota: a ativação do preenchimento substitui as respostas definidas na secção Respostas da intenção. Se a satisfação falhar, são usadas as entradas na secção Respostas.

4. Clique no botão Guardar e aguarde até que a caixa de diálogo Formação de agentes indique que a formação está concluída.

Agora, pode testar o seu processamento no simulador. Introduza Hi no simulador e este responde com Welcome to my agent!. Esta resposta é enviada a partir do webhook de processamento que acabou de implementar. Em particular, a resposta veio deste código:

function welcome(agent) {
  agent.add(`Welcome to my agent!`);
}

Crie um controlador de processamento personalizado

Os passos acima usam um controlador fornecido pelo código do editor inline predefinido. Para criar um controlador personalizado:

1. Ative o preenchimento para a intenção get-agent-name que criou nos passos anteriores.
2. Clique em Preenchimento no menu da barra lateral esquerda e examine o código no editor inline.

3. Encontre esta linha:

   exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => {
   

   A função onRequest processa todos os pedidos do Dialogflow. No corpo desta função, são definidas funções de controlador específicas. Estas funções de controlador são invocadas quando são encontradas correspondências com intenções associadas. Por exemplo, a função usada na secção anterior é function welcome(agent).

4. Abaixo dos controladores existentes, adicione esta função para a intenção get-agent-name:

   function getAgentNameHandler(agent) {
     agent.add('From fulfillment: My name is Dialogflow!');
   }
   

5. Abaixo das definições da função do controlador, existem chamadas intentMap.set(). Estas chamadas associam processadores específicos a intenções por nome. Por exemplo, intentMap.set('Default Welcome Intent', welcome) associa o controlador welcome à intenção denominada Default Welcome Intent.

6. Abaixo das chamadas intentMap.set existentes, adicione esta linha para o objetivo get-agent-name:

   intentMap.set('get-agent-name', getAgentNameHandler);
   

7. Clique em Implementar na parte inferior do formulário.

8. Introduza What's your name? no simulador. A resposta From fulfillment: My name is Dialogflow! é enviada a partir do novo controlador.

Aceda aos valores dos parâmetros

Nos passos anteriores, criou uma intenção set-language para identificar idiomas humanos e de programação. A intenção usa os parâmetros language e language-programming. Nesta secção, acede aos valores destes parâmetros no seu controlador de processamento.

Para adicionar o controlador:

1. Ative o processamento para a intenção set-language.
2. Clique em Cumprimento no menu da barra lateral do lado esquerdo.

3. Semelhante aos passos acima, adicione o seguinte controlador e chamada intentMap:

   function languageHandler(agent) {
       const language = agent.parameters.language;
       const programmingLanguage = agent.parameters['language-programming'];
       if (language) {
           agent.add(`From fulfillment: Wow! I didn't know you knew ${language}`);
       } else if (programmingLanguage) {
           agent.add(`From fulfillment: ${programmingLanguage} is cool`);
       } else {
           agent.add(`From fulfillment: What language do you know?`);
       }
   }
   

   intentMap.set('set-language', languageHandler);
   

4. Clique em Implementar.

Este controlador obtém os parâmetros language e language-programming e armazena-os em variáveis. Obtém estes valores do atributo agent.parameters, que é um objeto que contém todos os nomes e valores dos parâmetros que os utilizadores finais especificam nos respetivos pedidos.

Para o experimentar, introduza I know how to speak German no simulador.