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 borrador del agente 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 del 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

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.

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 en el Tipo de entorno para 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 reemplazará el agente de borrador en el entorno predeterminado por una versión de agente seleccionada.

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

Console

  1. Haz clic en un entorno de la sección Custom environments (Entornos personalizados).
  2. 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).
  3. Haz clic en Load to Draft (Cargar como borrador).
  4. Haz clic en Yes, I'm sure (Sí, estoy seguro).
  5. Vuelve a cargar las pestañas del navegador de la consola abierta para que se actualicen con los datos más recientes del agente.

API

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

  • Usa - como el ID de entorno para especificar el entorno predeterminado.
  • Establecer allowLoadToDraftAndDiscardChanges como verdadero.
  • En el campo agentVersion, proporciona la versión del agente que reemplazará al borrador.

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.

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 megaagentes.

Limitaciones

Se aplica la siguiente limitación:

  • Cantidad máxima de entornos por agente: 10
  • Cantidad máxima de versiones por agente: 1,000