Liberar a ação

Ao testar a ação com os usuários, você tem a oportunidade de receber feedback antecipado e corrigir problemas técnicos ou de experiência do usuário antes do lançamento oficial.

O Console do Actions é compatível com ambientes de lançamento. Assim, você pode dar acesso limitado a um conjunto limitado de usuários para testar uma nova ação ou uma versão mais recente da ação existente antes de implantá-la ao público.

Ciclo de vida de uma versão

O diagrama a seguir mostra os possíveis caminhos que o ciclo de vida de uma ação pode seguir:

Figura 1. Ciclo de vida de uma ação com ambientes de lançamento.

Há dois tipos de ambientes de lançamento de pré-produção compatíveis com o Console do Actions:

• Alfa: este canal deve ser usado para testar rapidamente as primeiras versões do seu Action.

  • Permite que você distribua sua ação para um pequeno grupo de usuários sem passar por uma análise completa do Google.
  • Os usuários recebem avisos de que a ação não passou por uma análise do Google em relação à conformidade com a política.
  • Ideal para testes internos.

• Beta: este canal permite distribuir uma ação a um grupo limitado de usuários após passar por uma avaliação completa do Google.

  • Use este canal para permitir que usuários fora da organização acessem as versões iniciais da ação.
  • Os usuários serão informados de que a ação é uma versão de visualização.
  • Como a versão Beta foi aprovada na avaliação do Google, você pode torná-la pública a qualquer momento sem precisar de outra revisão do Google.

Observação: você só pode ter uma versão Alfa ou Beta ativa da sua ação lançada.

Comparação do ambiente de lançamento

A tabela abaixo resume as diferenças entre os canais de implantação.

	Simulador	Alfa	Beta	Produção
Público-alvo	Somente para desenvolvedores	Testes iniciais com sua equipe, amigos e familiares	Testadores fora da sua equipe	Todos os usuários do Google Assistente
Requer análise do Google	Não	Não	Sim	Sim
Quem pode acessar	Somente para desenvolvedores	Lista de usuários definida pelo desenvolvedor. Os usuários precisam aceitar.	Lista de usuários definida pelo desenvolvedor. Os usuários precisam aceitar.	Disponível publicamente para todos os usuários do Google Assistente
Número máximo de usuários	1	20	200	POLÍTICA SOBRE SAÚDE E MEDICAMENTOS
Onde disponível	Simulador e todos os dispositivos com o Assistente	Todos os dispositivos com o Assistente	Todos os dispositivos com o Assistente	Todos os dispositivos com o Assistente
Criador de ações	Compatível	Compatível	Compatível	Sim
SDK do Actions	Compatível	Compatível	Compatível	Sim
Dialogflow	Compatível	Compatível	Compatível	Sim
Casa inteligente	Compatível (exige vinculação de conta)	Sem suporte	Sem suporte	Sim
Modelos	Compatível	Incompatível	Sem suporte	Sim
Invocação explícita	Compatível	Compatível	Compatível	Sim
invocação implícita	Compatível	Compatível	Compatível	Sim
Vinculação de contas	Compatível	Compatível	Compatível	Sim

Observação: se você estiver usando o controle de versão do Dialogflow, poderá implantar versões diferentes em diferentes ambientes de lançamento. Para saber mais, consulte Enviar seu projeto.

Gerenciar testes da versão Alfa ou Beta

Para configurar seus testes Alfa ou Beta, siga estas etapas:

1. Clique em Gerenciar testadores Alfa ou Gerenciar testadores Beta.

2. Digite os endereços de e-mail dos testadores separados por vírgulas. É possível especificar até 20 testadores para teste Alfa e até 200 testadores Beta.

   Observação: os testadores precisam ter uma Conta do Google (@gmail.com) ou do Google Workspace. Não é possível designar vários usuários por meio de um alias de e-mail do Grupo do Google.

   

3. Copie o link de ativação para compartilhar com seus testadores.

4. Clique em Salvar.

Envie um e-mail de convite aos testadores com um link para a versão Alfa ou Beta da sua ação (o link de ativação). Para saber mais, consulte Receber feedback.

