Versiones y entornos

Puedes crear varias versiones de los flujos del agente y, luego, implementarlas en entornos de entrega diferentes.

Cuando editas un flujo, editas un flujo de borrador. En cualquier momento, puedes guardar un flujo de borrador como una versión del flujo. Una versión del flujo es una instantánea inmutable de los datos de tu flujo y los datos de los agentes asociados, como los intents, las entidades, los webhooks, las páginas y los grupos de rutas, entre otros.

Cuando guardas un flujo de borrador, este se implementa en el entorno predeterminado. Cuando creas versiones del flujo específicas, puedes implementarlas en entornos personalizados. Puedes crear diversos entornos personalizados para lo siguiente:

• pruebas
• desarrollo
• producción
• puede apuntar a Anthos, etc.

Además, puedes crear webhooks específicos del entorno para que puedas aislar tu entorno de producción de los entornos de desarrollo y de pruebas.

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

Usa siempre versiones de flujo para el tráfico de producción

Se actualiza un flujo en borrador cada vez que un desarrollador de tu equipo realiza un cambio. Es fácil dividir el flujo del borrador de forma involuntaria, en especial si varias personas tienen acceso de escritura al agente. Además, un flujo 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 versiones de flujo para tu tráfico de producción. Los flujos de borrador se deben probar antes de ascender a versiones de producción, y puedes revertir a una versión anterior si se detectan problemas.

Usa siempre webhooks específicos del entorno

Cuando realizas actualizaciones a tu agente, a menudo tienes actualizaciones interdependientes en el código de tu webhook. Durante el desarrollo y las pruebas de estos cambios, necesitas lo siguiente:

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

El uso de webhooks específicos del entorno logra ambos objetivos.

Considera los posibles errores del agente cuando cambies las versiones

Si cambias una versión de flujo en tu entorno de producción mientras las sesiones están activas, es posible que se produzcan errores de agente en algunas sesiones activas. Estos errores pueden ocurrir si la versión anterior y la nueva no coinciden entre sí de modo que se interrumpa el estado de la sesión. Por este motivo, debes planificar cambiar las versiones durante el tiempo de inactividad o las horas de menor demanda.

Carga una versión del flujo en borrador

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

La carga de una versión del flujo en borrador puede actualizar varios recursos en un agente, incluidos los recursos a nivel de agente, como los intents y las entidades. Cuando cargas una versión en borrador con la consola o la API, puedes elegir si se reemplazarán los recursos a nivel del agente.

Administra versiones de flujo

Para administrar las versiones del flujo, haz lo siguiente:

Console

Para enumerar las versiones actuales de un flujo, haz lo siguiente:

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona el agente.
4. Haz clic en la pestaña Administrar.
5. Haz clic en Versiones.
6. Se mostrará una lista de los flujos del agente. Selecciona una opción.
7. Se enumeran las versiones del flujo seleccionado.

Se muestra la siguiente información para cada flujo:

• Nombre visible: El nombre visible de la versión.
• ID de versión: El ID de la versión.
• Tipo de CLN: El tipo CLN para la versión del flujo.
• Marca de tiempo de creación: La fecha y la hora de creación de la versión.
• Estado: El estado del entrenamiento. Una versión del flujo no está lista para usarse hasta que el estado esté marcado como Lista.

Para crear una nueva versión del flujo, haz clic en el botón Crear y proporciona el Nombre visible y la Descripción de la versión.

Sigue estos pasos para cargar una versión específica del flujo como el flujo de borrador:

1. Mantén el puntero sobre una fila de versión.
2. Haz clic en el botón de opción .
3. Haz clic en la opción Cargar como borrador.
4. Se proporciona una opción para reemplazar los datos a nivel del agente durante la carga.

Sigue estos pasos para borrar una versión específica del flujo:

1. Mantén el puntero sobre una fila de versión.
2. Haz clic en el botón de opción .
3. Haz clic en la opción Borrar versión.

API

Consulta los métodos para el tipo Version. Ir a la referencia de la API de versión

Selecciona un protocolo y una versión para la referencia de la versión:

Protocolo	V3	V3beta1
REST	Recurso de la versión	Recurso de la versión
RPC	Interfaz de la versión	Interfaz de la versión
C++	VersionsClient	No disponible
C#	VersionsClient	No disponible
Go	VersionsClient	No disponible
Java	VersionsClient	VersionsClient
Node.js	VersionsClient	VersionsClient
PHP	No disponible	No disponible
Python	VersionsClient	VersionsClient
Ruby	No disponible	No disponible

Cerrar

