Crie ações personalizadas para o Google Assistant: 12 etapas

2024 Autor: John Day | [email protected]. Última modificação: 2024-01-30 11:36

Vendo o potencial do Google Assistant conforme apresentado no Google I / O 18, bem como da Volvo Cars em seu sistema de infoentretenimento, não resisti a experimentá-lo. Reutilizei um dos meus projetos mais antigos, o VasttraPi, e fiz a interface com o Google Assistant. Se você quiser ler mais sobre o projeto, ficaria muito satisfeito se você desse uma olhada no artigo relacionado em meu blog: Ações personalizadas para Google Assistant.

Neste Instructable, iremos repassar as etapas necessárias para lançar sua própria ação do Google Assistant, que se comunicará com o seu servidor e responderá com você, listando as partidas futuras. Lembre-se de que não usaremos o SDK, pois o estamos executando totalmente no Google Assistente e não em nosso próprio dispositivo. De modo geral, ele será mantido simples. Sua ação poderá ser usada em dispositivos compatíveis com o Google Assistente, como telefones, tablets, assistentes domésticos e vestíveis, e você pode até mesmo compartilhá-la como faria com um aplicativo na Play Store!

Uma das principais vantagens de criar algo assim em relação ao uso de serviços como o IFTTT é que você pode criar respostas personalizadas em seu servidor que serão lidas pelo Google Assistant. No IFTTT, a comunicação é, no que me diz respeito, unilateral.

Os seguintes tópicos serão cobertos:

• Criando seu primeiro projeto Action
• Criação de seu intent personalizado
• Criação de sua entidade personalizada
• Configurando um webhook para realizar sua ação
• Configurando um servidor REST simples, escrito em Python com Flask, que fornecerá as respostas ou "cumprimento"
• Testando seu projeto Action
• Liberando seu projeto Action

Aqui, você não encontrará muitos detalhes ou teorias sobre as várias funções e conceitos do Google Assistant. Se você estiver interessado neles, eu sugiro fortemente que você siga o tutorial oficial ou assista a este vídeo.

Etapa 1: definir as permissões da sua conta do Google

Antes de começar, precisamos garantir que o Google Assistente tenha as permissões adequadas.

1. Vá para Controles de Atividade

2. Certifique-se de que o seguinte esteja ativado:

   1. Atividade na Web e de aplicativos
   2. Informação de dispositivo
   3. Atividade de voz e áudio

Etapa 2: Crie sua ação

1. Vá para o console de ações e clique em "Adicionar / importar projeto"
2. Vamos chamar esse projeto de Ações de "planejador de tráfego local".
3. Clique em "Criar projeto".
4. Na página seguinte, não escolha uma categoria e clique em "Pular".
5. Você deve estar na página principal do console de ações agora.

Etapa 3: Invocação de ação

Determine como você deseja acionar o Google Assistente para iniciar sua ação.

1. Clique em "Decida como sua ação é chamada" em "Configuração rápida".
2. Chame-o de "Meu planejador de tráfego local" e clique em "Salvar".

3. Clique no prompt "ATUALIZAR INVOCAÇÕES DE AMOSTRA" que apareceu após clicar em salvar.

   Você também pode encontrar essa opção em "Informações do diretório"

4. Adicione "Pergunte ao meu planejador de tráfego local" como uma nova invocação e clique em "Salvar".

Etapa 4: adicione sua primeira ação

1. Clique em "Ações" na barra esquerda.
2. Clique em "ADICIONE SUA PRIMEIRA AÇÃO".
3. Selecione "Intenção personalizada" e clique em "Construir".
4. Você será direcionado para a página Dialogflow, onde implementará a lógica principal.

Etapa 5: treinar frases para sua intenção

1. Escolha seu fuso horário e clique em "Criar".
2. Na página seguinte, deixe as intents existentes e clique em "CRIAR INTENÇÃO".
3. Dê à intenção um nome razoável, ou seja, "partidas".
4. Vá em "Frases de treinamento" e clique em "Adicionar frases de treinamento".