Link de ativação

O link de ativação representa sua página do diretório de ações e nunca muda. O link aponta os testadores para a página do diretório e mostra o cartão de ativação do ambiente qualificado. Se você listou os mesmos testadores para as versões Alfa e Beta, elas estarão qualificadas para ambos e verão um card de ativação para a versão Alfa.

Implementar o fulfillment em uma versão Alfa ou Beta

As informações do canal de lançamento não são incluídas na solicitação HTTP do Assistente para o fulfillment. Para processar canais de lançamento no fulfillment, é preciso fornecer URLs de fulfillment diferentes (por exemplo, um para a versão Beta e outro para a versão de produção do seu Action).

Peça feedback

Depois que sua ação for lançada no canal de lançamento Alfa ou Beta, você poderá convidar os testadores compartilhando seu link de ativação, que é o mesmo da listagem de diretórios do Assistente.

Indique aos testadores que eles precisam:

• fazer o download do app Google Assistente no dispositivo móvel para realizar testes Alfa ou Beta;
• Faça login no app Google Assistente usando a mesma conta que você designou como testador Alfa ou Beta.

Depois de implantar a ação, todos os novos testadores precisam aguardar pelo menos três horas para acessá-la usando o link de ativação.

Quando os usuários clicam nesse link, eles são direcionados para a página do diretório da ação correspondente. Eles precisam clicar no botão Aceitar, na parte inferior da página do diretório da ação, para participar como testador pela primeira vez.

Depois que o testador ativar o recurso no smartphone, a ação ficará disponível imediatamente em todos os dispositivos. Os testadores verão sua ação na seção Meus apps do app Google Assistente com um destes modos: Alfa, Beta ou Sem testes. A opção Sem teste veiculará aos usuários a versão de produção da sua ação, se disponível. Se não houver uma versão de produção, os usuários não receberão nada.

Observação: os usuários não podem classificar sua ação no app Google Assistente se estiverem usando versões Alfa ou Beta. Em vez disso, ofereça aos testadores uma maneira de enviar feedback por e-mail, por um site, em um fórum de mensagens ou por outro mecanismo adequado.

Práticas recomendadas

• Verifique se os usuários podem participar dos testes. Os testadores precisam ter uma Conta do Google (@gmail.com) ou do G Suite para participar de testes.
• Escolha o tipo de teste adequado. Um grupo de testes Alfa precisa ser pequeno e testar as versões menos estáveis e experimentais das suas ações (como dentro da sua empresa ou equipe). Use o teste Beta com um grupo maior para testar versões estáveis das Ações que estão próximas do lançamento.
• Forneça um canal para os testadores enviarem feedback. Os canais Alfa e Beta estão disponíveis apenas para seus próprios testadores. Ofereça a possibilidade de enviar feedback por e-mail, por um site, em um fórum de mensagens ou por outro mecanismo adequado.
• Faça testes simultâneos na mesma ação. É possível executar testes Alfa e Beta simultaneamente.

Problemas conhecidos

• O diretório do Assistente para a Web não é compatível com Alfa ou Beta. Verifique se os testadores seguem o link nos dispositivos móveis (Android ou iOS).
• As alterações podem levar algumas horas para serem ativadas. Espere por um período adequado antes de compartilhar o link de ativação com seus usuários.

Criar uma nova versão Alfa ou Beta

Para implantar a ação no canal de lançamento Alfa ou Beta, siga estas etapas:

1. No console do Actions, clique em Deploy > Release.

2. Clique em Iniciar nova versão.

   

3. Selecione Alfa ou Beta e clique em Enviar.

4. Se solicitado, indique que você concluiu as etapas necessárias na lista de verificação Requisitos da revisão de ações.

5. Se aplicável ao projeto, selecione os idiomas da versão.

6. Clique em Enviar.

Depois que você envia a versão Alfa ou Beta, ela aparece na seção Gerenciar versões.

Observação: depois que você implantar, sua versão ficará no estado de implantação por até três horas antes de ser disponibilizada para os usuários. Após a conclusão da implantação, outras versões ativas nesse ambiente de lançamento serão removidas.

