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:

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