Versiones y entornos

Puedes crear varias versiones de tus flujos de agentes y libros de jugadas (también conocidos como agentes de Vertex AI) y, luego, implementarlas en entornos de entrega separados.

Cuando editas un flujo o una guía de planificación, lo que se modifica es 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 o libro de jugadas y los datos de los agentes asociados. En el caso de los flujos, esto incluye los intents, las entidades, los webhooks, las páginas y los grupos de rutas. En el caso de las guías, solo se incluyen 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

Usa siempre 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 ascenderlos 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 en 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 lo siguiente:

• Para probar las actualizaciones del agente en función de las actualizaciones del código del webhook.
• Para evitar implementar el código de tu webhook en producción hasta que hayas completado las pruebas.

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

Considera posibles errores del agente cuando cambies de versión

Si cambias una versión 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 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.

Carga una versión como 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 de la guía como borrador, se reemplazará la guía existente en el borrador y sus ejemplos.

Administra versiones

Para administrar tus versiones, sigue estos pasos:

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 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 libro de jugadas, haz lo siguiente:

1. Abre la consola de Dialogflow CX.
2. Elige tu proyecto de Google Cloud.
3. Selecciona el agente.
4. Selecciona la guía
5. Haz clic en Historial de versiones.
6. Haz clic en Ver historial de versiones.
7. Se enumeran las versiones del libro de jugadas seleccionado.

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.

Compara versiones de flujo

Nota: Comparar versiones tiene un límite de 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 proyecto de Google Cloud.
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 flujo y de la guía de instrucciones, 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 consola o la API, puedes especificar un entorno cuando realices llamadas a la sesión del entorno 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 Probar agente en el entorno y, luego, selecciona un entorno.

API

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

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 las 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 a la 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 agente con versiones de flujo específicas y, luego, selecciona las versiones de flujo.

API

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