Agentes y versiones
Configure el agente, guarde una versión y publíquela. Una versión no cambia una vez guardada, y cada ejecución congela sus permisos y sus habilidades al empezar.
La configuración
Un agente lleva cinco grupos de ajustes.
- Instrucciones: el prompt de sistema y, opcionalmente, un JSON Schema que la respuesta debe cumplir. Una respuesta que no lo valida vuelve al modelo, hasta 3 veces, y la ejecución falla si sigue sin validarlo.
- Modelos: el modelo principal, los modelos de respaldo, los parámetros de muestreo (temperatura, top-p, tokens máximos) y el esfuerzo de razonamiento. Un parámetro que el modelo elegido no acepta, según el registro, se rechaza al guardar, y solo se ofrecen los esfuerzos de razonamiento que el modelo publica.
- Guardarraíles: las reglas de entrada, de salida y de alcance que el worker aplica alrededor del modelo, y los límites de gasto de una ejecución: un límite de coste, 1 USD por defecto, y un límite de tokens opcional, que cubren ambos a los subagentes. Consulte Guardarraíles y Presupuestos y cuotas.
- Capacidades: la delegación en subagentes, con su modelo, su profundidad y sus herramientas bloqueadas, y los tipos de adjuntos que acepta el agente, dentro de lo que permite la instancia.
- Permisos: las colecciones que puede consultar, las herramientas y servidores MCP que puede llamar, los secretos que usan sus herramientas y las habilidades que puede cargar.
Los cuatro primeros grupos forman una versión. Los permisos pertenecen al propio agente: un cambio se aplica a las ejecuciones creadas después, sea cual sea la versión que ejecuten.
Versiones y publicación
Save a version (guardar una versión) escribe la configuración en una versión nueva, con su autor, su fecha y una nota de cambio. Las versiones son inmutables, y la base de datos rechaza cualquier modificación. Guardar una configuración idéntica a la actual no crea nada. Restore (restaurar) crea una versión nueva cuyo contenido es una copia de otra más antigua, de modo que el historial sigue siendo una línea recta.
Publish… (publicar) abre la lista de versiones: elija una y despliéguela en el entorno Test o Production, en todas las superficies activas de ese entorno a la vez (widget, API, Slack). Publicar una versión más antigua es la forma de volver atrás, y no crea ninguna versión nueva. Con los controles de publicación, un módulo Enterprise, el despliegue en Production puede exigir antes que pasen las suites de pruebas del agente. Guardar, restaurar y publicar quedan anotados en el registro de auditoría.
Ejecutar
Una ejecución fija su versión y congela sus permisos al crearse. El motor registra cada paso como un evento solo de adición con una clave de idempotencia, así que una caída seguida de una reejecución produce el mismo resultado, sin efecto secundario duplicado.
Una habilidad no se copia dentro de la versión del agente. Al crearse una ejecución, cada habilidad concedida al agente se resuelve en su versión actual, y sus instrucciones y sus capacidades se congelan en los permisos de la ejecución. Publicar una versión nueva de una habilidad cambia, por tanto, las próximas ejecuciones de todos los agentes que la tienen concedida, aunque su versión no haya cambiado. Una ejecución en curso conserva lo que tenía al empezar.
Una ejecución que tiene que esperar entra en reposo y no retiene ningún worker mientras espera: a sus subagentes, a que termine la ventana de límite de tasa de un proveedor, a la respuesta del visitante a una pregunta, o a la decisión de una persona cuando se usa el módulo Enterprise de aprobación humana. Se retoma cuando llega lo que espera.