Versiones y entornos

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

Cuando editas un flujo, una guía o una herramienta, editas el borrador. En cualquier momento, puedes guardar el borrador como una versión. Una versión es una instantánea inmutable de los datos de tu flujo, guía o herramienta, y de los datos del agente asociados. En el caso de los flujos, esto incluye intents, entidades, webhooks, páginas y grupos de rutas. En el caso de las guías, esto incluye solo ejemplos.

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

• pruebas
• desarrollo
• producción

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

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

Siempre usa versiones para el tráfico de producción

Se actualiza un borrador cada vez que un desarrollador de tu equipo realiza un cambio. Es posible interrumpir un borrador de forma involuntaria, en especial 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 una demora 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 ascender a versiones de producción, y puedes revertir a una versión anterior si se detectan problemas.

Siempre usa webhooks específicos del entorno

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

• Probar las actualizaciones del agente en comparación con las actualizaciones del código del webhook
• Para evitar implementar el código de webhook en producción hasta que completes las pruebas

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

Considera 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 ocurrir si las versiones anterior y nueva son incoherentes entre sí de una manera que interrumpe el estado de la sesión. Por lo tanto, debes planificar el cambio de versiones durante el tiempo de inactividad o las horas de baja actividad.

Carga una versión en borrador

En cualquier momento, puedes cargar una versión 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.

Del mismo modo, si restableces una versión del playbook como borrador, se reemplazará el playbook existente en el borrador y sus ejemplos. Además, si restableces una herramienta, se reemplazará la herramienta existente en el borrador.

Administrar versiones

Para administrar tus versiones, 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 Google Cloud proyecto.
3. Selecciona el agente.
4. Haz clic en la pestaña Recursos compartidos.
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.

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

1. Abre la consola de Dialogflow CX.
2. Elige tu Google Cloud proyecto.
3. Selecciona el agente.
4. Selecciona el playbook
5. Haz clic en Historial de versiones.
6. Haz clic en Ver historial de versiones.
7. Se enumeran las versiones del plan de acción seleccionado.

Para enumerar las versiones actuales de una herramienta, haz lo siguiente:

1. Abre la consola de Dialogflow CX.
2. Elige tu Google Cloud proyecto.
3. Selecciona el agente.
4. Selecciona la herramienta
5. Haz clic en Historial de versiones.
6. Haz clic en Ver historial de versiones.
7. Se enumeran las versiones de la herramienta seleccionada.

Se muestra la siguiente información para cada recurso:

• 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 versión nueva, 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 los recursos a nivel del agente se reemplazan cuando se restablece un flujo como flujo de borrador.

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

Cómo comparar versiones de flujos

Nota: La función Comparar versiones está limitada por un tamaño de respuesta de 2 MB. 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. Esta función no está disponible para los libros de jugadas. 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 Google Cloud proyecto.
3. Selecciona el agente.
4. Haz clic en la pestaña Recursos compartidos.
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 de flujos, guías y herramientas, 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 del entorno	Recurso del entorno
RPC	Interfaz del entorno	Interfaz del 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
Ruby	No disponible	No disponible

Cerrar

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

Especifica el entorno para las llamadas de sesión

Con el simulador de la consola o la API, puedes especificar un entorno cuando realices llamadas a sesiones de ejecución. Si no se especifica un entorno, se usará el entorno predeterminado.

Console

Cuando uses el simulador de la consola, selecciona la opción Test agent in environment y, luego, selecciona un entorno.

API

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

Por ejemplo, la siguiente URL usa el ID del 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 versiones de flujo para las llamadas de sesión

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

Console

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

API

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