文档 / 协作与集成
Jira、Jenkins、CloudBees 与我的任务
在 IDE 中查看你的工单、流水线和部署。智能体会读取所需信息,而每一次写入都要等你批准。
Yuli 把 IDE 与 Jira、Jenkins 和 CloudBees CD/RO 连接起来。你无需离开编辑器就能查看自己的工单、构建和部署,智能体则把它们当作工具使用:它可以自由读取,但任何会改变内容的操作都要等你批准。
在哪里配置
| 服务 | 位置 |
|---|---|
| Jira | MCP 服务器 中的一个条目。 |
| Jenkins | MCP 服务器 中供智能体使用的一个条目,以及用于查看流水线的 CI 连接。 |
| CloudBees CD/RO | CI 连接,使用 API 令牌或你的用户名和密码(仅用于读取)。 |
| 项目设置 | .ai/devops.json:分支格式、Jenkins job 以及 CloudBees 的范围。 |
CI 连接 汇集了 Jenkins、GitLab CI、GitHub Actions 和 CloudBees。凭据保存在系统钥匙串中。
Jira
Yuli 支持 Jira Cloud(邮箱和 API 令牌)和 Data Center(Personal Access Token)。
| 工具 | 作用 | 需要批准 |
|---|---|---|
jira.search_issues |
搜索工单。 | 否 |
jira.get_issue |
读取工单。 | 否 |
jira.list_projects |
列出项目。 | 否 |
jira.list_boards |
列出看板。 | 否 |
jira.list_sprints |
列出 sprint。 | 否 |
jira.list_transitions |
列出工单可以转到的状态。 | 否 |
jira.create_issue |
创建工单。 | 是 |
jira.update_issue |
修改工单。 | 是 |
jira.transition_issue |
更改工单状态。 | 是 |
jira.add_comment |
评论工单。 | 是 |
jira.attach_branch |
把分支关联到工单。 | 是 |
当智能体关联分支却没有指定项目时,Yuli 会使用智能体当前正在处理的项目。
从工单创建分支
在 Git 面板中,我的 Jira 工单 会列出你的工单。从工单创建分支 会按项目的格式创建分支,并提议把工单移到进行中状态。
格式在 .ai/devops.json 中定义,并随团队一起纳入版本控制:
{
"branchFormat": "{prefix}/{key}-{slug}",
"typePrefixes": { "bug": "bugfix", "hotfix": "hotfix" },
"defaultPrefix": "feature",
"maxSlugLength": 40
}| 占位符 | 替换为 |
|---|---|
{prefix} |
根据工单类型确定的前缀(bug 为 bugfix,事故为 hotfix,其余为 feature)。 |
{key} |
工单的键,例如 PAY-214。 |
{slug} |
工单标题,转为小写并用连字符连接。 |
{type} |
工单类型。 |
{project} |
Jira 项目。 |
使用默认格式时,故事 PAY-214“Validar importe”会生成分支 feature/PAY-214-validar-importe。slug 会去掉重音和符号:“Añadir inicio de sesión con SSO (Azure)”会变成 anadir-inicio-de-sesion-con-sso-azure。
Jenkins
| 工具 | 作用 | 需要批准 |
|---|---|---|
jenkins.list_jobs |
列出 job。 | 否 |
jenkins.get_job |
读取 job。 | 否 |
jenkins.get_build |
读取构建。 | 否 |
jenkins.get_console_log |
读取构建的控制台输出。 | 否 |
jenkins.get_queue |
读取队列。 | 否 |
jenkins.trigger_build |
触发构建。 | 是 |
例如,你可以问智能体:“这个分支最近一次构建为什么失败?”。它会读取控制台输出并告诉你原因。
CloudBees CD/RO
智能体只有 一个只读工具:cloudbees。借助它,智能体可以查看流水线的运行及其阶段和任务、job(步骤、错误和日志)、配置(机密已遮蔽),以及项目 Kubernetes workload 的 pod。
范围就是你在 .ai/devops.json → cloudbees 中配置的内容:你项目的流水线、环境和 workload。智能体 不能触发、批准或更改任何东西:它只会告诉你该怎么做。
在 IDE 中,你可以在 部署(CloudBees) 中查看。
我的任务
我的任务 把你的 Jira 工单、代码托管平台上的 issue 以及你的 pull request 或 merge request(GitHub、GitLab、Bitbucket 和 Azure)汇集到一个列表中。通过命令 我的任务(Git 组)打开,或在状态栏的 分支任务: 处打开。
| 筛选 | 选项 |
|---|---|
| 范围 | 我在本 sprint 的、当前 sprint(团队) |
| 来源 | 全部、Issues、Pull requests |
| 操作 | 作用 |
|---|---|
| 开始 | 创建该任务的分支,并可选择移动工单。 |
| 切换到其分支 | 切换到该任务的分支。 |
如果你还没有连接任何服务,我的任务会提示你连接 Jira(在 MCP 服务器中)或 GitHub、GitLab 账户。
另请参阅 Git 与 CI/CD和作为 MCP 服务器的 Yuli。