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:
- 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 (Version History).
- Haz clic en Ver historial de versiones.
- 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:
- Mantén el puntero sobre la fila de una 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 |
Compara las 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 las guías. Sigue estos pasos para comparar versiones:
Console
- Mantén el puntero sobre la fila de una 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 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 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 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 |
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.