Versiones y entornos

Puedes crear varias versiones de tus flujos de agentes y guías (también conocidas como agentes de Vertex AI) y, luego, implementarlos en entornos de entrega separados.

Cuando editas un flujo o una guía de planificación, lo que se modifica es el borrador. Puedes guardar el borrador como una versión en cualquier momento. Una versión es una instantánea inmutable de tus datos de flujo o guía y los datos de agentes asociados. Para los flujos, esto incluye intents, entidades, webhooks, páginas y grupos de rutas. Para las guías, esto incluye solo ejemplos.

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

• pruebas
• desarrollo
• producción

Además, puedes crear Webhooks específicos del entorno para poder aislar el entorno de producción de 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 del equipo realiza un cambio. Es posible romper un borrador accidentalmente, especialmente si varias personas tienen acceso de escritura al agente. Además, un borrador editado recientemente pueden ser inconsistentes con el modelo entrenado, porque el entrenamiento puede tener un retraso 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 realices actualizaciones en tu agente, a menudo tiene actualizaciones interdependientes en el código de su webhook. Durante el desarrollo y las pruebas de estos cambios, quieres hacer lo siguiente:

• Para probar las actualizaciones del agente en las actualizaciones de código de webhook.
• Para evitar que se implemente el código de webhook en la producción hasta que hayas completado las pruebas.

Usando Webhooks específicos del entorno logra ambos objetivos.

Considera los 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 generen errores de agente en algunas sesiones activas. Estos errores pueden ocurrir si la versión nueva y la anterior son incoherentes entre sí de una manera que altere el estado de la sesión. Debido a esto, deberías planificar cambiar versiones durante con baja y otras 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. Esta función aún no está disponible para los libros de jugadas.

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

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 (Version History).
6. Haz clic en Ver historial de versiones.
7. Las versiones se enumeran para la guía 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 la 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 la fila de una 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 las versiones de flujo

Nota: La comparación de versiones está limitada por un tamaño de respuesta de 2 MB. Usa el método de la API 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 las guías. Sigue estos pasos para comparar versiones:

Console

1. Mantén el puntero sobre la fila de una 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 las versiones del flujo y de la guía, y configurar un entorno, hacer clic en un entorno y proporcionar 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 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
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 el agente en el entorno Luego, selecciona un entorno.

API

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

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

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 llamadas de sesión

Usando simulador de consola o la API, puedes especificar un conjunto de versiones de flujo cuando haces llamadas a sesiones de entorno de ejecución. No es necesario que las versiones de flujo seleccionadas al que se hace referencia en cualquier 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 versiones de flujo para detectIntent, streamingDetectIntent, matchIntent y llamadas REST a la entidad de sesión proporcionar las versiones de flujo elegidas en el archivo query_parameters.flow_versions de la solicitud.