Observação :se você for um desenvolvedor do projeto, a versão de teste será ativada por padrão no dispositivo. Se você quiser acessar as versões Alfa e Beta, desative a opção No dispositivo no simulador do Console do Actions.

Fazer upgrade de uma versão existente da versão Alfa ou Beta para produção

As versões de produção podem ser um lançamento completo para todos os usuários do Google Assistente ou um lançamento gradual para regiões específicas ou uma porcentagem dos usuários. Os lançamentos graduais ajudam a testar a estabilidade do projeto de ação. É melhor lançar o app para um pequeno grupo de usuários e aumentar gradualmente até atingir 100% dos usuários. Isso permite que você resolva os bugs antes do lançamento para toda a base de usuários.

Observação: sua versão precisa ser aprovada em um lançamento completo ou em etapas antes de ser implantada na produção. Apenas uma revisão é necessária. No entanto, se sua ação for modificada, ela precisará ser analisada novamente. Você precisa enviar uma nova versão da sua ação na versão Beta ou de produção para iniciar uma revisão.

Lançamento gradual

Com os lançamentos graduais, os desenvolvedores podem gerenciar as versões de produção. Basta lançar o app para um subconjunto de usuários e fazer o lançamento gradual para todos os usuários. É possível aumentar gradualmente as regiões ou a porcentagem de usuários no seu lançamento.

Observação: não é possível selecionar uma porcentagem de usuários dentro de uma região selecionada. Não é possível alternar entre tipos de teste (local ou porcentagem de usuários) ao fazer upgrade de uma versão em andamento. Cancele a versão e inicie uma nova se quiser alterar o tipo de teste. Só pode haver uma versão ativa na faixa de lançamento gradual.

Para implantar a ação como um lançamento gradual, siga estas etapas:

1. Em Gerenciar versões, selecione a versão a ser atualizada para o lançamento na produção.
2. Clique em Gerenciar implantações.
3. Selecione Deploy to Production.
4. Selecione Lançamento gradual.
5. Clique em Selecionar tipo de lançamento.

6. Selecione Locais especificados ou Porcentagem de usuários. Para mais informações sobre essa seleção, consulte Lançamento por locais especificados ou Lançamento por porcentagem da base de usuários.

   

7. Clique em Enviar.

Para avançar o estágio de lançamento, consulte Preparar o estágio de lançamento de uma versão.

Lançamento completo

Selecionar essa opção libera o projeto de ação para todos os usuários em todos os países de destino.

Para implantar a ação como um lançamento completo, siga estas etapas:

1. Em Gerenciar versões, selecione a versão a ser atualizada para o lançamento na produção.

2. Clique em Gerenciar implantações.

   

3. Selecione Deploy to Production.

4. Selecione Lançamento completo.

5. Clique em Enviar.

Criar uma nova versão de produção sem testes Alfa ou Beta

As versões de produção podem ser um lançamento completo para todos os usuários do Google Assistente ou um lançamento gradual para regiões específicas ou uma porcentagem dos usuários. Os lançamentos graduais ajudam a testar a estabilidade do projeto de ação. É melhor lançar o app para um pequeno grupo de usuários e aumentar gradualmente até atingir 100% dos usuários. Isso permite que você resolva os bugs antes do lançamento para toda a base de usuários.

Observação: sua versão precisa ser aprovada em um lançamento completo ou em etapas antes de ser implantada na produção. Apenas uma revisão é necessária. No entanto, se você modificar sua ação e liberá-la para produção, ela precisará ser revisada novamente. Você precisa enviar uma nova versão do Action na versão Beta ou de produção para iniciar uma revisão.

Lançamento gradual

Com os lançamentos graduais, os desenvolvedores podem gerenciar as versões de produção. Basta lançar o app para um subconjunto de usuários e fazer o lançamento gradual para todos os usuários. É possível aumentar gradualmente as regiões ou a porcentagem de usuários no seu lançamento.

