Libera tu acción

Si pruebas tu acción con usuarios, tendrás la oportunidad de recibir comentarios anticipados y solucionar cualquier problema técnico o con la experiencia del usuario antes de su lanzamiento final.

La Consola de Actions admite entornos de lanzamiento, de modo que puedes otorgar acceso a un conjunto limitado de usuarios para que prueben una acción nueva o una versión más reciente de la acción existente antes de implementarla de forma pública.

Ciclo de vida de un lanzamiento

En el siguiente diagrama, se muestran las posibles rutas que puede seguir el ciclo de vida de una acción:

Figura 1: Ciclo de vida de una acción con entornos de actualización

La Consola de Actions admite dos tipos de entornos de versiones de preproducción:

• Alfa: Este canal debe usarse para probar rápidamente las primeras versiones de tu acción.

  • Te permite distribuir tu acción a un pequeño grupo de usuarios sin pasar por una revisión completa de Google.
  • Se les advierte a los usuarios que la Acción no se sometió a una revisión de Google para verificar que cumplen con las políticas.
  • Ideal para pruebas internas.

• Beta: Este canal te permite distribuir una acción a un conjunto limitado de usuarios después de pasar una revisión completa de Google.

  • Debes usar este canal para otorgar a los usuarios ajenos a tu organización acceso a las primeras versiones de la acción.
  • Se informará a los usuarios que la acción es una versión preliminar.
  • Debido a que la versión beta aprobó la revisión de Google, puede decidir que sea pública en cualquier momento sin que Google realice otra revisión.

Nota: Solo puedes lanzar una versión alfa o beta "publicada" de tu acción.

Comparación de entornos de lanzamiento

En la siguiente tabla, se resumen las diferencias entre los canales de implementación.

	Simulador	Alfa	Beta	Producción
Público objetivo	Solo para desarrolladores	Primeros verificadores de tu equipo, amigos y familiares	Verificadores fuera de tu equipo	Todos los usuarios del Asistente de Google
Requiere revisión de Google	No	No	Sí	Sí
Quién tiene acceso	Solo para desarrolladores	Lista de usuarios definida por el desarrollador. Los usuarios deben habilitar esta opción.	Lista de usuarios definida por el desarrollador. Los usuarios deben habilitar esta opción.	Disponible de forma pública para todos los usuarios del Asistente de Google
Cant. máx. de usuarios	1	20	200	N/A
Dónde está disponible	Simulador y todos los dispositivos con Asistente integrado	Todos los dispositivos con el Asistente integrado	Todos los dispositivos con el Asistente integrado	Todos los dispositivos con el Asistente integrado
Compilador de Actions	Admitido	Compatible	Admitido	Sí
SDK de Actions	Admitido	Compatible	Admitido	Sí
Dialogflow	Admitido	Compatible	Admitido	Sí
Casa inteligente	Compatible (requiere vinculación de cuentas)	No se permite	No se permite	Sí
Plantillas	Admitido	No compatible	No se permite	Sí
Invocación explícita	Admitido	Compatible	Admitido	Sí
invocación implícita	Admitido	Compatible	Admitido	Sí
Vinculación de las cuentas	Admitido	Compatible	Admitido	Sí

Nota: Si usas el control de versiones de Dialogflow, puedes implementar diferentes versiones en entornos de actualización distintos. Para obtener más información, consulta Envía tu proyecto.

Administra pruebas para las versiones alfa o beta

Para configurar la prueba de las versiones alfa o beta, sigue estos pasos:

1. Haz clic en Administrar verificadores Alfa o Administrar verificadores Beta.

2. Ingresa las direcciones de correo electrónico de los verificadores, separadas por comas. Puedes especificar hasta 20 verificadores para las pruebas alfa y hasta 200 verificadores para las pruebas beta.

   Nota: Los verificadores deben tener una Cuenta de Google (@gmail.com) o Google Workspace. No puedes designar varios usuarios mediante un alias de correo electrónico del Grupo de Google.

   

3. Copia el vínculo de aceptación para compartirlo con los verificadores.

4. Haz clic en Guardar.

Debes enviar un correo electrónico de invitación a los verificadores con un vínculo a la versión alfa o beta de tu acción (el vínculo de participación). Para obtener más información, consulta Cómo recibir comentarios.

Vínculo para participar

