Como testar sua ação de conversa

O ambiente de desenvolvimento do Actions Builder e do SDK do Actions oferece vários métodos para testar seu projeto do Actions em cada etapa do ciclo de desenvolvimento, desde o teste de desenvolvimento interativo até o teste Beta do usuário final.

Use os recursos abaixo para melhorar a qualidade e a confiabilidade da ação do desenvolvimento inicial ao lançamento:

  • Com o teste manual no simulador, é possível testar sua ação no Console do Actions enquanto ela é desenvolvida.
  • Os testes automatizados com frameworks de teste e a API Actions ajudam a gerar testes automatizados e repetíveis.
  • Testes de usuários com canais Alfa e Beta de versão limitada ajudam você a receber testes e feedback reais.

Teste manual com o simulador

Com o simulador no Console do Actions, é possível testar sua ação manualmente usando uma interface da Web fácil de usar que simula dispositivos de hardware e as configurações deles. No console, clique em Testar para ativar o simulador e fazer testes no projeto selecionado.

Figura 1. Interface do simulador do Actions Console mostrando opções de entrada.

O simulador permite especificar um dispositivo de destino (smart display, smartphone, alto-falante), método de entrada (toque, voz, teclado), idioma e local do ambiente de teste manual. Essas opções permitem testar recursos do Action de forma rápida e interativa em vários dispositivos e regiões.

Saiba mais sobre o simulador do Console do Actions.

Testes automatizados com a API Actions

A criação de testes automatizados para sua ação pode ajudar a garantir que a lógica de conversa dela funcione conforme o esperado, mesmo quando novas mudanças de código forem introduzidas, sem a necessidade de testar manualmente o código a cada vez.

A Biblioteca de testes Node.js usa a API Actions para interagir com o código do projeto. A biblioteca de testes permite definir um pacote de testes que envia consultas para a ação e faz declarações nessa saída para verificar informações específicas sobre o estado de conversa da ação.

A API Actions fornece endpoints REST que permitem criar um rascunho da ação, interagir programaticamente com ela usando consultas e encontrar dados de intent correspondentes para uma determinada consulta. Para usar esses endpoints diretamente, faça o download da biblioteca de cliente da API Node.js Actions.

Com a Biblioteca de testes, é possível testar uma única rodada de conversa enviando uma consulta com a função sendQuery. Esse método usa uma consulta de texto como entrada e produz uma saída estruturada que contém o conteúdo do comando apresentado ao usuário, além de outras informações de diagnóstico que explicam como a solicitação foi processada. Você pode usar métodos de declaração integrados no objeto de teste de saída para verificar o comportamento da sua ação, como a intent correspondente e a cena atual.

O exemplo a seguir mostra um teste que declara que uma ação é acionada com a resposta de boas-vindas apropriada:

it('starts Action and enters the Welcome scene', async function() {
    testManager.setTestSurface('SMART_DISPLAY');
    await testManager.sendQuery('Talk to my test app');
    testManager.assertSpeech('Hello World!');
    testManager.assertText('Hello World!');
    testManager.assertIntent('actions.intent.MAIN');
    testManager.assertScene('Welcome');
    await testManager.sendStop();
    testManager.assertConversationEnded();
});

Confira o exemplo completo de trabalho do pacote de testes escrito em Node.js para nosso exemplo de código dos componentes da conversa (link em inglês).

Para mais informações sobre como começar a usar essa estrutura de teste, consulte as instruções da Biblioteca de teste do Node.js.

Testes de usuários com as versões Alfa e Beta

O Console do Actions oferece opções para liberar a ação em canais de lançamento limitados para teste com um conjunto de usuários selecionado. No console, é possível lançar ações para os canais Alfa e Beta, permitindo que um número limitado de usuários teste a ação e deem feedback no início do processo de desenvolvimento. Esse recurso oferece a oportunidade de descobrir e corrigir problemas técnicos ou de experiência do usuário antes de lançar a ação para produção.

Figura 2. A interface de versões do Console do Actions permite configurar os canais de lançamento Alfa e Beta para sua ação.

Com o canal de lançamento Alfa, você pode lançar sua Ação para um grupo de 20 usuários especificados pelo desenvolvedor para testá-la em dispositivos com o Google Assistente. As versões Alfa são ideais para testes internos porque não exigem o processo de análise de ações do Google. Os testadores Alfa terão acesso imediato à ação quando ela for lançada neste canal.

O canal de lançamento Beta permite que você lance sua Ação para um conjunto de 200 usuários especificados pelo desenvolvedor que a testem em dispositivos com o Google Assistente. As versões Beta são ideais para dar acesso a usuários fora da sua organização quando o projeto passa por uma revisão completa do Google. Quando você estiver satisfeito com o resultado do seu teste Beta, poderá lançar a versão Beta para produção, já que ela já foi aprovada na análise de compliance com a política do Google.

Para mais informações sobre os canais de lançamento, consulte a documentação Versões do Console do Actions.