Observação: não é possível selecionar uma porcentagem de usuários dentro de uma região selecionada. Não é possível alternar entre tipos de teste (local ou porcentagem de usuários) ao fazer upgrade de uma versão em andamento. Cancele a versão e inicie uma nova se quiser alterar o tipo de teste. Só pode haver uma versão ativa na faixa de lançamento gradual.

Para implantar a ação como um lançamento gradual, siga estas etapas:

1. No console do Actions, clique em Deploy > Release.

2. Clique em Iniciar nova versão.

   

3. Selecione Produção.

4. Se solicitado, indique que você concluiu as etapas necessárias na lista de verificação Requisitos da revisão de ações.

5. Se aplicável ao projeto, selecione os idiomas da versão.

6. Selecione Lançamento gradual.

7. Clique em Selecionar tipo de lançamento.

8. Selecione Locais especificados ou Porcentagem de usuários. Para mais informações sobre essa seleção, consulte Lançamento por locais especificados ou Lançamento por porcentagem da base de usuários.

   

9. Clique em Enviar.

Lançamento nos locais especificados

Selecionar essa opção libera o projeto de ação para países ou regiões escolhidos.

Para implantar sua ação por local, siga estas etapas:

1. Clique em Selecionar países ou regiões e marque as caixas das regiões que serão segmentadas.

2. Clique em Enviar.

   Observação :somente regiões selecionadas na segmentação por local são permitidas.

Lançamento por porcentagem da base de usuários

Esta opção libera a ação para uma porcentagem dos usuários selecionados aleatoriamente.

Para lançar a ação para uma porcentagem de usuários, siga estas etapas:

1. Clique em Porcentagem de usuários.

2. Selecione a porcentagem de usuários para quem você quer liberar a ação.

   

3. Clique em Enviar.

   Observação: para reverter esse tipo de versão, defina a porcentagem como 0%.

Lançamento completo

Selecionar essa opção libera o projeto de ação para todos os usuários em todos os países de destino.

Para implantar a ação como um lançamento completo, siga estas etapas:

1. No console do Actions, clique em Deploy > Release.

2. Clique em Iniciar nova versão.

   

3. Selecione Produção.

4. Se solicitado, indique que você concluiu as etapas necessárias na lista de verificação Requisitos da revisão de ações.

5. Se aplicável ao projeto, selecione os idiomas da versão.

6. Selecione Lançamento completo.

7. Clique em Enviar.

Depois que a versão de produção for enviada, ela aparecerá na seção Gerenciar versões.

Observação: depois que você implantar, sua versão ficará no estado de implantação por até três horas antes de ser disponibilizada para os usuários. Depois que a implantação for concluída, o lançamento de outras versões ativas nesse ambiente será cancelado automaticamente.

Editar ou remover a implantação de uma versão

Depois de enviar a ação para um canal de lançamento, você ainda poderá fazer alterações. Você pode testar a versão atual, remover a versão da revisão, ver detalhes da versão, gerenciar implantações, cancelar a implantação e fazer upgrade dos estágios de lançamento. Aqui também é possível ver detalhes sobre versões anteriores.

Ver e editar uma versão

Para ver os detalhes da versão ou fazer alterações na versão do Action, siga estas etapas:

1. Em Gerenciar versões, selecione a versão em Nome da versão.
2. Escolha Editar lançamento, Gerenciar implantações ou Ver mais.

Avançar o estágio de lançamento de uma versão

Para avançar o estágio de lançamento da ação, siga estas etapas:

1. Em Gerenciar versões, selecione a versão a ser atualizada.
2. Clique no botão Editar lançamento.
3. Faça as alterações no lançamento. Por exemplo, talvez você queira melhorar a base de usuários de 5% para 20%.
4. Clique em Enviar.

Cancelar a implantação da produção

• Se for preciso desativar o lançamento gradual, clique em Editar lançamento em Gerenciar versões. Você pode limpar todas as regiões ou selecionar 0%, dependendo se o lançamento for por local ou porcentagem da base de usuários.
• Para cancelar a implantação de uma ação que foi totalmente implantada (100% da base de usuários), clique no botão Gerenciar implantações em Gerenciar versões e selecione Cancelar a implantação da produção.