El vínculo de participación representa la página del directorio de acciones y nunca cambia. El vínculo dirige a los verificadores a la página de tu directorio y ve la tarjeta de aceptación para el entorno apto. Si hiciste la lista de los mismos verificadores para las versiones alfa y beta, estos son aptos para ambas plataformas y ven primero una tarjeta de participación para la versión alfa.

Implementa la entrega para una versión alfa o beta

La información del canal de versiones no se incluye en la solicitud HTTP de Asistente a tu entrega. Para controlar los canales de versiones en tu entrega, debes proporcionar diferentes URL de entrega (por ejemplo, una URL de entrega para la versión beta y otra para la versión de producción de tu acción).

Recibe comentarios

Una vez que se haya lanzado tu acción al canal de versiones Alfa o Beta, debes invitar a los verificadores compartiendo tu vínculo de participación (que es lo mismo que la ficha del directorio de Asistente).

Asegúrate de indicar a los verificadores lo siguiente:

• Descarga la app del Asistente de Google en sus dispositivos móviles para realizar pruebas Alfa o Beta.
• Accede a la app del Asistente de Google con la misma cuenta que designaste como verificador Alfa o Beta.

Después de implementar la acción, los verificadores nuevos deben esperar al menos 3 horas para poder acceder a ella con el vínculo de participación.

Cuando los usuarios hacen clic en este vínculo, se los dirige a la página del directorio de la acción correspondiente. Debería hacer clic en el botón Acepto que se encuentra en la parte inferior de la página del directorio de la acción para habilitarla como verificador por primera vez.

Una vez que el verificador habilita su teléfono, tu acción está disponible de inmediato en todos sus dispositivos. Los verificadores verán tu acción en la sección Mis apps de la app del Asistente de Google etiquetada con uno de estos modos: alfa, beta o sin pruebas. La opción Sin prueba entregará a los usuarios la versión de producción de tu acción, si está disponible. Si no hay una versión de producción, no se les entregará a los usuarios nada.

Nota: Los usuarios no pueden calificar la acción en la app del Asistente de Google si utilizan versiones alfa o beta. En su lugar, debes proporcionar a los verificadores una forma de enviar comentarios por correo electrónico, a través de un sitio web, en un foro de mensajes o a través de otro mecanismo adecuado.

Prácticas recomendadas

• Asegúrate de que los usuarios se puedan unir a las pruebas. Para unirte a una prueba, los verificadores deben tener una Cuenta de Google (@gmail.com) o G Suite.
• Elige el tipo de prueba adecuado. Un grupo de prueba alfa debe ser pequeño y probar las versiones experimentales menos estables de tus acciones (como dentro de tu empresa o equipo). Usa las pruebas beta con un grupo más grande para probar versiones estables de tus acciones que estén cerca del lanzamiento.
• Proporciona un canal para que los verificadores te envíen comentarios. Los canales alfa y beta solo están disponibles para los verificadores. Asegúrate de ofrecer la posibilidad de enviar comentarios por correo electrónico, un sitio web, un foro de mensajes o algún otro mecanismo adecuado.
• Ejecuta varias pruebas en la misma acción. Puedes ejecutar pruebas alfa y beta al mismo tiempo.

Errores conocidos

• El directorio de Asistente para la Web no es compatible con las versiones alfa o beta. Asegúrate de que los verificadores sigan el vínculo en sus dispositivos móviles (Android o iOS).
• Los cambios pueden tardar unas horas en publicarse. Espera un tiempo adecuado antes de compartir el vínculo de habilitación con tus usuarios.

Crea una nueva versión alfa o beta

Para implementar tu acción en el canal de versiones Alfa o Beta, sigue estos pasos:

1. En la Consola de Actions, haz clic en Deploy > Release.

2. Haz clic en Iniciar una nueva versión.

   

3. Selecciona Alfa o Beta y haz clic en Enviar.

4. Si se le solicita, indique que completó los pasos necesarios de la lista de tareas de requisitos para la revisión de acciones.

5. Si corresponde a tu proyecto, selecciona los idiomas de la versión.

6. Haz clic en Enviar.

Una vez que envíes las versiones alfa o beta, aparecerán en la sección Administrar lanzamientos.

Nota: Después de la implementación, tu versión estará en el estado Implementando hasta 3 horas antes de que esté disponible para tus usuarios. Una vez finalizada la implementación, se quitan otras versiones publicadas en ese entorno de lanzamiento.

Nota: Si eres desarrollador del proyecto, la versión de prueba está habilitada de forma predeterminada en tu dispositivo. Si quieres acceder a las versiones alfa y beta, inhabilita la opción En pruebas de dispositivo en el simulador de la Consola de Actions.

