O Ações de conversa vai ser descontinuado em 13 de junho de 2023. Para mais informações, consulte Desativação do recurso Ações de conversa.

Simulador

O simulador no Console do Actions permite testar sua ação por meio de uma interface da Web fácil de usar que simula dispositivos de hardware e as configurações deles. Também é possível acessar informações de depuração, como a solicitação e a resposta que o fulfillment recebe e envia.

Testar um projeto

Ao testar seu projeto do Actions, as seguintes restrições se aplicam:

  • As ações podem ser testadas por até 30 dias. Após 30 dias, será preciso criar uma nova versão para teste.
  • As ações em desenvolvimento podem ser testadas em qualquer dispositivo de hardware compatível (Android 6.0 ou posterior, iOS 9.1 ou superior e alto-falantes ativados por voz). O dispositivo precisa estar conectado à mesma Conta do Google que você usa no Console do Actions. Dizer "Ok Google, talk to my test app" invoca a versão de rascunho atual da ação.
  • Por padrão, o simulador usa a versão da ação que está em Rascunho. Veja como selecionar outra versão para testar.

Métodos de entrada

Clique no botão no campo de texto da resposta para especificar o método de entrada para teste.

A lista a seguir descreve os tipos de entrada e os dispositivos em que estão disponíveis:

  • Detectar automaticamente: detecta automaticamente entradas de voz, teclado ou toque.
  • Toque: usado para experiências e elementos interativos, como ícones de sugestão. Disponível para dispositivos smart display e smartphone.
  • Voz: usado para entrada somente de voz. Disponível para smart display, smartphone e alto-falantes.
  • Teclado: usado apenas para entrada de texto. Disponível para aparelhos celulares.

O método de entrada padrão é a detecção automática. Com base na superfície selecionada, os tipos de entrada também são desativados e ativados de acordo.

O método de entrada está incluído em todas as solicitações ao fulfillment no objeto RawInput como um campo inputType.

  {
  "inputType": "VOICE",
  "query": "Tell me a fact about Google's headquarters"
  }

Especificar um dispositivo

O simulador pode imitar dispositivos diferentes e permitir que você teste as experiências específicas do dispositivo do Action.

Para alterar o dispositivo simulado, siga estas etapas:

  1. Clique no menu suspenso do dispositivo no canto superior esquerdo. O Smart Display é selecionado por padrão.

  2. Escolha entre os seguintes dispositivos para simular:

    • Smart Display: dispositivos com Google Assistente, como o Nest Hub, que têm recursos de tela e alto-falante.
    • Smartphone: smartphones com Google Assistente que têm recursos de tela e alto-falante.
    • Alto-falante: um alto-falante inteligente com Google Assistente e recursos para alto-falantes.
    • KaiOS: smartphones com Google Assistente que usam o KaiOS.

Selecione um idioma

É possível selecionar um idioma no segundo menu suspenso para definir o idioma e a região que você quer simular. Consulte a documentação de localização para mais informações sobre como criar Ações em vários idiomas.

Definir local

É possível definir manualmente as coordenadas e o endereço do dispositivo. Esse recurso permite testar todos os recursos de segmentação por local definidos no console e as respostas específicas de regiões que você configurou no fulfillment.

Para receber a localização simulada para uso na sua ação, use o auxiliar de informações do usuário para pedir permissão ao usuário.

Configurações

Clique no botão Configurações no canto superior esquerdo para acessar opções adicionais para o simulador.

Selecionar uma versão

É possível especificar a versão do projeto do Actions que você quer testar (publicada ou em rascunho). Para selecionar a versão do projeto, siga estas etapas:

  1. No simulador, clique no botão Configurações no canto superior direito.

  2. Clique na lista suspensa ao lado de Selecionar uma versão e escolha uma versão para testar.

No menu suspenso da versão, selecione a versão do projeto do Actions que você quer testar e clique em CONCLUÍDO. Você vê todas as versões que enviou, além de uma versão de rascunho, que significa o estado atual do projeto antes do envio.

Testar URL

Para evitar alterações no ambiente de produção quando quiser testar o projeto do Actions, forneça um URL distinto para usar no lugar do webhook de produção. Os URLs de teste são configurados por versão de um projeto do Actions. Um projeto do Actions pode ter várias versões com URLs de teste exclusivos, permitindo que você teste várias versões da ação no simulador sem afetar a produção.

Quando a configuração do URL de teste está ativada, o simulador modifica o URL do webhook de produção para seu projeto do Actions e usa o URL do webhook de teste que você forneceu.

Antes de configurar um URL de teste no simulador:

  • Determine o URL que você quer usar para testar uma versão do seu projeto do Actions.

  • Configure o servidor que você quer usar para teste para aceitar solicitações no URL.

Para configurar um URL de teste no simulador:

  1. No canto superior direito do simulador, clique em Configurações.

  2. Ative Testar URL.

  3. Na caixa URL de teste, digite o URL que você quer usar para o teste.

O URL de teste que você especificou é exibido no simulador.

Vinculação de contas

A vinculação de conta permite que sua ação use o Login do Google, o link "simplificado" do Login do Google ou o OAuth.

Se você não tiver configurado a vinculação de contas para sua ação, clique em Configurar vinculação de contas em Configurações para acessar a seção Vinculação de contas do console.

Para vincular uma conta, siga estas etapas:

  1. No simulador do Console do Actions, digite "talk to my test app" na área de entrada do simulador para testar sua ação.

  2. Envie uma consulta inicializando o fluxo de vinculação da conta do seu Action.

  3. Faça login usando a solicitação.

  4. Confirme se a conta foi vinculada.

A conta vinculada é mantida até que a conta seja desvinculada. Assim, você pode atualizar a ação usando a mesma conta vinculada.

Para desvincular uma conta, clique em Configurações > Desvincular em Vinculação de contas.

Testes no dispositivo

Essa configuração permite ativar ou desativar testes em um dispositivo físico. Para testar em um dispositivo, você precisa estar conectado à mesma conta que usou para criar o projeto do Actions on Google.

Reprodução de áudio

Alterne esta opção para desativar ou ativar a reprodução de áudio durante o teste.

Sandbox de desenvolvimento

Quando você ativa essa opção, as formas de pagamento não são cobradas. Consulte a documentação sobre transações para mais informações.

Simular usuários não verificados

Essa opção simula quando um usuário está em um dispositivo em que o Voice Match está definido para outra pessoa.