5. Use as seguintes frases para treinar seu modelo para que ele possa interpretar o que você está dizendo:

   1. Estou em casa agora
   2. Por enquanto estou em casa
   3. Estou no nosso apartamento no momento
   4. Eu estou sentado em casa
   5. Atualmente estou perto do trabalho
   6. estou no trabalho
   7. Eu estou no escritório
   8. Trabalhar
   9. Casa

Etapa 6: Entidades

Agora que você especificou o que deve ser mais ou menos esperado como uma entrada, precisamos definir quais partes da entrada são de interesse para nossa lógica de negócios para que possam ser extraídas e destacadas em nosso servidor. No nosso caso, queremos saber se o usuário está em casa ou no trabalho, para que possamos responder com as saídas da estação específica. Vamos ver como podemos fazer isso.

1. Se você clicar duas vezes em uma ou mais palavras das frases de treinamento, obterá uma lista de entidades predefinidas. Você pode ler mais sobre cada uma delas aqui. No geral, o mais adequado seria @ sys.location, porém acho que é melhor e mais fácil se criarmos nossa própria entidade, que devemos chamar de @ current-location.
2. Clique na opção "Entidades" do lado esquerdo.
3. Clique em "CRIAR ENTIDADE".

4. Defina o nome como "localização atual" e defina dois valores de referência junto com seus sinônimos:

   1. casa

      casa, casa, apartamento, berço

   2. trabalhar

      trabalho, escritório, Aptiv, código minas (risos, brincadeira)

5. Clique em "Salvar. Para um efeito extra, você também pode clicar em" Permitir expansão automatizada "para dar ao Google Assistente mais liberdade para tentar combinar mais sinônimos com seus valores de referência.

Etapa 7: Ação e Parâmetros

É hora de dar algum significado às palavras-chave dentro de suas frases de treinamento.

1. Clique em "Intents" e navegue até seu intent personalizado, ou seja, "partidas", se você estiver seguindo minhas sugestões de nome.
2. Role para baixo até "Frases de treinamento".
3. Clique duas vezes nas palavras que indicam sua localização atual e escolha a marca @ current-location na janela pop-up.
4. Role para baixo até "Ações e parâmetros", clique em "gerenciar"
5. Se tudo foi feito corretamente, você verá sua nova entidade sendo listada lá.
6. Marque a caixa "Obrigatório" que faz com que uma nova coluna, "Prompts", apareça. Prompts é o que o usuário ouvirá se nada que corresponda à expectativa for fornecido.
7. Clique em "Definir prompts" e insira algo como "Não entendi sua localização. Onde você está no momento?".

Etapa 8: Cumprimento

Agora é a hora de conectar seu serviço da web ao Google Assistant Action. Seu gancho será chamado quando esse intent específico for acionado e deve produzir o cumprimento dessa ação. Antes disso, também queremos definir nossa intenção de concluir a ação depois de cumprida.

1. Vá em "Respostas" e clique em "ADICIONAR RESPOSTA".
2. Não adicione nenhuma resposta, apenas ative "Definir esta intenção como fim da conversa".
3. Role para baixo até "Fulfillment", clique em "HABLE FULFILLMENT" e depois ative a opção "Habilitar chamada de webhook para esta intenção".
4. Clique em "Salvar" e vá para a opção "Preenchimento" do lado esquerdo.

5. Habilite a opção "Webhook" e insira a URL que está sendo "ouvida" pelo seu servidor web.

   Sempre que o intent for acionado, ele enviará uma solicitação POST ao seu site com o corpo da solicitação contendo um objeto JSON com a localização atual do usuário

6. Clique em Salvar.
7. Agora estamos prontos para criar nosso web service, mas antes disso, vamos nos certificar de que nosso Action nos acolhe de maneira adequada.

Etapa 9: intenção de boas-vindas

Para personalizar a experiência do usuário, devemos criar uma saudação apropriada para nós sempre que dispararmos nossa ação.

1. Vá para "Intents" e clique em "Default Welcome Intent".
2. Role para baixo até "Respostas", remova as existentes e insira o que deseja que sua ação receba assim que for iniciada.
3. Clique em "Salvar".

