Belgeler / İşbirliği ve entegrasyonlar

Jira, Jenkins, CloudBees ve Görevlerim

Ticket'larınız, pipeline'larınız ve dağıtımlarınız IDE'nin içinde. Ajan ihtiyacı olanı okur ve her yazma işlemi onayınızı bekler.

Yuli, IDE'yi Jira, Jenkins ve CloudBees CD/RO ile bağlar. Ticket'larınızı, build'lerinizi ve dağıtımlarınızı düzenleyiciden çıkmadan görürsünüz; ajan da bunları araç olarak kullanır: serbestçe okuyabilir, ancak bir şeyi değiştiren her işlem onayınızı bekler.

Nerede yapılandırılır

Hizmet Nerede
Jira MCP sunucuları içinde bir kayıt.
Jenkins Ajan için MCP sunucuları içinde bir kayıt; pipeline'ları görmek için CI bağlantıları içinde.
CloudBees CD/RO CI bağlantıları; bir API token'ı veya kullanıcı adınız ve parolanızla (yalnızca okumak için kullanılır).
Proje ayarları .ai/devops.json: dal biçimi, Jenkins job'ı ve CloudBees kapsamı.

CI bağlantıları Jenkins, GitLab CI, GitHub Actions ve CloudBees'i bir araya getirir. Kimlik bilgileri sistem anahtarlığında saklanır.

Jira

Yuli, Jira Cloud (e-posta ve API token'ı) ve Data Center (Personal Access Token) ile çalışır.

Araç Ne yapar Onay
jira.search_issues Ticket arar. Hayır
jira.get_issue Bir ticket'ı okur. Hayır
jira.list_projects Projeleri listeler. Hayır
jira.list_boards Panoları listeler. Hayır
jira.list_sprints Sprint'leri listeler. Hayır
jira.list_transitions Bir ticket'ın geçebileceği durumları listeler. Hayır
jira.create_issue Bir ticket oluşturur. Evet
jira.update_issue Bir ticket'ı değiştirir. Evet
jira.transition_issue Bir ticket'ın durumunu değiştirir. Evet
jira.add_comment Bir ticket'a yorum ekler. Evet
jira.attach_branch Bir dalı bir ticket ile ilişkilendirir. Evet

Ajan bir dalı proje belirtmeden ilişkilendirdiğinde Yuli, ajanın üzerinde çalıştığı projeyi kullanır.

Bir ticket'tan dal oluşturma

Git panelinde Jira ticket'larım ticket'larınızı listeler. Ticket'tan dal oluştur, dalı projenin biçimiyle oluşturur ve ticket'ı devam eden durumuna taşımayı önerir.

Biçim, ekiple birlikte sürümlenen .ai/devops.json dosyasında tanımlanır:

json
{
  "branchFormat": "{prefix}/{key}-{slug}",
  "typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
  "defaultPrefix": "feature",
  "maxSlugLength": 40
}
Yer tutucu Yerine gelen
{prefix} Ticket türüne göre ön ek (hata için bugfix, olay için hotfix; geri kalanı için feature).
{key} Ticket anahtarı, örneğin PAY-214.
{slug} Ticket başlığının küçük harfli ve tireli hali.
{type} Ticket türü.
{project} Jira projesi.

Varsayılan biçimle, «Validar importe» başlıklı PAY-214 hikâyesi feature/PAY-214-validar-importe dalını verir. Slug, aksanları ve işaretleri kaldırır: «Añadir inicio de sesión con SSO (Azure)» başlığı anadir-inicio-de-sesion-con-sso-azure olur.

Jenkins

Araç Ne yapar Onay
jenkins.list_jobs Job'ları listeler. Hayır
jenkins.get_job Bir job'ı okur. Hayır
jenkins.get_build Bir build'i okur. Hayır
jenkins.get_console_log Bir build'in konsolunu okur. Hayır
jenkins.get_queue Kuyruğu okur. Hayır
jenkins.trigger_build Bir build başlatır. Evet

Ajandan örneğin şunu isteyin: «Bu dalın son build'i neden başarısız oldu?». Konsolu okur ve size nedenini söyler.

CloudBees CD/RO

Ajanın salt okunur tek bir aracı vardır: cloudbees. Bu araçla pipeline çalıştırmalarını aşamaları ve görevleriyle, job'ları (adımlar, hatalar ve loglar), yapılandırmayı (gizli bilgiler maskelenmiş olarak) ve projenin Kubernetes workload'ındaki pod'ları görür.

Kapsam, .ai/devops.json → cloudbees içinde yapılandırdığınız kapsamdır: projenizin pipeline'ları, ortamları ve workload'ı. Ajan hiçbir şeyi başlatamaz, onaylayamaz veya değiştiremez: size ne yapmanız gerektiğini söyler.

IDE'de bunu Dağıtımlar (CloudBees) içinde görürsünüz.

Görevlerim

Görevlerim, Jira ticket'larınızı, kod barındırma platformunuzdaki issue'ları ve pull request'lerinizi veya merge request'lerinizi (GitHub, GitLab, Bitbucket ve Azure) tek bir listede toplar. Görevlerim komutuyla (Git grubu) veya durum çubuğundaki Dalın görevi: alanından açın.

Filtre Seçenekler
Kapsam Sprint'teki benimkiler, Etkin sprint (ekip)
Kaynak Tümü, Issue'lar, Pull request'ler
Eylem Ne yapar
Başla Görevin dalını oluşturur ve isterseniz ticket'ı taşır.
Dalına geç O görevin dalına geçer.

Hiçbir şey bağlı değilse Görevlerim, Jira'yı (MCP sunucuları içinde) ya da bir GitHub veya GitLab hesabını bağlamanızı ister.

Ayrıca bkz. Git ve CI/CD ve MCP sunucusu olarak Yuli.