Criar modelos de invocação

Um modelo de invocação especifica como os usuários invocam as ações no projeto. Quando os usuários invocam uma ação, eles iniciam uma conversa com ela, que é definidos pelo seu modelo de conversa. É possível definir invocações das seguintes maneiras:

  • Invocação principal: esta é a única invocação necessária para seu projeto do Actions. Os usuários dizem uma frase semelhante a "Ok Google, falar com <nome de exibição>" para corresponder a essa intent, que você normalmente lida com saudações ao usuário com uma mensagem de boas-vindas.

  • Invocações de links diretos: São invocações opcionais que permitem definir frases de treinamento em uma intenção personalizada, para que os usuários possam criar links diretos para uma parte específica dos seus conversa. Os usuários podem dizer uma frase semelhante a "Ok Google, falar com <nome de exibição> até <deep linkphrase>" para corresponder a esses tipos de (por exemplo, "Ok Google, fale com fatos sobre o Google para conseguir fatos")

  • Intents integradas: São invocações opcionais que permitem aproveitar os benefícios modelos de invocação. Ao declarar suporte para uma intent integrada, os usuários podem descubra e invoque seu projeto do Actions sem precisar especificar nome de exibição. Por exemplo, os usuários podem dizer "Ok Google, jogar". O Google Assistente pode apresentar sua ação como uma opção de invocação.

.
Figura 1. Um modelo de invocação consiste em todas as intents qualificados para iniciar conversas com suas Ações.
.

Criar a invocação principal

Todo projeto do Actions tem uma invocação principal padrão que atua como padrão. Ponto de entrada para seu projeto do Actions.O modelo de linguagem para esta invocação está associado ao nome de exibição do seu projeto, então os usuários só precisam dizer um frase semelhante a "Ok Google, falar com <nome de exibição>" para usar esse invocação. Quando os usuários invocam suas ações dessa maneira, o Assistente o ambiente de execução corresponde à intent do sistema actions.intent.MAIN.

Para criar a invocação principal:

Para criar invocações de links diretos, crie intents globais de usuários com treinamento frases que definem a entrada do usuário que você quer configurar para o link direto. Os usuários dizem seu nome de exibição em combinação com a frase de link direto que será transmitida uma invocação de link direto (por exemplo, "Ok Google, falar com <display nome> para <frase de link direto>")

Criar invocações implícitas

A invocação implícita permite que os usuários invoquem sua ação sem usar o nome de exibição. Para encontrar ações correspondentes, o Google usa indicadores, como usuários pedir ao Google Assistente para fazer algo semelhante a uma frase de invocação para uma pessoa das intents configuradas ou quando o usuário está em um contexto em que as ações seria apropriado.

Processar eventos de invocação

Quando o Google Assistente faz a correspondência com uma das intents globais, ele aciona um evento que você pode processar com um gerenciador. As seções a seguir descrevem o que o gerenciador pode realizar (você pode escolher uma ou qualquer combinação das três).

Acionar um webhook

Seu gerenciador de intents pode delegar a um serviço da Web acionando um evento de webhook. Para acionar um webhook e fazer com que um serviço da Web processe a invocação:

Comandos

Seu gerenciador de intents pode responder com uma solicitação estática. Normalmente, os comandos as intents de invocação dão as boas-vindas ao usuário, orientam sobre como usar a ação ou responder com as informações de que o usuário precisa imediatamente (ações únicas).

Para processar uma correspondência de intent de invocação com uma solicitação:

Fazer a transição para uma cena

O gerenciador de intents pode fazer a transição para uma cena para processar a invocação correspondente intenção. Isso oferece o máximo de flexibilidade para realizar a lógica. Para fazer a transição para uma cena: