Invocação implícita (Dialogflow)

A invocação implícita é um fluxo de interação que ocorre quando um usuário faz uma solicitação para executar alguma tarefa sem invocar uma ação pelo nome. O Google Assistente tenta associar a solicitação do usuário a um fulfillment adequado, como uma ação, um resultado da pesquisa ou um app para dispositivos móveis, e apresenta recomendações ao usuário.

Se você implantou uma ação que pode ajudar o usuário na tarefa, a invocação implícita oferece uma maneira para que os usuários a descubram pelo Google Assistente.

Como funciona

Para encontrar ações correspondentes, o Google usa indicadores, como pedir ao Google Assistente para fazer algo semelhante a uma frase de invocação para uma das intents configuradas ou quando o usuário está em um contexto em que sua ação seria adequada.

Essa interação ocorre da seguinte forma:

  1. Um usuário pede ao Google Assistente para realizar uma tarefa.
  2. O algoritmo de recomendação determina que sua ação pode concluir a tarefa do usuário.
  3. O Google Assistente recomenda sua ação ao usuário.

Quando o usuário seleciona a ação após a invocação implícita, o Google Assistente notifica a ação sobre a tarefa específica que o usuário solicitou.

O exemplo a seguir mostra como um usuário pode acionar uma invocação implícita solicitando uma receita de sopa de frango, sem especificar o nome de invocação de uma ação.

User Ok Google, preciso de uma receita de sopa de frango.
<O Google Assistente consulta a plataforma Actions on Google para encontrar ações adequadas para a solicitação do usuário.>
Assistente Claro! Para isso, talvez você goste do Personal Chef. Quer tentar?

Se as frases de invocação da sua Ação não puderem ser mapeadas para uma variedade de consultas de usuário relacionadas, elas não serão reconhecidas como relevantes. Para mais detalhes, consulte Práticas recomendadas para escrever frases de invocação úteis.

Devido à natureza evolutiva do algoritmo de recomendação, o Google não pode garantir que sua ação seja recomendada por invocação implícita.

Adicionar frases de invocação

Esta seção descreve como adicionar frases de invocação implícita se você estiver usando o Dialogflow ou o SDK do Actions para criar sua ação.

Dialogflow

Se você estiver usando entidades nas suas frases de treinamento, familiarize-se com os requisitos de frases com entidades.

No Dialogflow, suas ações e as respectivas frases de invocação são definidas como frases de treinamento nas intents especificadas para invocação implícita. É possível adicionar suporte a links diretos e invocações implícitas à sua Ação usando um processo de etapa única no console do Dialogflow, conforme descrito no guia de integração do Dialogflow.

SDK do Actions

No SDK do Actions, as ações e as frases de invocação delas são definidas como padrões de consulta. Consulte Definir ações para mais informações.

Analisar e consultar invocações implícitas

Nesta seção, descrevemos como usar o Console do Actions para analisar e visualizar informações sobre invocações implícitas que corresponderem à sua ação.

Análises de descoberta

A seção Analytics > Descoberta do Console do Actions fornece informações úteis sobre quais frases levaram o Google Assistente a recomendar sua ação e quais das suas intents corresponderam à solicitação.

Para mais informações, consulte nossa documentação sobre análise e integridade do console.

Conferir frases de invocação

No Console do Actions, é possível conferir sua ação e as frases de invocação dela em Build > Actions.

Clique em qualquer uma das ações listadas para ver as frases de invocação delas. Se estiver usando o Dialogflow, você terá a opção de Adicionar mais frases, que o vinculam diretamente às intents da ação no Dialogflow.

Requisitos para frases com entidades

Se você estiver usando o Dialogflow, as regras a seguir se aplicarão às entidades. Essas regras de sintaxe também se aplicam a idiomas (por exemplo, coreano e tailandês) que, na prática, não usam separação de espaços entre as palavras.

  • Se você colocar uma entidade em uma frase, ela precisa ter um espaço antes e depois.
  • Não é necessário adicionar espaço antes da entidade se ela for colocada no início de uma frase.
  • Não é necessário adicionar espaço depois da entidade se ela for colocada no final de uma frase.

Se uma entidade não for separada por espaços do texto, o Actions on Google lerá a frase inteira como uma string sem substituição de valor para a entidade.

Teste frases que contenham entidades e texto no simulador do Actions para garantir que o significado pretendido seja mantido.

Para saber mais, consulte a visão geral de entidades do Dialogflow.

Práticas recomendadas para escrever frases de invocação úteis

As frases de invocação oferecem uma ferramenta útil de invocação e descoberta para os usuários, mas é necessário escolhê-las com cuidado. Lembre-se das seguintes práticas recomendadas ao criar as frases de invocação da sua Ação:

  • Mantenha suas frases de invocação específicas para os casos de uso da sua Ação

    Sua Ação precisa ter uma finalidade específica. Portanto, verifique se suas frases de invocação realmente descrevem o que ela faz. Por exemplo, se a ação for usada para reservar voos, não use "How do I get de $location to $location?". Uma alternativa melhor é "Reserve um voo de $location para $location.".

    • Se as frases de invocação contiverem entidades, verifique se todos os sinônimos dessas entidades são relevantes para as frases e para o caso de uso da Ação em geral.
  • Criar frases que incluam um verbo e um objeto

    Uma invocação consiste em uma frase completa, o que significa que a frase de invocação da sua ação precisa ser um par de verbo-objeto para ser linguísticamente natural. Por exemplo, "Receita fácil" não seria uma boa frase de invocação porque a invocação completa seria "Ok Google, receita fácil.". Uma alternativa melhor seria "Como faço para fazer uma receita fácil?", que pode ser invocada por "Ok Google, como faço uma receita fácil".

Considere estes exemplos de frases de invocação boas e ruins:

Frases de invocação incorretas

  • A frase não tem um verbo: "O número cinco".
  • A frase é muito genérica: "Viajar para Nova York".

Boas frases de invocação

  • A frase tem um verbo e um objeto claros: "Ouça uma piada de pai".
  • A frase fornece solicitações específicas:

    • "O que devo vestir hoje?"
    • "Eu quero jogar um jogo de perguntas e respostas."
    • "Quero alguns nomes de bebês para meninas."

Essas frases de invocação podem não ser exclusivas da sua ação. Cabe ao Google Assistente determinar quais ações sugerir aos usuários.