Actualiza una versión existente de Alfa o Beta a producción

Las versiones de producción pueden ser un lanzamiento completo para todos los usuarios del Asistente de Google, un lanzamiento en etapas para regiones específicas o un porcentaje de usuarios. Los lanzamientos en etapas ayudan a probar la estabilidad de tu proyecto de acción. Es mejor lanzarla a un conjunto pequeño de usuarios y realizar aumentos graduales hasta llegar al 100% de los usuarios. Esto te permite resolver los errores antes de lanzarla para toda la base de usuarios.

Nota: Ya sea que se lance como un lanzamiento completo o en etapas, tu acción debe pasar un proceso de revisión antes de implementarse a producción. Solo se requiere una revisión. Sin embargo, si se modifica tu acción, se debe volver a revisar. Debes enviar una versión nueva de tu acción a fase beta o de producción para iniciar una revisión.

Lanzamiento en etapas

Los lanzamientos en etapas permiten a los desarrolladores administrar sus versiones de producción mediante el lanzamiento para un subconjunto de usuarios y el desarrollo gradual para todos los usuarios. Puedes aumentar gradualmente las regiones o el porcentaje de usuarios en tu lanzamiento.

Nota: No puedes seleccionar un porcentaje de usuarios dentro de una región seleccionada. No puedes cambiar entre tipos de etapa de pruebas (ubicación o porcentaje de usuarios) cuando actualizas una versión en curso. Si quieres cambiar el tipo de etapa de pruebas, debes cancelar la versión y comenzar una nueva. Solo puede haber una versión activa en el segmento de lanzamiento en etapas.

Para implementar tu acción como un lanzamiento en etapas, sigue estos pasos:

1. En Administrar versiones, selecciona la versión que se actualizará al lanzamiento de producción.
2. Haga clic en Administrar implementaciones.
3. Selecciona Implementar en producción.
4. Selecciona Lanzamiento en etapas.
5. Haz clic en Seleccionar tipo de lanzamiento.

6. Seleccione Ubicaciones especificadas o Porcentaje de usuarios. Para obtener más información sobre esta selección, consulta Lanzamiento por ubicaciones específicas o Lanzamiento por porcentaje de la base de usuarios.

   

7. Haz clic en Enviar.

Para avanzar a la etapa de lanzamiento, consulta Avanza en la etapa de lanzamiento de una versión.

Lanzamiento completo

Si seleccionas esta opción, se publicará el proyecto de acción para todos los usuarios de todos los países de destino.

Para implementar tu acción como un lanzamiento completo, sigue estos pasos:

1. En Administrar versiones, selecciona la versión que se actualizará al lanzamiento de producción.

2. Haga clic en Administrar implementaciones.

   

3. Selecciona Implementar en producción.

4. Selecciona Lanzamiento completo.

5. Haz clic en Enviar.

Crea una nueva versión de producción sin pruebas Alfa o Beta

Las versiones de producción pueden ser un lanzamiento completo para todos los usuarios del Asistente de Google, un lanzamiento en etapas para regiones específicas o un porcentaje de usuarios. Los lanzamientos en etapas ayudan a probar la estabilidad de tu proyecto de acción. Es mejor lanzarla a un conjunto pequeño de usuarios y realizar aumentos graduales hasta llegar al 100% de los usuarios. Esto te permite resolver los errores antes de lanzarla para toda la base de usuarios.

Nota: Ya sea que se lance como un lanzamiento completo o en etapas, tu acción debe pasar un proceso de revisión antes de implementarse a producción. Solo se requiere una revisión; sin embargo, si modificas tu acción y la lanzas a producción, se deberá volver a revisar. Debes enviar una versión nueva de tu acción a fase beta o de producción para iniciar una revisión.

Lanzamiento en etapas

Los lanzamientos en etapas permiten a los desarrolladores administrar sus versiones de producción mediante el lanzamiento para un subconjunto de usuarios y el desarrollo gradual para todos los usuarios. Puedes aumentar gradualmente las regiones o el porcentaje de usuarios en tu lanzamiento.

Nota: No puedes seleccionar un porcentaje de usuarios dentro de una región seleccionada. No puedes cambiar entre tipos de etapa de pruebas (ubicación o porcentaje de usuarios) cuando actualizas una versión en curso. Si quieres cambiar el tipo de etapa de pruebas, debes cancelar la versión y comenzar una nueva. Solo puede haber una versión activa en el segmento de lanzamiento en etapas.

