As intents representam uma tarefa que o Assistente precisa que a ação execute, como uma entrada do usuário que precisa de processamento ou um evento do sistema que você precisa processar. Use intents para criar modelos de invocação e conversa. Quando esses eventos ocorrem, o ambiente de execução do Assistente faz a correspondência com a intent correspondente e envia a intent para a ação a ser processada. Há dois tipos principais de intents, descritos na lista a seguir:
As intents de usuário permitem que você estenda a capacidade do Assistente de entender solicitações de usuários específicas para sua marca e seus serviços. Defina frases de treinamento personalizadas em uma intent que, por sua vez, gera o modelo de linguagem. Esse modelo de linguagem aumenta a NLU do Assistente, aumentando a capacidade de entender ainda mais.
Os intents do sistema têm dados de treinamento ou outros sinais de entrada não conversacionais definidos pelo Assistente. Isso significa que você não precisa definir frases de treinamento para essas intents. O Google Assistente faz a correspondência dessas intents de maneira padrão, durante eventos conhecidos do sistema, como a invocação principal ou quando os usuários não fornecem nenhuma entrada.
Intents do usuário
Ao criar ações, você cria intents de usuário que contêm frases de treinamento, o que amplia a capacidade do Google Assistente de entender ainda mais. O Google Assistente usa suas frases de treinamento para aumentar a NLU ao delegar solicitações de usuários para suas ações.
Quando isso ocorre, o Assistente intermedeia a comunicação entre o usuário e suas ações, mapeando a entrada do usuário para uma intent que tenha um modelo de linguagem correspondente. Em seguida, o Google Assistente notifica suas ações da intent correspondente para que você possa processá-las em uma cena.
Ao criar intents do usuário, especifique os seguintes elementos:
Uma designação de intent global define se o ambiente de execução do Assistente pode corresponder à intent do usuário especificada no momento da invocação, bem como durante uma conversa. Por padrão, o Google Assistente pode fazer a correspondência com as intents do usuário apenas durante uma conversa. Somente intents marcadas como globais são qualificadas para invocação de link direto.
Frases de treinamento são exemplos do que um usuário pode dizer para corresponder à intent. O mecanismo de processamento de linguagem natural (PLN) do Google Assistente expande naturalmente essas frases de treinamento para incluir outras frases semelhantes. Fornecer um grande conjunto de exemplos de alta qualidade aumenta a qualidade e a precisão da correspondência da intent.
Parâmetros são dados digitados que você quer extrair da entrada do usuário. Para criar um parâmetro, anote as frases de treinamento com types para notificar o mecanismo de PLN que você quer que partes da entrada do usuário sejam extraídas. É possível usar tipos de sistema ou criar tipos personalizados para os parâmetros.
Quando o mecanismo de PLN detecta uma correspondência de parâmetros na entrada do usuário, ele extrai o valor como um parâmetro digitado para que você possa executar a lógica em uma cena. Se um parâmetro de intent tiver o mesmo nome de um slot de cena, o ambiente de execução do Assistente preencherá automaticamente o slot da cena com o valor do parâmetro de intent. Consulte a documentação sobre mapeamento de valor do slot para mais informações.
Os parâmetros de intent também são compatíveis com correspondências "parciais". Por exemplo, se você especificar um tipo de DateTime e o usuário fornecer apenas uma data, a NLU ainda extrairá o valor parcial como parâmetro.
Você pode usar seu próprio PLN para gerenciar todas as entradas do usuário para uma ação. Por exemplo, você pode querer que sua ação responda a todos os cenários sem correspondência durante uma conversa. Para capturar todas as entradas do usuário, crie uma intent com o tipo de texto "Formato livre". No entanto, evite usar intents personalizadas para modificar globalmente o comportamento padrão de não correspondência do Assistente, já que isso pode afetar negativamente a capacidade dos usuários de alternar entre ações.
Quando você cria uma intent personalizada no Console do Actions, o Actions Builder sugere intents do sistema que podem ter o mesmo papel da intent do usuário. Para mais informações sobre intents do sistema, consulte a seção a seguir.
Intents do sistema
O Google Assistente faz a correspondência com as intents do sistema com base em eventos padrão do sistema. Esses eventos podem ter um modelo de idioma definido pelo sistema, como usuários dizendo "pause" para pausar o player de mídia, ou podem não ter um modelo de idioma, como os usuários que não fornecem nenhuma entrada. Como essas intents são fornecidas pelo Google Assistente, você não precisa se preocupar com a correspondência, mas apenas com o modo de lidar com elas.
As intents do sistema também substituem a necessidade de criar intents de usuário para ações
que são necessárias com frequência, como YES e NO. As intents do sistema são
treinadas para todas as localidades, o que facilita a implementação
de uma experiência consistente para os usuários em vários idiomas.
Intents do sistema também podem ser definidas como intents globais.
As intents do sistema têm controle de versão. É possível usar uma versão específica de uma intent do sistema desde que ela seja compatível com o Google Assistente. Se uma ação usa uma versão não compatível de uma intent do sistema, essa intent é atualizada automaticamente para uma versão compatível.
Lista de intents
| Intenção | Descrição |
|---|---|
actions.intent.MAIN
|
Todo projeto do Actions precisa conter esta invocação principal padrão, que está vinculada ao seu nome de exibição. Os usuários dizem frases como "Ok Google, falar com <nome de exibição>" para invocar a ação. |
|
|
Essas intents são correspondidas quando o usuário diz algo que não pode ser correspondido a uma intent na sua ação. É possível definir solicitações individuais e uma mensagem de saída no intent final. |
|
|
Esses intents serão correspondidos quando não houver entrada do usuário após oito segundos. É possível definir reprompts individuais para cada intent e uma mensagem de saída no intent final. |
actions.intent.CANCEL
|
Essa intent é correspondida quando o usuário quer sair das ações durante uma conversa, como um usuário dizendo, "Quero sair". |
actions.intent.MEDIA_STATUS_FINISHED
|
Esse intent é correspondido e enviado à ação quando um usuário conclui a reprodução de mídia ou pula para a próxima mídia. |
actions.intent.MEDIA_STATUS_PAUSED
|
Esse intent é correspondido e enviado à ação quando um usuário pausa a reprodução de mídia em uma resposta de mídia. |
actions.intent.MEDIA_STATUS_STOPPED
|
Esse intent é correspondido e enviado à ação quando um usuário interrompe ou sai da reprodução de mídia de uma resposta de mídia. |
actions.intent.MEDIA_STATUS_FAILED
|
Essa intent é correspondida e enviada para sua ação quando ocorre uma falha na reprodução do player de uma resposta de mídia. |
actions.intent.YES
|
Essa intent é correspondida quando um usuário fornece uma resposta afirmativa à sua ação. |
actions.intent.NO
|
Esse intent é correspondido quando um usuário fornece uma resposta negativa para sua ação. |
actions.intent.REPEAT
|
Essa intent é correspondida quando um usuário solicita que a ação repita a última resposta. As solicitações repetidas serão tratadas automaticamente pelo Assistente se a intent do sistema não estiver ativada no agente. A ativação dessa intent do sistema permite que você modifique o modo como as solicitações repetidas são tratadas, bem como as respostas. |
actions.intent.PLAY_GAME
|
Essa intent é correspondida quando um usuário pede para jogar. Essa intent permite que você ative uma invocação implícita (invocação sem usar seu nome de exibição) fornecida pelo Actions on Google. |
Adicionar suporte para outros idiomas
Algumas intents do sistema, como YES, NO e NO_MATCH, são compatíveis apenas em inglês.Para adicionar compatibilidade com outros idiomas, você precisa criar intents de usuário
que correspondam a essas intents do sistema. As novas intents precisam ser processadas no código da mesma forma que as intents do sistema implementadas.
Por exemplo, suponha que você esteja desenvolvendo uma nova ação e tenha implementado a intent do sistema YES. A intent do sistema YES é compatível apenas em inglês,
mas você também quer que o app seja compatível com interações em alemão e japonês.
Para oferecer suporte a outros idiomas, crie uma intent que inclua
frases de treinamento para alemão e japonês e implemente o processamento
usado para a intent do sistema YES.
Saiba mais sobre como criar intents de usuário.
Saiba mais sobre como localizar as intents do usuário.
Sem correspondência
Quando a resposta de um usuário não corresponde a uma das intents, o Google Assistente tenta processar a entrada. Esse comportamento facilita a mudança de ações no meio de uma conversa. Por exemplo, um usuário pergunta: "Quais filmes estão em exibição esta semana?" e muda o contexto no meio da conversa: "Qual é a previsão do tempo para amanhã?" Neste exemplo, como "Qual é a previsão do tempo para amanhã?" não é uma resposta válida à conversa acionada pelo prompt inicial, o Google Assistente tenta processar automaticamente a correspondência e mover o usuário para uma conversa apropriada.
Se o Google Assistente não encontrar uma ação adequada à entrada do usuário, ele vai continuar no contexto da ação.
Como o Google Assistente pode interromper sua ação para responder a um cenário válido
sem correspondência, não use a intent do sistema NO_MATCH para
realizar consultas do usuário. Use a intent NO_MATCH apenas para solicitar o usuário novamente.