Documentación / Colaboración e integraciones

Jira, Jenkins, CloudBees y Mis tareas

Tus tickets, tus pipelines y tus despliegues dentro del IDE. El agente lee lo que necesita y cada escritura espera tu aprobación.

Yuli conecta el IDE con Jira, Jenkins y CloudBees CD/RO. Tú ves tus tickets, tus builds y tus despliegues sin salir del editor, y el agente los usa como herramientas: puede leer libremente, pero todo lo que cambia algo espera tu aprobación.

Dónde se configura

Servicio Dónde
Jira Una entrada en Servidores MCP.
Jenkins Una entrada en Servidores MCP para el agente, y en Conexiones CI para ver los pipelines.
CloudBees CD/RO Conexiones CI, con un token de API o tu usuario y contraseña (solo se usan para leer).
Ajustes del proyecto .ai/devops.json: formato de las ramas, job de Jenkins y alcance de CloudBees.

Conexiones CI reúne Jenkins, GitLab CI, GitHub Actions y CloudBees. Las credenciales van al llavero del sistema.

Jira

Yuli trabaja con Jira Cloud (correo y token de API) y Data Center (Personal Access Token).

Herramienta Qué hace Aprobación
jira.search_issues Busca tickets. No
jira.get_issue Lee un ticket. No
jira.list_projects Lista proyectos. No
jira.list_boards Lista tableros. No
jira.list_sprints Lista sprints. No
jira.list_transitions Lista los estados a los que puede pasar un ticket. No
jira.create_issue Crea un ticket. Sí
jira.update_issue Modifica un ticket. Sí
jira.transition_issue Cambia el estado de un ticket. Sí
jira.add_comment Comenta un ticket. Sí
jira.attach_branch Asocia una rama a un ticket. Sí

Cuando el agente asocia una rama sin indicar el proyecto, Yuli usa el proyecto en el que está trabajando el agente.

Una rama desde un ticket

En el panel de Git, Mis tickets de Jira lista tus tickets. Crear rama desde ticket crea la rama con el formato del proyecto y te ofrece mover el ticket al estado en curso.

El formato se define en .ai/devops.json, que se versiona con el equipo:

json
{
  "branchFormat": "{prefix}/{key}-{slug}",
  "typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
  "defaultPrefix": "feature",
  "maxSlugLength": 40
}
Marcador Se reemplaza por
{prefix} El prefijo según el tipo del ticket (bugfix para un bug, hotfix para un incidente; feature para el resto).
{key} La clave del ticket, por ejemplo PAY-214.
{slug} El título del ticket en minúsculas y con guiones.
{type} El tipo del ticket.
{project} El proyecto de Jira.

Con el formato por defecto, la historia PAY-214 «Validar importe» da la rama feature/PAY-214-validar-importe. El slug quita tildes y signos: «Añadir inicio de sesión con SSO (Azure)» queda anadir-inicio-de-sesion-con-sso-azure.

Jenkins

Herramienta Qué hace Aprobación
jenkins.list_jobs Lista los jobs. No
jenkins.get_job Lee un job. No
jenkins.get_build Lee un build. No
jenkins.get_console_log Lee la consola de un build. No
jenkins.get_queue Lee la cola. No
jenkins.trigger_build Lanza un build. Sí

Pídele al agente, por ejemplo: «¿Por qué falló el último build de esta rama?». Leerá la consola y te dirá la causa.

CloudBees CD/RO

El agente tiene una sola herramienta de solo lectura, cloudbees. Con ella ve las ejecuciones de los pipelines con sus etapas y tareas, los jobs (pasos, errores y logs), la configuración (con los secretos enmascarados) y los pods del workload de Kubernetes del proyecto.

El alcance es el que configuraste en .ai/devops.json → cloudbees: los pipelines, entornos y workload de tu proyecto. El agente no puede lanzar, aprobar ni cambiar nada: te dice qué hacer.

En el IDE lo ves en Despliegues (CloudBees).

Mis tareas

Mis tareas reúne en una lista tus tickets de Jira, los issues de tu forja y tus pull requests o merge requests (GitHub, GitLab, Bitbucket y Azure). Ábrelo con el comando Mis tareas (grupo Git) o desde la barra de estado, en Tarea de la rama:.

Filtro Opciones
Alcance Míos en el sprint, Sprint activo (equipo)
Origen Todo, Issues, Pull requests
Acción Qué hace
Empezar Crea la rama de la tarea y, si quieres, mueve el ticket.
Cambiar a su rama Cambia a la rama de esa tarea.

Si no tienes nada conectado, Mis tareas te pide conectar Jira (en Servidores MCP) o una cuenta de GitHub o GitLab.

Ver también Git y CI/CD y Yuli como servidor MCP.