Trabajar con versiones de agentes y herramientas
Cuando se crean o mantienen agentes y herramientas en watsonx Orchestrate, disponer de un sistema de control de versiones claro y coherente te ayuda a trabajar de forma segura y eficiente. El control de versiones le ofrece la flexibilidad necesaria para probar cambios, reutilizar configuraciones probadas y mantener la estabilidad en todos los entornos.
¿Por qué es importante el control de versiones?
Sin control de versiones, cada actualización que realice en un agente o una herramienta afecta inmediatamente a los usuarios. Esto plantea varios retos en un flujo de trabajo de desarrollo:
Todos los usuarios se ven afectados instantáneamente por las actualizaciones. Cuando se mejora o se corrige algo, el cambio afecta a todos los usuarios y se aplica de inmediato, lo que genera riesgos durante las mejoras.
No se pueden mantener varias versiones estables. Sin una estructura de versiones definida, no es posible conservar una configuración conocida y válida mientras se experimenta con mejoras o se crean nuevas funciones.
Pierdes acceso a las versiones anteriores. Cada actualización sobrescribe la versión anterior, eliminando la posibilidad de hacer referencia, clonar o restaurar estados anteriores.
El control de versiones resuelve estas limitaciones al proporcionarle visibilidad, control y flexibilidad a lo largo de todo el ciclo de vida del desarrollo.
Comprender las versiones de los agentes
Una versión es una instantánea de su agente y sus componentes relacionados en un momento específico. Las versiones te ayudan a conservar las configuraciones, realizar un seguimiento de los cambios y mantener diferentes iteraciones de tu agente. Cuando implementas un agente, estás haciendo que una versión específica esté disponible en el entorno de producción en vivo.
¿Qué incluye una versión?
Los siguientes componentes se capturan en la instantánea de la versión:
Categoría | Elemento de configuración |
|---|---|
Configuración del agente | Nombre de agente |
Modelo | |
Perfil | |
Descripción | |
Mensaje de bienvenida | |
Mensaje de inicio rápido | |
Estilo de agente | |
Modalidad de voz | |
Conjunto de herramientas | Herramientas |
Agentes colaboradores | |
Comportamiento | Instrucciones |
Directrices | |
Configuración del chat con los médicos |
¿Qué no se incluye en una versión?
Los siguientes componentes se gestionan independientemente de las versiones del agente y no se capturan en las instantáneas de versión:
Canales y configuraciones de canales
Conexiones
Conocimientos
Resultados de las pruebas y evaluaciones
Los cambios en los componentes anteriores afectan a todas las versiones de los agentes que hacen referencia a ellos.
Comportamiento de la versión
Comprender cómo funciona el control de versiones en watsonx Orchestrate te ayuda a mantener implementaciones en producción predecibles y estables:
Las versiones son inmutables
Una vez creada, una versión captura una instantánea de todos los componentes incluidos. Los cambios en esos componentes no afectan a las versiones existentes, excepto en el caso de los componentes que no tienen versión, como los canales, las conexiones y las bases de datos de conocimientos de terceros.
Las nuevas versiones reflejan la situación actual
Al crear una nueva versión, se captura el estado actual de todos los componentes, incluidos los cambios realizados desde la última versión.
Duplicar versiones
Si duplicas una versión, la copia comienza como una réplica de la instantánea de la versión original. A continuación, puede modificar el duplicado sin afectar al original.
Los componentes del catálogo están sujetos a control de versiones
Los agentes y las herramientas del catálogo tienen su propio control de versiones. La instantánea de su versión incluye la versión específica que seleccionó al añadir estos componentes a su agente.
Este enfoque de control de versiones ayuda a garantizar:
Versiones predecibles y estables para producción.
Iteración segura en borrador sin actualizar involuntariamente las versiones activas.
Creación intencionada de una versión cuando esté listo para capturar los cambios.
Añadir versiones específicas de agentes y herramientas del catálogo
Dependiendo de su flujo de trabajo, puede optar por utilizar una versión específica al añadir herramientas a un agente o al crear un nuevo agente. La selección de la versión garantiza la coherencia y preserva la compatibilidad, lo que resulta especialmente útil cuando se desea desarrollar funciones de forma incremental o mantener un comportamiento predecible en todos los entornos.
Añadir una versión específica de una herramienta a un agente
En ocasiones, es posible que desee adjuntar una versión concreta de una herramienta a su agente. Para seguir utilizando una versión validada o para preservar la compatibilidad.
Para añadir una versión específica de la herramienta:
En el menú principal, ve a «Build ».
Abre el agente que deseas configurar
Seleccionar Conjunto de herramientas > Añadir herramienta
Elija una herramienta del catálogo o cualquier otra fuente disponible.
Abre Ver versiones recientes para ver las versiones disponibles de la herramienta.
Seleccione la versión que desee y añádala al agente.
Tu agente ahora utiliza la versión exacta de la herramienta que seleccionaste.
Utilizar una versión anterior como plantilla
Si desea crear un nuevo agente basado en una versión anterior de un agente existente, puede utilizar esa versión anterior como plantilla. Esto resulta útil cuando:
Una versión anterior contiene lógica que desea reutilizar.
Quieres bifurcar el desarrollo sin modificar la versión actual.
Se necesita una base estable para realizar pruebas o experimentos.
Para crear un agente a partir de una versión anterior:
Abre el agente desde el catálogo.
Seleccionar versión > Ver versiones recientes.
Seleccione la versión que desee.
Haga clic en Usar como plantilla.
Se crea una nueva configuración de agente basada en la versión seleccionada. Puedes modificarlo e implementarlo independientemente del original.