Para implementar tu acción como un lanzamiento en etapas, sigue estos pasos:

1. En la Consola de Actions, haz clic en Deploy > Release.

2. Haz clic en Iniciar una nueva versión.

   

3. Selecciona Producción.

4. Si se le solicita, indique que completó los pasos necesarios de la lista de tareas de requisitos para la revisión de acciones.

5. Si corresponde a tu proyecto, selecciona los idiomas de la versión.

6. Selecciona Lanzamiento en etapas.

7. Haz clic en Seleccionar tipo de lanzamiento.

8. Seleccione Ubicaciones especificadas o Porcentaje de usuarios. Para obtener más información sobre esta selección, consulta Lanzamiento por ubicaciones específicas o Lanzamiento por porcentaje de la base de usuarios.

   

9. Haz clic en Enviar.

Lanzamiento por ubicaciones especificadas

Si seleccionas esta opción, se publicará tu proyecto de acción en los países o regiones que elijas.

Para lanzar tu acción por ubicación, sigue estos pasos:

1. Haz clic en Seleccionar países o regiones y marca las casillas de las regiones a las que quieres segmentar tu versión.

2. Haz clic en Enviar.

   Nota: Solo se permiten las regiones que seleccionó en la segmentación geográfica.

Lanzamiento por porcentaje de base de usuarios

Con esta opción, se libera tu acción a un porcentaje de usuarios seleccionados al azar.

Para lanzar tu acción para un porcentaje de usuarios, sigue estos pasos:

1. Haga clic en Porcentaje de usuarios.

2. Selecciona el porcentaje de usuarios para los que quieres publicar la acción.

   

3. Haz clic en Enviar.

   Nota: Para revertir este tipo de versión, establece el porcentaje en 0%.

Lanzamiento completo

Si seleccionas esta opción, se publicará el proyecto de acción para todos los usuarios de todos los países de destino.

Para implementar tu acción como un lanzamiento completo, sigue estos pasos:

1. En la Consola de Actions, haz clic en Deploy > Release.

2. Haz clic en Iniciar una nueva versión.

   

3. Selecciona Producción.

4. Si se le solicita, indique que completó los pasos necesarios de la lista de tareas de requisitos para la revisión de acciones.

5. Si corresponde a tu proyecto, selecciona los idiomas de la versión.

6. Selecciona Lanzamiento completo.

7. Haz clic en Enviar.

Una vez que se envíe la versión de producción, aparecerá en la sección Administrar lanzamientos.

Nota: Después de la implementación, tu versión estará en el estado Implementando hasta 3 horas antes de que esté disponible para tus usuarios. Una vez que se complete la implementación, se anulará automáticamente la implementación de otras versiones publicadas en ese entorno de lanzamiento.

Edita o anula la implementación de una versión

Una vez que envíes tu acción a un canal de versiones, podrás seguir realizando cambios. Puede probar la versión actual, retirarla de la revisión, ver los detalles de la versión, administrar implementaciones, anular la implementación y actualizar las etapas de lanzamiento. Aquí también puedes consultar detalles sobre versiones anteriores.

Cómo ver y editar una versión

Para ver los detalles de la versión o realizar cambios en la versión de tu acción, sigue estos pasos:

1. En Administrar lanzamientos, selecciona la versión en Nombre del lanzamiento.
2. Elige Editar lanzamiento, Administrar implementaciones o Ver más.

Avanza en la etapa de lanzamiento de una versión

Para avanzar en la etapa de lanzamiento de tu acción, sigue estos pasos:

1. En Administrar versiones, selecciona la versión que quieres actualizar.
2. Haz clic en el botón Editar lanzamiento.
3. Realiza los cambios en el lanzamiento. Por ejemplo, puede aumentar la base de usuarios de 5% a 20%.
4. Haz clic en Enviar.

Anular la implementación de producción

• Si necesitas que el lanzamiento en etapas no tenga conexión, haz clic en Editar lanzamiento en Administrar versiones. Puedes borrar todas las regiones o seleccionar 0%, según si el lanzamiento se realiza por ubicación o por porcentaje de base de usuarios.
• Para anular la implementación de una acción que se lanzó por completo (100% de la base de usuarios), haz clic en el botón Administrar implementaciones en Administrar versiones y selecciona Anular la implementación de producción.