Paquetes de configuración
Un paquete de configuración es una instantánea versionada e inmutable de la configuración dinámica del agente: indicaciones del sistema, identificadores de modelos, descripciones de herramientas y cualquier otro par clave-valor que el agente lea en tiempo de ejecución. Los paquetes desvinculan el comportamiento del agente del código, lo que le permite cambiar la forma en que responde el agente sin tener que volver a implementar el código.
Conceptos clave
-
Los componentes se codifican mediante el ARN del AgentCore recurso que configuran (por ejemplo, un ARN en tiempo de ejecución). Cada componente contiene un
configurationobjeto con pares clave-valor arbitrarios. -
Las versiones son inmutables. Cada actualización crea una nueva versión con un UUID único. Las versiones forman una cadena a través de las confirmaciones
parentVersionIds, similar a las confirmaciones de git. -
Las ramas organizan el linaje de versiones (por ejemplo,
mainline,experiment-1). -
Los nombres de los paquetes deben empezar por una letra y pueden contener letras, dígitos y guiones bajos (sin guiones). Patrón:.
[a-zA-Z][a-zA-Z0-9_]{0,99}
Cuándo usar los paquetes de configuración
-
A/B probando. Cada variante de una A/B prueba hace referencia a una versión de paquete específica. La puerta de enlace inyecta la referencia del paquete en cada solicitud.
-
Recomendaciones. La API de recomendaciones puede leer la configuración actual de un paquete y escribir la configuración optimizada como una nueva versión del paquete.
-
Reversión. Como las versiones son inmutables, puedes volver a cualquier versión anterior haciendo referencia a su ID de versión.
-
Registro de auditoría. La cadena de versiones proporciona un historial completo de los cambios de configuración.