Visão geral de intents (Dialogflow)

As intents são objetos de mensagem que descrevem como fazer algo. É possível usar intents de duas maneiras:

  • Fornecendo o fulfillment para uma intent ou
  • Solicitando o fulfillment de uma intent pelo Google Assistente.

O processo pelo qual você fornece o fulfillment para uma intent é diferente para desenvolvedores que criam com o Dialogflow e para desenvolvedores com o SDK do Actions. Nos dois casos, você fornece o nome da intent e o URL do webhook de fulfillment. Isso informa ao Actions on Google que você pode oferecer suporte a consultas do usuário que correspondem à intent.

Para solicitar o fulfillment de uma intent, especifique-a no objeto possibleIntents ao responder ao Google Assistente. Na próxima solicitação para o fulfillment, o Google Assistente retorna o resultado da intent processada para você. Para ver mais informações, leia a visão geral de uso de auxiliares.

Intents comuns

A tabela a seguir descreve as intents que o Google Assistente solicita para você atender.

Nome da intent Uso Evento do Dialogflow
actions.intent.MAIN Obrigatório: cada pacote de ações declara uma e apenas uma intent atua como ponto de entrada para os usuários iniciarem conversas. WELCOME ou GOOGLE_ASSISTANT_WELCOME
actions.intent.TEXT Conseguir uma representação em texto bruto de uma solicitação do usuário. Você usa isso na maioria do tempo ao conversar com os usuários.
actions.intent.CANCEL Você receberá esse intent quando ativar o recebimento de intents de cancelamento no seu pacote de ações. Quando os usuários disserem um comando de cancelamento global, como "quit", você receberá essa intent na próxima solicitação para o fulfillment para responder com uma mensagem final e fazer qualquer limpeza na lógica de fulfillment. actions_intent_CANCEL
actions.intent.NO_INPUT Você vai receber essa intent quando ativar o recebimento de intents sem entrada no seu pacote de ações. Quando os usuários não responderem a uma solicitação, você receberá essa intent na próxima solicitação para o fulfillment. actions_intent_NO_INPUT

Auxiliares

A tabela a seguir descreve os auxiliares que podem ser solicitados.

Nome da intent Uso Evento do Dialogflow
actions.intent.PERMISSION Solicitar o nome completo, localização aproximada, localização exata ou todas as três do usuário. actions_intent_PERMISSION
actions.intent.OPTION Receba o item selecionado de uma interface de lista ou carrossel. Ou, se o usuário não selecionar na interface de lista ou de carrossel, receber entrada de fala ou texto que corresponda à chave na interface de lista ou carrossel. actions_intent_OPTION
actions.intent.DATETIME Solicite uma entrada de data e hora do usuário. actions_intent_DATETIME
actions.intent.SIGN_IN Solicita um fluxo de vinculação de conta para associar a conta de um usuário. actions_intent_SIGN_IN
actions.intent.PLACE Conseguir um endereço ou local salvo do usuário. actions_intent_PLACE
actions.intent.CONFIRMATION Consiga uma confirmação do usuário (por exemplo, uma resposta a uma pergunta de sim ou não). actions_intent_CONFIRMATION
actions.intent.NEW_SURFACE Solicita permissão ao usuário para entregue a outra plataforma do Assistente. actions_intent_NEW_SURFACE

Intents incorporadas

As intents integradas modelam algumas das maneiras comuns que os usuários usam para expressar as tarefas que estão tentando realizar ou as informações que procuram, como pedir uma refeição, reservar uma viagem ou consultar o saldo da conta. Consulte a referência de intents integradas para mais informações.

Outras intents

A maioria das ações de conversa é criada com uma combinação de intents, auxiliares e respostas comuns. No entanto, ações que incorporam outros recursos, como transações ou atualizações diárias, têm acesso a intents específicas desses recursos.

Auxiliares de transações

A tabela a seguir descreve assistentes relacionados ao processamento de compras que você pode solicitar que o Google Assistente realize. Encontre mais informações sobre como implementar essas e outras intents relacionadas na documentação do recurso transactions.

Nome da intent Uso Evento do Dialogflow
actions.intent.DELIVERY_ADDRESS Solicite ao usuário uma entrada de endereço de entrega. actions_intent_DELIVERY_ADDRESS
actions.intent.TRANSACTION_REQUIREMENTS_CHECK Verifique se todos os requisitos de uma transação foram atendidos. actions_intent_TRANSACTION_REQUIREMENTS_CHECK
actions.intent.TRANSACTION_DECISION Pergunta ao usuário se a transação deve ocorrer. actions_intent_TRANSACTION_DECISION
actions.intent.DIGITAL_PURCHASE_CHECK Valida a configuração da transação do usuário. Usado para evitar a oferta de produtos e softwares digitais a usuários em que a transação falhará. actions_intent_DIGITAL_PURCHASE_CHECK
actions.intent.COMPLETE_PURCHASE Inicia um pedido de aprovação de compra. Gera um resultado de compra que descreve se e como a transação foi bem-sucedida ou falhou. actions_intent_COMPLETE_PURCHASE

Intents de engajamento do usuário

A tabela a seguir descreve as intents relacionadas aos recursos de engajamento do usuário. Encontre mais informações sobre como implementar essas e outras intents relacionadas na documentação do recurso de engajamento do usuário.

Nome da intent Fornecer fulfillment Fulfillment da solicitação Uso Evento do Dialogflow
actions.intent.REGISTER_UPDATE X Solicita que o usuário se registre para atualizações. actions_intent_REGISTER_UPDATE
actions.intent.CONFIGURE_UPDATES X Você recebe esse intent quando o usuário tenta se registrar para atualizações (ou seja, é necessário enviar uma intent REGISTER_UPDATE). actions_intent_CONFIGURE_UPDATES

Intents personalizadas

Você pode criar suas próprias intents para definir atalhos na conversa e ajudar os usuários a realizar tarefas com mais eficiência. Essas intents residem no seu próprio namespace. Você define como os usuários acionam as intents, e seu pacote de ações é o único que dará suporte a elas.

Para mais informações, leia sobre como definir ações no Dialogflow ou com o SDK do Actions. Veja mais informações sobre pacotes de ações na documentação Referência do pacote de ações.

Intents de casa inteligente

Se você estiver criando uma ação de casa inteligente, vai definir o suporte para intents de maneira um pouco diferente. Para mais informações, consulte a documentação sobre intents de casa inteligente.