Configuraciones de ejecución para agentes y aprobaciones

Los agentes nunca reciben tus credenciales de Jenkins y nunca ven tu servidor completo. Solo pueden solicitar las configuraciones de ejecución que creas en AI Agents → Run Configurations — y tú decides cuánta libertad concede cada una.

Crear una configuración

Una configuración reúne:

• Una pipeline de Jenkins — un job, o un proyecto multibranch combinado con una regla de rama (ver abajo).
• Un nombre y una clave — la clave (p. ej. metatarif-deploy-dev) es el ID que usan los agentes.
• Un repositorio Git — por defecto, una configuración está restringida a un repositorio: los agentes solo la ven mientras trabajan en un checkout cuyo origin coincide. Desactiva "Restrict to a Git repository" para que esté disponible en cualquier parte (entonces la configuración pasa a requerir aprobación por defecto).
• Modo de aprobación — ejecutar automáticamente o preguntarte primero.

Pipelines multibranch

Para un proyecto multibranch seleccionas el propio proyecto y controlas la rama por separado, igual que un parámetro:

• Fija — elige una rama entre las ramas actuales del proyecto; los agentes siempre construyen esa rama.
• Elegible por el agente — proporciona una expresión regular de coincidencia completa como main|develop o feature/.+; el agente indica la rama mediante la entrada branch, y solo pueden construirse ramas que coincidan y existan en Jenkins.

Cuando el agente elige, la lista de parámetros de abajo se lee de la rama por defecto del proyecto. En cada solicitud, BuildCaptain compara los parámetros de la rama elegida con la configuración y rechaza la solicitud si difieren — una rama con un Jenkinsfile divergente no puede saltarse tus reglas.

Reglas de parámetros

Cada parámetro de build es o bien fijo (tú estableces el valor; el agente no puede cambiarlo) o bien elegible por el agente dentro de los límites que definas:

• Parámetros choice: marca cuáles de las opciones del job están permitidas.
• Parámetros string: lista los valores permitidos o proporciona una expresión regular de coincidencia completa.
• Booleanos: el agente puede elegir true o false.
• Los parámetros de texto libre y de contraseña nunca pueden ser elegidos por el agente.

BuildCaptain además calcula una huella del esquema de parámetros del job: si los parámetros del job de Jenkins cambian, la configuración deja de coincidir hasta que la revises — un agente nunca puede aprovechar un formulario desactualizado.

El flujo de aprobación

Cuando una configuración requiere aprobación, la solicitud del agente aparece al principio de la página Activity (y como notificación), indicando quién la pidió, desde qué repositorio y rama, y con qué entradas. Aprueba o rechaza con un clic. Las solicitudes caducan automáticamente a los 10 minutos.

El registro de auditoría

Cada operación de agente — solicitada, aprobada, rechazada, en cola, en ejecución, completada, fallida — se conserva en el Agent Run History de la página Activity, con el solicitante, el repositorio y las entradas.

Configuración para agentes

Los agentes se conectan a través de la CLI de código abierto — consulta Instalar la CLI de BuildCaptain.