As ações de conversa serão descontinuadas em 13 de junho de 2023. Para mais informações, consulte Desativação do Ações de conversa.

Simulador

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O simulador no Console do Actions permite testar sua ação usando 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, é necessário 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. Informar "Ok Google, falar com meu app de teste" invoca a versão atual de rascunho da Ação.
  • Por padrão, o simulador usa a versão da sua ação que está em Rascunho. Veja como selecionar outra versão para teste.

Métodos de entrada

Clique no botão no campo de texto de resposta para especificar o método de entrada do 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 texto por voz, teclado ou por toque.
  • Tocar: usado para experiências e elementos interativos, como ícones de sugestão. Disponível para smart displays e dispositivos móveis.
  • Voz: usada para entrada somente de voz. Disponível para smart displays, smartphones e alto-falantes.
  • Teclado: usado para entrada de texto. Disponível para dispositivos móveis.

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

O método de entrada é incluído em todas as solicitações para o 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 diferentes dispositivos e permitir que você teste as experiências específicas do dispositivo para a ação.

Para mudar 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 e recursos de tela e alto-falante.
    • Alto-falante: alto-falante inteligente com Google Assistente que tem recursos de alto-falante.
    • KaiOS: smartphones com Google Assistente que usam o KaiOS.

Selecione um idioma

Selecione 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

Você pode definir manualmente as coordenadas e o endereço do dispositivo. Esse recurso permite testar os recursos de segmentação por local que você definiu no console e as respostas específicas da região que foram configuradas no fulfillment.

Para acessar o local simulado para uso na ação, use o auxiliar de informações do usuário para solicitar a permissão do usuário.

Configurações

Clique no botão Configurações na parte superior esquerda para acessar mais opções do simulador.

Selecionar uma versão

É possível especificar a versão do projeto do Actions que você quer testar (versões publicadas 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 no menu suspenso ao lado de Selecionar uma versão e escolha uma versão para testar.

No menu suspenso de versão, selecione a versão do seu 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 indica o estado atual do projeto antes do envio.

Testar URL

Para evitar mudanças no ambiente de produção quando quiser testar o projeto do Actions, forneça um URL diferente 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 de URL de teste está ativada, o simulador substitui o URL de 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 projeto do Actions.

  • Configure o servidor que você quer usar para teste e 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 o URL de teste.

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

O URL de teste especificado é exibido no simulador.

Vinculação de contas

A vinculação de contas permite que sua ação use o Login do Google, a vinculação "simplificada" do Login do Google baseada em OAuth ou o OAuth.

Se você não configurou a vinculação de contas para sua ação, clique em Configurar vinculação de conta 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, insira "talk to my test app" na área de entrada do simulador para testar a ação.

  2. Envie uma consulta inicializando o fluxo de vinculação da conta da sua ação.

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

  4. Confirme se a vinculação da conta foi concluída.

A conta vinculada é mantida até que a conta seja desvinculada, então 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 fazer login na mesma conta usada para criar o projeto do Actions on Google.

Reprodução de áudio

Alterne esta opção para silenciar 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

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