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:
{
"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.