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 em cada estágio do ciclo de desenvolvimento, desde os testes interativos de desenvolvimento até os testes Beta com usuários finais.

Use os recursos abaixo para melhorar a qualidade e a confiabilidade da sua Ação desde o desenvolvimento inicial até o lançamento:

  • Com o teste manual pelo simulador, é possível testar a ação no Console do Actions durante o desenvolvimento.
  • Testes automatizados com frameworks de teste e a API Actions ajudam a gerar testes automatizados e que podem ser repetidos.
  • Os testes de usuário com os canais Alfa e Beta com versão limitada ajudam você a receber testes e feedback reais.

Teste manual com o simulador

O simulador no Console do Actions permite testar sua ação manualmente em 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 para testes no projeto que está selecionado.

Figura 1. Interface do simulador do Console do Actions 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. Com essas opções, você pode testar os recursos da sua Ação de maneira 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 que você precise testar o código manualmente todas as vezes.

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 conjunto de testes que envia consultas para a ação e faz declarações sobre essa saída para verificar informações específicas do estado de conversação dela.

A API Actions oferece endpoints REST que permitem criar um rascunho da sua ação e interagir de forma programática com ela usando consultas, além de encontrar dados de intent correspondentes para uma determinada consulta. Se você quiser usar esses endpoints diretamente, faça o download da biblioteca de cliente da API Node.js Actions.

Com a biblioteca de testes, você pode testar uma única rodada de conversa enviando uma consulta usando a função sendQuery. Esse método usa uma consulta de texto como entrada e produz uma saída estruturada que inclui 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 tratada. Você pode usar métodos de declaração integrados no objeto de teste de saída para verificar o comportamento da ação, como a intent correspondente e o cenário atual.

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

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();
});

Veja o exemplo completo de trabalho do pacote de testes escrito em Node.js para nosso exemplo de código de Componentes da conversa.

Para mais informações sobre como começar a usar esse framework de testes, consulte as instruções da Biblioteca de testes Node.js.

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

O Console do Actions oferece opções para lançar sua ação em canais de lançamento limitados para teste por um conjunto de usuários selecionado. No console, você pode lançar sua ação nos canais Alfa e Beta, permitindo que um número limitado de usuários a teste e forneçam 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 sua ação para produção.

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

O canal de lançamento Alfa permite que você libere sua ação para um conjunto de 20 usuários especificados pelo desenvolvedor, que podem 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 da ação do Google. Os testadores Alfa têm acesso imediato à sua Ação quando ela é lançada neste canal.

O canal de lançamento Beta permite que você libere a ação para um conjunto de 200 usuários especificados pelo desenvolvedor, que poderão testá-la 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 seu projeto tiver passado 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 canais de lançamento, consulte a documentação Lançamentos do Console do Actions.