Documentação / Colaboração e integrações
Jira, Jenkins, CloudBees e Minhas tarefas
Seus tickets, seus pipelines e suas implantações dentro do IDE. O agente lê o que precisa e cada escrita aguarda a sua aprovação.
O Yuli conecta o IDE ao Jira, ao Jenkins e ao CloudBees CD/RO. Você vê seus tickets, seus builds e suas implantações sem sair do editor, e o agente os usa como ferramentas: ele pode ler livremente, mas tudo o que altera algo aguarda a sua aprovação.
Onde configurar
| Serviço | Onde |
|---|---|
| Jira | Uma entrada em Servidores MCP. |
| Jenkins | Uma entrada em Servidores MCP para o agente, e em Conexões de CI para ver os pipelines. |
| CloudBees CD/RO | Conexões de CI, com um token de API ou com o seu usuário e senha (usados apenas para leitura). |
| Configurações do projeto | .ai/devops.json: formato das branches, job do Jenkins e escopo do CloudBees. |
Conexões de CI reúne Jenkins, GitLab CI, GitHub Actions e CloudBees. As credenciais vão para o chaveiro do sistema.
Jira
O Yuli trabalha com o Jira Cloud (e-mail e token de API) e o Data Center (Personal Access Token).
| Ferramenta | O que faz | Aprovação |
|---|---|---|
jira.search_issues |
Busca tickets. | Não |
jira.get_issue |
Lê um ticket. | Não |
jira.list_projects |
Lista projetos. | Não |
jira.list_boards |
Lista quadros. | Não |
jira.list_sprints |
Lista sprints. | Não |
jira.list_transitions |
Lista os status para os quais um ticket pode passar. | Não |
jira.create_issue |
Cria um ticket. | Sim |
jira.update_issue |
Modifica um ticket. | Sim |
jira.transition_issue |
Altera o status de um ticket. | Sim |
jira.add_comment |
Comenta em um ticket. | Sim |
jira.attach_branch |
Associa uma branch a um ticket. | Sim |
Quando o agente associa uma branch sem indicar o projeto, o Yuli usa o projeto em que o agente está trabalhando.
Uma branch a partir de um ticket
No painel do Git, Meus tickets do Jira lista os seus tickets. Criar branch a partir do ticket cria a branch com o formato do projeto e oferece mover o ticket para o status em andamento.
O formato é definido em .ai/devops.json, que é versionado com a equipe:
{
"branchFormat": "{prefix}/{key}-{slug}",
"typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
"defaultPrefix": "feature",
"maxSlugLength": 40
}| Marcador | É substituído por |
|---|---|
{prefix} |
O prefixo conforme o tipo do ticket (bugfix para um bug, hotfix para um incidente; feature para o restante). |
{key} |
A chave do ticket, por exemplo PAY-214. |
{slug} |
O título do ticket em minúsculas e com hifens. |
{type} |
O tipo do ticket. |
{project} |
O projeto do Jira. |
Com o formato padrão, a história PAY-214 «Validar valor» gera a branch feature/PAY-214-validar-valor. O slug remove acentos e sinais: «Adicionar login com SSO (Azure)» fica adicionar-login-com-sso-azure.
Jenkins
| Ferramenta | O que faz | Aprovação |
|---|---|---|
jenkins.list_jobs |
Lista os jobs. | Não |
jenkins.get_job |
Lê um job. | Não |
jenkins.get_build |
Lê um build. | Não |
jenkins.get_console_log |
Lê o console de um build. | Não |
jenkins.get_queue |
Lê a fila. | Não |
jenkins.trigger_build |
Dispara um build. | Sim |
Peça ao agente, por exemplo: «Por que o último build desta branch falhou?». Ele vai ler o console e dizer a causa.
CloudBees CD/RO
O agente tem uma única ferramenta somente leitura, cloudbees. Com ela, ele vê as execuções dos pipelines com suas etapas e tarefas, os jobs (passos, erros e logs), a configuração (com os segredos mascarados) e os pods do workload do Kubernetes do projeto.
O escopo é o que você configurou em .ai/devops.json → cloudbees: os pipelines, ambientes e workload do seu projeto. O agente não pode disparar, aprovar nem alterar nada: ele diz o que você deve fazer.
No IDE, você vê isso em Implantações (CloudBees).
Minhas tarefas
Minhas tarefas reúne em uma lista os seus tickets do Jira, as issues da sua forja e os seus pull requests ou merge requests (GitHub, GitLab, Bitbucket e Azure). Abra com o comando Minhas tarefas (grupo Git) ou pela barra de status, em Tarefa da branch:.
| Filtro | Opções |
|---|---|
| Escopo | Meus no sprint, Sprint ativo (equipe) |
| Origem | Tudo, Issues, Pull requests |
| Ação | O que faz |
|---|---|
| Começar | Cria a branch da tarefa e, se você quiser, move o ticket. |
| Mudar para a branch | Muda para a branch dessa tarefa. |
Se você não tiver nada conectado, Minhas tarefas pede para conectar o Jira (em Servidores MCP) ou uma conta do GitHub ou do GitLab.
Veja também Git e CI/CD e O Yuli como servidor MCP.