Versiones y entornos

Puedes crear varias versiones de tus flujos de agentes, guías y herramientas, e implementarlas en entornos de servicio independientes.

Cuando editas un flujo de trabajo, una guía o una herramienta, estás editando el borrador. En cualquier momento, puedes guardar el borrador como una versión. Una versión es una captura inmutable de los datos de tu flujo de trabajo, manual de instrucciones o herramienta, así como de los datos del agente asociado. En el caso de los flujos, se incluyen los intents, las entidades, los webhooks, las páginas y los grupos de rutas. En el caso de las guías, solo se incluyen ejemplos.

Cuando guardas un borrador, se implementa en el entorno predeterminado. Cuando creas versiones específicas, puedes implementarlas en entornos personalizados. Puedes crear varios entornos personalizados, como los siguientes:

• prueba
• desarrollo
• producción

Además, puedes crear webhooks específicos de cada entorno para aislar el entorno de producción de los entornos de desarrollo y de prueba.

Prácticas recomendadas para el tráfico de producción

Usar siempre versiones para el tráfico de producción

Un borrador se actualiza cada vez que un desarrollador de tu equipo hace un cambio. Es posible que se rompa un borrador sin querer, sobre todo si varias personas tienen acceso de escritura al agente. Además, un borrador editado recientemente puede no ser coherente con el modelo entrenado, ya que el entrenamiento puede tener un retraso o requerir una ejecución manual.

Siempre debes usar versiones para tu tráfico de producción. Los recursos de borrador se deben probar antes de promocionarlos a versiones de producción. Además, puedes volver a una versión anterior si se detecta algún problema.

Usar siempre webhooks específicos del entorno

Cuando actualizas tu agente, a menudo tienes que hacer cambios interdependientes en el código de tu webhook. Durante el desarrollo y las pruebas de estos cambios, te recomendamos que hagas lo siguiente:

• Para probar las actualizaciones del agente con las actualizaciones del código del webhook.
• Para evitar implementar el código de webhook en producción hasta que hayas completado las pruebas.

Si usa webhooks específicos del entorno, podrá conseguir ambos objetivos.

Tenga en cuenta los posibles errores del agente al cambiar de versión

Si cambias una versión en tu entorno de producción mientras hay sesiones activas, es posible que se produzcan errores del agente en algunas sesiones activas. Estos errores pueden producirse si las versiones anterior y nueva no son coherentes entre sí de forma que interrumpan el estado de la sesión. Por este motivo, debes planificar el cambio de versión durante el tiempo de inactividad o las horas de menor actividad.

Cargar una versión en borrador

En cualquier momento, puedes cargar una versión en borrador para que se pueda editar y la use el entorno predeterminado.

Al cargar una versión de un flujo en borrador, se pueden actualizar varios recursos de un agente, incluidos los recursos a nivel de agente, como las intenciones y las entidades. Cuando cargues una versión en borrador con la consola o la API, podrás elegir si se sobrescribirán los recursos a nivel de agente.

Del mismo modo, si restauras una versión de una guía a borrador, se sobrescribirá la guía que ya esté en borrador y sus ejemplos. Si restauras una herramienta, se sobrescribirá la herramienta que tengas en borrador.

Gestionar versiones

Para gestionar tus versiones, sigue estos pasos:

Comparar versiones de flujos

Una vez que hayas creado versiones del flujo, puedes usar la herramienta Comparar versiones para ver una comparación en paralelo entre las versiones del flujo o la versión de borrador. Esta función no está disponible en los manuales de estrategias. Para comparar versiones, sigue estos pasos:

Gestionar entornos

Para gestionar los entornos de tu agente, sigue estos pasos:

Especificar el entorno de las llamadas de sesión

Puedes especificar un entorno al hacer llamadas de sesión en tiempo de ejecución mediante el simulador de la consola o la API. Si no se especifica ningún entorno, se usa el predeterminado.

https://dialogflow.googleapis.com/v3/projects/my-project-id/locations/us/agents/my-agent-id/environments/6db409d7-57ac-41d7-83bd-89b8768e2745/sessions/my-session-id:detectIntent

Especificar versiones de flujo para las llamadas de sesión

Puedes especificar un conjunto de versiones de flujo al hacer llamadas de sesión de tiempo de ejecución mediante el simulador de la consola o la API. No es necesario que las versiones de flujo seleccionadas se hagan referencia en ningún entorno.