Versiones y entornos

Puedes crear varias versiones de tu agente y publicarlas en entornos independientes.

Cuando editas un agente, estás editando el agente borrador. En cualquier momento, puedes guardar el agente de borrador como una versión del agente, que es una copia inmutable del agente.

Cuando guardas el agente de borrador, se publica en el entorno predeterminado. Cuando creas versiones de agentes, puedes publicarlas en entornos personalizados. Puedes crear varios entornos personalizados para lo siguiente:

  • prueba
  • desarrollo
  • producción
  • etc.

Tráfico de producción

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

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

Debes usar siempre versiones del agente para tu tráfico de producción. Los agentes en borrador deben probarse antes de promocionarlos a versiones de producción. Además, puedes volver a una versión anterior si se detecta algún problema.

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

Si cambia la versión de un agente en su entorno de producción mientras hay sesiones activas, es posible que se produzcan errores en el agente en algunas de esas sesiones. 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.

Publicar una versión en un nuevo entorno

Para publicar un borrador de agente en una versión y crear un entorno personalizado, sigue estos pasos:

Consola

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona tu agente cerca de la parte superior del menú de la barra lateral izquierda.
  3. Haz clic en el botón de configuración situado junto al nombre del agente.
  4. Haz clic en la pestaña Entornos.
  5. Haz clic en Publicar una versión.
  6. Añade una descripción opcional y haz clic en Siguiente.

  7. Selecciona + Nuevo entorno.

  8. Escribe un nombre de entorno.

  9. Elige el método de entrega del entorno.

  10. Selecciona los ajustes de conversión de texto a voz del entorno.

  11. Haz clic en Publicar.

  12. La información del entorno se muestra ahora en la sección Entornos personalizados.

API

  1. Llama al método create para el tipo de versión para crear una versión del agente.
  2. Llama al método create para el tipo de entorno para crear un entorno. Proporciona la versión del agente que acabas de crear en el campo agentVersion.

Volver a una versión anterior de un entorno

Para restaurar una versión anterior de un agente en un entorno, sigue estos pasos:

Consola

  1. En la sección Entornos personalizados, haga clic en un entorno.
  2. Se abrirá el cuadro de diálogo de configuración del entorno.
  3. Haz clic en el botón de una versión publicada anteriormente en la sección Historial de publicación.
  4. Haz clic en Volver a esta versión.
  5. El historial de publicación se actualizará.

API

Llama al método patch/update del tipo Environment para actualizar un entorno. En el campo agentVersion, indica la versión del agente que has creado anteriormente.

Cargar una versión anterior como borrador

Si cargas una versión anterior en el borrador, se sobrescribirá el agente de borrador del entorno predeterminado con la versión del agente seleccionada.

Para cargar una versión anterior como borrador, sigue estos pasos:

Consola

  1. Ve a la consola de Dialogflow ES.
  2. Selecciona tu agente cerca de la parte superior del menú de la barra lateral izquierda.
  3. Haz clic en el botón de configuración situado junto al nombre del agente.
  4. Haz clic en la pestaña Entornos.
  5. En la sección Borrador, haz clic en Ver todas las versiones.
  6. Haz clic en el botón de la versión que quieras cargar en el borrador.
  7. Haz clic en Cargar en borrador.
  8. Haz clic en Sí, seguro.
  9. Vuelve a cargar las pestañas del navegador de la consola que tengas abiertas para que se actualicen con los datos del agente más recientes.

API

Llama al método patch/update para el tipo de entorno con las siguientes entradas:

  • Usa - como ID de entorno para especificar el entorno predeterminado.
  • Asigna el valor true a allowLoadToDraftAndDiscardChanges.
  • En el campo agentVersion, indica la versión del agente que sobrescribirá el borrador.

Exportar una versión

Para exportar una versión, primero debes cargarla en borrador y, a continuación, exportar el agente.

Probar un agente en un entorno

Puedes usar la API para probar tu agente en cualquiera de tus entornos personalizados. Llama al método detect intent (detectar intención), pero modifica la URL del endpoint insertando environments/environment-name/users/-/ entre agent y sessions.

Por ejemplo, el siguiente endpoint usa el entorno "development" con un usuario no especificado:

"https://dialogflow.googleapis.com/v2/projects/my-project-id/agent/environments/development/users/-/sessions/123456789:detectIntent"

Configuración específica del entorno

El cumplimiento y la conversión de texto a voz se configuran en el entorno, por lo que el agente usará los ajustes del entorno para estas funciones.

Para obtener más información sobre cómo se aplican los datos en los distintos niveles, consulta los niveles de aplicación de los agentes.

Asistente de Google

Si usas entornos de lanzamiento de Acciones en Google, consulta las limitaciones de las versiones de la biblioteca de fulfillment de Dialogflow.

Megaagente

Consulta cómo funcionan las versiones y los entornos en los megaagentes.

Limitaciones

Se aplican las siguientes limitaciones:

  • Número máximo de entornos por agente: 10
  • Número máximo de versiones por agente: 1000
Anterior
Agentes prediseñados
Siguiente
Agentes multilingües