Invocação explícita (Dialogflow)

A invocação explícita ocorre quando um usuário diz ao Google Assistente para usar a ação pelo nome. Opcionalmente, o usuário pode incluir uma frase de invocação no final da invocação que o levará diretamente à função que ele está solicitando.

Observação: os usuários podem descobrir sua ação pelo diretório do Google Assistente, que é como uma loja on-line de ações no Google Assistente. O diretório é uma fonte importante para a descoberta da Ação. Por isso, dedique algum tempo de desenvolvimento para criar uma boa página de detalhes.

Componentes de invocação explícita

O exemplo a seguir mostra os diferentes componentes possíveis de um comando de invocação explícito:

Frase de acionamento

Essas frases iniciam uma invocação explícita e são definidas pelo Actions on Google:

• "Ok Google, falar com..."
• "Ok Google, falar com..."
• "Ok Google, quero falar com..."
• "Ok Google, perguntar..."

Leia sobre frases de acionamento para cada idioma em Idiomas e localidades.

Observação: em dispositivos Android, frases de acionamento invocam sua ação, a menos que ela se sobreponha a uma intent integrada de Ações no app. Nesses casos, o Google Assistente vai abrir seu app, se estiver instalado, em vez da ação.

Por exemplo, se um usuário disser algo como "Ok Google, registre que comi um burrito no ExampleTracker, o Google Assistente vai abrir o app ExampleTracker, se a intent integrada actions.intent.RECORD_FOOD_OBSERVATION estiver implementada, em qualquer ação ExampleTracker que veicule uma intent semelhante.

Nome de invocação

Esse é o nome da sua ação, como "Personal Chef". Os usuários combinam isso com frases de acionamento para invocar ações explicitamente pelo nome, como: "Ok Google, deixe-me falar com o Personal Chef".

Observação: é importante ter a invocação em mente ao descobrir como nomear sua ação. Se você tiver um nome inteligente, mas o Google Assistente não conseguir reconhecê-lo, os usuários poderão ter dificuldade para invocá-la. Consulte nossas políticas de nomenclatura e a lista de verificação de invocação para mais detalhes.

Frase de invocação (opcional)

As frases de invocação são um mecanismo valioso para aumentar a detecção da ação e oferecem aos usuários uma maneira de criar links diretos para a conversa, fornecendo uma tarefa específica a ser realizada. Essas frases ilustram várias maneiras de os usuários solicitarem os recursos da sua Ação. Assim, o Google Assistente pode entender melhor os recursos dela e associá-los às solicitações do usuário.

• "encontre receitas"
• "recomendar um vinho"
• "agendar uma viagem"
• "jogar um jogo"
• "quero meditar"

Os usuários combinam o nome de invocação com frases de invocação para invocar explicitamente intents específicas, como: "Ok Google, fale com o Personal Chef para encontrar receitas".

Observação: confira se as frases de invocação são específicas para a ação e descreva casos de uso reais. Um erro comum é definir frases de invocação muito gerais para serem específicas ao propósito da sua Ação, o que torna as frases menos úteis e prejudica a descoberta. Consulte a invocação implícita e a lista de verificação da invocação para mais detalhes.

Intent de invocação explícita

Se a ação for explicitamente invocada sem qualquer frase de invocação e com o nome ("Ok Google, fale com o Personal Chef"), a intent actions.intent.MAIN na sua ação será acionada. O projeto do Actions precisa conter apenas uma intent principal para invocação explícita pelo nome.

Se a ação for invocada explicitamente com uma frase de invocação e pelo nome ("Ok Google, fale com o Personal Chef para a receita de sopa de hoje"), a intent correspondente a essa frase será invocada.

Para saber mais, consulte nossa documentação sobre intents.