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 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 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 lo tanto, 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:
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Haz clic en la pestaña Recursos compartidos.
- Haz clic en Versiones.
- Se mostrará una lista de los flujos del agente. Selecciona una opción.
- Se enumeran las versiones del flujo seleccionado.
Para enumerar las versiones actuales de un libro de jugadas, haz lo siguiente:
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Selecciona la guía
- Haz clic en Historial de versiones.
- Haz clic en Ver historial de versiones.
- 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:
- Mantén el puntero sobre una fila de versión.
- Haz clic en el botón de opción more_vert.
- Haz clic en la opción Cargar como borrador.
- 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:
- Mantén el puntero sobre una fila de versión.
- Haz clic en el botón de opción more_vert.
- Haz clic en la opción Borrar versión.
API
Consulta los métodos para el tipo Version.
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 |
Comparar versiones de flujo
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
- Mantén el puntero sobre una fila de versión.
- Haz clic en el botón de opción more_vert.
- Haz clic en la opción Comparar versiones.
- Selecciona otra versión del flujo o flujo de borrador para la comparación.
- Se muestra una comparación en paralelo.
API
Consulta el método compareVersions para el tipo Version.
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 |
Administra entornos
Para administrar los entornos del agente, haz lo siguiente:
Console
Para enumerar los entornos actuales de un agente, haz lo siguiente:
- Abre la consola de Dialogflow CX.
- Elige tu proyecto de Google Cloud.
- Selecciona el agente.
- Haz clic en la pestaña Recursos compartidos.
- Haz clic en Entornos.
- 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 history 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 content_copy cerca del lado derecho de un entorno incluido en la lista.
Para borrar un entorno, haz clic en el botón de borrar delete cerca del lado derecho de un entorno incluido en la lista.
API
Consulta los métodos para el tipo Environment.
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 |
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 de tiempo 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 detectIntent, streamingDetectIntent, matchIntent y las llamadas REST 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.