Etapa 10: Seu serviço da Web em Python

Vamos fazer um servidor Python rápido e sujo usando Flask. Nenhuma captura de tela para esta etapa, mas deve ser bastante simples.

1. Abra uma nova guia e crie uma conta em pythonanywhere.com
2. Verifique seu e-mail.
3. Configure seu aplicativo da web clicando em "Abrir guia da web".
4. Clique em "Adicionar um novo aplicativo da web" e selecione "Flask" como sua estrutura da web Python.
5. Selecione Python 3.6 e clique em "Avançar".
6. Escolha o caminho em que deseja que seu "flask_app.py" resida. Coloquei-o diretamente dentro da minha pasta pessoal como "/home/your-username/flask_app.py".
7. Volte para a página principal clicando no logotipo do Python no canto superior esquerdo.
8. Nos arquivos, clique em "flask_app.py" para começar a editá-lo.
9. Quando o editor de texto da web abrir, cole o código a seguir e clique em "Salvar". A ideia geral é que dependendo do JSON analisado vindo do Google Asssistant, nosso servidor executará uma ação (por exemplo, ler ou escrever) e relatá-la de volta como uma resposta / cumprimento que deve ser lido para o usuário.
10. Clique em "Abrir guia da web" novamente e, em seguida, no botão verde "Atualizar".
11. Agora você deve ter seu próprio servidor web Python rodando em "https://your-username.pythonanywhere.com/departures".

Etapa 11: Teste sua ação

OK, você está praticamente pronto agora. Vamos testar a pilha inteira agora e fazer com que este exemplo "Olá, mundo" funcione!

1. Clique em "Integrações" na barra lateral esquerda.
2. Clique em "Configurações de integração" na opção Google Assistant.
3. Em "Invocação implícita, adicione o nome de sua intenção, ou seja," partidas ", para que possa ser acionado diretamente dizendo algo como" Ei Google, fale com meu planejador de tráfego local sobre partidas de casa ".
4. Habilite as alterações de "visualização automática".
5. Clique em "Teste" que abrirá uma nova página.
6. Digite "Fale com o meu planejador de tráfego local".
7. Sua ação deve ser invocada, o que deve saudá-lo com uma das respostas de intenção de boas-vindas definidas anteriormente.
8. Em seguida, digite "Estou no trabalho". Seu servidor Python deve ser contatado e a resposta lida pelo Google Assistente.

Legal, não é? Agora imagine o que você pode fazer interagindo com sensores, atuadores e outras APIs por meio do Google Assistant.

Etapa 12: libere sua ação

Depois que você terminar de testar seu Action e ele estiver em bom estado, é hora de compartilhar o amor com o mundo ou, se isso não fizer sentido, com seus amigos e familiares.

1. Volte para o console do Actions e selecione a ação do planejador de tráfego local.
2. Em "Prepare-se para implantação", clique em "Insira as informações necessárias para listar sua ação no diretório Actions".
3. Insira uma descrição curta, uma descrição mais longa, um pequeno logotipo, seus detalhes de contato, um link de política de privacidade (se você não vai compartilhar isso publicamente, basta colocar um link para seu site ou algo assim) e uma categoria.
4. Role para cima e clique em "Salvar".
5. Clique na opção "Liberar" na barra lateral esquerda.
6. Aqui você pode escolher em que estado está sua ação. Se você não quiser ouvir a resposta "Vamos obter a versão de teste de Meu planejador de tráfego local", terá que fazer um lançamento público completo. No entanto, isso requer uma revisão do Google e não será abordado neste tutorial. Em vez disso, você ainda pode compartilhar isso com até 20 pessoas, escolhendo uma versão Alfa e adicionando-as como testadores Alfa.
7. Adicione qualquer testador alfa enviando-lhes um link ou adicionando seus e-mails.
8. Clique em "ENVIAR PARA ALPHA", marque as caixas, clique em "ENVIAR" e pronto!

Agora seu Action está ao vivo e pode ser acessado por você e seus amigos. Divirta-se!

Se você está interessado no código que usei, dê uma olhada no projeto no GitHub.