Versiones y entornos

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

Cuando editas un agente, lo que se modifica es el agente de borrador. Cuando lo desees, puedes guardar el agente de borrador como una versión de agente, que es una instantánea inmutable de este.

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

  • pruebas
  • desarrollo
  • producción
  • etcétera

Tráfico de producción

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

Se actualiza un borrador del agente cada vez que un desarrollador de tu equipo realiza un cambio. Es fácil interrumpir un borrador de agente de forma involuntaria, en especial si varias personas tienen acceso de escritura al agente. Además, un agente de borrador editado recientemente puede no ser coherente con el modelo entrenado, ya que el entrenamiento puede tener una demora o requerir una ejecución manual.

Siempre debes usar las versiones de agente para tu tráfico de producción. Los agentes borradores se deben probar antes de ascender a versiones de producción, y puedes revertir a una versión anterior si se detectan problemas.

Considera los posibles errores del agente cuando cambies de versión

Si cambias la versión de un agente en tu entorno de producción mientras las sesiones están activas, es posible que se generen errores de agente en algunas sesiones activas. Estos errores pueden ocurrir si las versiones anterior y nueva no son coherentes entre sí de una manera que interrumpa el estado de la sesión. Por este motivo, debes planificar el cambio de versiones durante el tiempo de inactividad o las horas de baja actividad.

Publica una versión en un entorno nuevo

Completa los siguientes pasos para publicar un agente de borrador como una versión y crear un entorno personalizado:

Console

  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 junto al nombre del agente.
  4. Haz clic en la pestaña Environments (Entornos).
  5. Haz clic en Publish a version (Publicar una versión).
  6. Agrega una descripción si quieres y haz clic en Next (Siguiente).

  7. Selecciona +New Environment (+ Entorno nuevo).

  8. Ingresa un nombre de entorno.

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

  10. Selecciona la configuración de texto a voz del entorno.

  11. Haz clic en Publish (Publicar).

  12. La información del entorno ahora aparece en la sección Custom environments (Entornos personalizados).

API

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

Revierte un entorno a una versión anterior

Sigue estos pasos para revertir un entorno a una versión anterior del agente:

Console

  1. Haz clic en un entorno de la sección Custom environments (Entornos personalizados).
  2. Se abrirá el cuadro de diálogo de configuración del entorno.
  3. Haz clic en el botón de opción para ver una versión publicada previamente en la sección Publishing History (Historial de publicaciones).
  4. Haz clic en Revert to this version (Volver a esta versión).
  5. Se actualizará el historial de publicaciones.

API

Llama al método patch/update para el tipo de entorno a fin de actualizar un entorno. Proporciona la versión del agente que creaste antes en el campo agentVersion.

Carga una versión anterior como borrador

Si cargas una versión anterior como borrador, se reemplaza el agente del borrador en el entorno predeterminado por una versión seleccionada.

Sigue estos pasos para cargar una versión anterior como borrador:

Console

  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 junto al nombre del agente.
  4. Haz clic en la pestaña Environments (Entornos).
  5. Haz clic en Ver todas las versiones en la sección Borrador.
  6. Haz clic en el botón de opción para ver la versión que quieres cargar en borrador.
  7. Haz clic en Load to Draft (Cargar como borrador).
  8. Haz clic en Yes, I'm sure (Sí, estoy seguro).
  9. Vuelve a cargar las pestañas del navegador de la consola abierta 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 el ID del entorno para especificar el entorno predeterminado.
  • Establecer allowLoadToDraftAndDiscardChanges como verdadero.
  • En el campo agentVersion, proporciona la versión del agente que reemplazará al agente de borrador.

Exporta una versión

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

Prueba tu agente en un entorno

Puedes usar la API para probar tu agente en cualquiera de tus entornos personalizados. Llama al método detectar intent, pero ingresa environments/environment-name/users/-/ entre agent y sessions para modificar la URL del extremo.

Por ejemplo, el siguiente extremo usa el entorno de “desarrollo” 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 entorno configura la entrega y el texto a voz, por lo que el agente usará la configuración del entorno para estas funciones.

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

Asistente de Google

Si usas los entornos de versión de Actions on Google, consulta las limitaciones del control de versiones para la biblioteca de entregas de Dialogflow.

Agente combinado

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

Limitaciones

Se aplica la siguiente limitación:

  • Cantidad máxima de entornos por agente: 10
  • Cantidad máxima de versiones por agente: 1,000
Anterior
Agentes preconstruidos
Siguiente
Agentes multilingües