Nota: El método load tiene un campo allowOverrideAgentResources, que se puede usar para controlar si se reemplazan los recursos a nivel del agente cuando se restablece un flujo como flujo de borrador.

Nota: Cuando llamas al método delete para borrar una versión, primero debes quitar todas las referencias a la versión en los datos de entornos.

Compara versiones del flujo

Nota: La opción Comparar versiones tiene un límite de 2 MB para el tamaño de respuesta. Usa el método de la API de REST para superar esta limitación.

Cuando crees las versiones de flujo, puedes usar la herramienta para comparar versiones a fin de visualizar una comparación en paralelo entre las versiones de flujo o el borrador. Sigue estos pasos para comparar versiones:

Console

1. Mantén el puntero sobre una fila de versión.
2. Haz clic en el botón de opción .
3. Haz clic en la opción Comparar versiones.
4. Selecciona otra versión del flujo o flujo de borrador para la comparación.
5. Se muestra una comparación en paralelo.

API

Consulta el método compareVersions para el tipo Version. Ir a la referencia de la API de versión

Selecciona un protocolo y una versión para la referencia de la versión:

Protocolo	V3	V3beta1
REST	Recurso de la versión	Recurso de la versión
RPC	Interfaz de la versión	Interfaz de la versión
C++	VersionsClient	No disponible
C#	VersionsClient	No disponible
Go	VersionsClient	No disponible
Java	VersionsClient	VersionsClient
Node.js	VersionsClient	VersionsClient
PHP	No disponible	No disponible
Python	VersionsClient	VersionsClient
Ruby	No disponible	No disponible

Cerrar

Administra entornos

Para administrar los entornos del agente, haz lo siguiente:

Console

Para enumerar los entornos actuales de un agente, haz lo siguiente:

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona el agente.
4. Haz clic en la pestaña Administrar.
5. Haz clic en Entornos.
6. Se enumerarán los entornos del agente.

Para crear un entorno nuevo, haz clic en el botón Crear y proporciona información.

Para seleccionar versiones del flujo y configurar un entorno, haz clic en un entorno y proporciona información.

Para ver el historial de cambios de un entorno, haz clic en el botón de historial cerca del lado derecho de un entorno incluido en la lista.

Para copiar el nombre de un recurso de un entorno en el que se incluye el ID del entorno, haz clic en el botón de copiado cerca del lado derecho de un entorno incluido en la lista.

Para borrar un entorno, haz clic en el botón de borrar cerca del lado derecho de un entorno incluido en la lista.

API

Consulta los métodos para el tipo Environment. Ir a la referencia de la API de entorno

Selecciona un protocolo y una versión para la referencia del entorno:

Protocolo	V3	V3beta1
REST	Recurso de entorno	Recurso de entorno
RPC	Interfaz de entorno	Interfaz de entorno
C++	EnvironmentsClient	No disponible
C#	EnvironmentsClient	No disponible
Go	EnvironmentsClient	No disponible
Java	EnvironmentsClient	EnvironmentsClient
Node.js	EnvironmentsClient	EnvironmentsClient
PHP	No disponible	No disponible
Python	EnvironmentsClient	EnvironmentsClient
Rita	No disponible	No disponible

Cerrar

Nota: Para hacer referencia a un flujo de borrador, usa 0 como el ID de versión del flujo.

Especifica el entorno para las llamadas de sesión

Puedes especificar un entorno cuando realizas llamadas de sesión de entorno de ejecución con el simulador de la consola o la API. Si no se especifica un entorno, se usará el entorno predeterminado.

Console

Cuando uses el simulador de la consola, selecciona la opción Agente de prueba en el entorno y, luego, un entorno.

API

Si deseas especificar un entorno para detectIntent, streamingDetectIntent, matchIntent y las llamadas REST a entidades de sesión, modifica la URL mediante la inserción de environments/environment-id entre los parámetros de ruta de acceso agent y sessions.

Por ejemplo, la siguiente URL usa el ID de entorno 6db409d7-57ac-41d7-83bd-89b8768e2745:

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

Especifica las versiones de flujo para las llamadas de sesión

Con el simulador de la consola o la API, puedes especificar un conjunto de versiones de flujo cuando realizas llamadas a la sesión del entorno de ejecución. No es necesario hacer referencia a las versiones de flujo seleccionadas en ningún entorno.

Console

Cuando uses el simulador de la consola, selecciona la opción Agente de prueba con versiones específicas de flujo y, luego, selecciona las versiones del flujo.

API

Si quieres especificar versiones de flujo para detectIntent, streamingDetectIntent, matchIntent y llamadas a REST de entidad de sesión, proporciona las versiones de flujo elegidas en el campo query_parameters.flow_versions de la solicitud.