Criar modelos de invocação

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

  • Invocação principal: essa é a única invocação obrigatória para o projeto do Actions. Os usuários dizem uma frase semelhante a "Ok Google, fale com <nome de exibição>" para corresponder a essa intent, que você normalmente processa ao receber uma mensagem de boas-vindas.

  • Invocações de link direto: são invocações opcionais que permitem definir frases de treinamento em uma intent personalizada. Assim, os usuários podem criar links diretos para uma parte específica da conversa. Os usuários podem dizer uma frase semelhante a "Ok Google, falar com <nome de exibição> para <frase de link direto>" para corresponder a esses tipos de intents (por exemplo, "Ok Google, fale com Fatos sobre o Google para saber mais sobre a empresa")

  • Intents integradas: são invocações opcionais que permitem aproveitar os modelos de invocação definidos pelo sistema. Ao declarar suporte para uma intent integrada, os usuários podem descobrir e invocar seu projeto do Actions sem precisar especificar o nome de exibição. Por exemplo, os usuários podem dizer "Ok Google, jogar", e 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 qualificadas 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 o ponto de entrada padrão do projeto. O modelo de idioma dessa invocação está associado ao nome de exibição do projeto. Assim, os usuários só precisam dizer uma frase semelhante a "Ok Google, talk to <display name>" para usar essa invocação. Quando os usuários invocam suas ações dessa maneira, o ambiente de execução do Google Assistente corresponde à intent do sistema actions.intent.MAIN.

Para criar a invocação principal:

Para criar invocações de link direto, crie intents de usuário globais com frases de treinamento que definam a entrada do usuário que você quer configurar para o link direto. Os usuários dizem seu nome de exibição com a frase de link direto para invocar um link direto (por exemplo, "Ok Google, fale com <nome de exibição> para <frase de link direto>").

Criar invocações implícitas

A invocação implícita permite que os usuários invoquem a ação sem usar o nome de exibição do projeto. Para encontrar ações correspondentes, o Google usa indicadores como os usuários pedindo 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 suas ações seriam adequadas.

Processar eventos de invocação

Quando o Google Assistente faz a correspondência com uma das intents globais, ele aciona um evento que pode ser processado com um gerenciador. As seções a seguir descrevem o que o gerenciador pode realizar. É possível escolher uma das três opções ou uma combinação delas.

Acionar um webhook

O 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:

Solicitações

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

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

Transição para uma cena

Seu gerenciador de intent pode fazer a transição para um cenário para processar a intent de invocação correspondente. Isso oferece mais flexibilidade para realizar a lógica. Para fazer a transição para uma cena: