将 DeliveryAI 与“Jira”连接，用于读取 Jira 空间信息、筛选器与任务数据，并通过服务账号保证后台服务可正常运行。 ## 前提条件 * 已具备 Jira 管理权限，可创建服务账号并获取服务账号凭据。 * 在 [AgentKit控制台](https://console.volcengine.com/agentkit) 中获取 DeliveryAI 平台提供的 **Webhook 地址**信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_faff62973e58a5c6289f85308e912d5c.png) ## 配置Jira平台 ### 步骤一：创建服务账号 1. 以管理员权限访问企业 Jira 服务地址（Jira Cloud 为例：`https://{example}.atlassian.net`）。 2. 单击页面右上角的图标，选择弹出框中的“Atlassian 管理设置 \> 用户管理”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3b4120d147e1858ae40160431c363bc9.png) 3. 单击左侧导航树的“服务账户”，在服务账户页面，单击页面右上角的“创建服务账户”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2b796cc70d1b909961f7cda66f099566.png) 4. 在“为服务账户命名”页签中，配置名称和描述信息，单击“下一步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d428d31a665e7c828bf073c80e7dfee5.png) 5. 在“选择应用角色”页签中，将“Jira”角色配置为“用户访问权限管理员”，“Projects”角色配置为“应用管理员”，并单击“创建”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d8933427a200594fd10a6f204bf5577e.png) 6. 在已创建的服务账户页面中，单击页面右上角的“创建凭据”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6eef1664b1ab91b1b1e3b0570ee68cf2.png) 7. 默认选择“OAuth 2.0”后，单击“下一步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_68cecd7a173059b37a990dc82cd0f10b.png) 8. 输入自定义OAuth 凭据名称，单击“下一步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3f2b6a1d09653d16431c5500c2756ae3.png) 9. 配置凭据的选择范围。 1. 在“App”筛选框中选择“Jira”、“Projects”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_264d2933da021abf576351ef1061eebd.png) 2. 在“Scope type”筛选框中选择“Classic”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c5fc9589f5313fda687f0d014218bdd1.png) 3. 在筛选结果列表中勾选“Scope name”列为以下的选项，单击“下一步”按钮。 * manage:jira\-configuration：用于导入 Jira 流程。 * manage:jira\-project：创建和编辑 Jira 项目设置，并创建新的项目级对象，例如版本和组件。 * read:jira\-user：查看当前用户有权限访问的 Jira 用户信息，包括用户名、邮箱地址和头像。 * read:jira\-work：读取 Jira 项目和问题数据，搜索问题，并读取与问题关联的对象，例如附件和工作日志。 * write:jira\-work：在 Jira 中创建和编辑问题，以当前用户身份发布评论、创建工作日志，并删除问题。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_df82297de04680cd3328f783e184fea0.png) 4. 在“创建凭据”页签，单击“创建”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_498cafa18c542cae58d49f82c429198d.png) 5. 复制并妥善保存**客户端 ID** 和**客户端密钥**，后续在 DeliveryAI 平台上配置企业集成时将用到，单击“完成”按钮。

注意

复制您的客户端 ID 和客户端密钥，并将它们保存在某个安全的位置。完成此步骤后，您将无法恢复它们。若意外退出，可再次创建新的凭据。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ebd5a0625ab89a4c8e5260abe2c70ced.png) ### 步骤二：将服务账号添加至 Jira 软件空间接入 Jira 软件空间时，需要将已创建的服务账号添加进 Jira 软件空间后，服务账号才能在后续流程中查询空间内需求列表。 1. 以管理员权限访问企业 Jira 服务地址（Jira Cloud 为例：`https://{example}.atlassian.net`）。 2. 单击目标空间，选择“更多操作 \> 添加人员”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a529a7c46694c778aa05bb5c23fdef01.png) 3. 在弹出框中，添加目标服务账号。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3fc1a396986cf4df53390300570c9084.png) ### 步骤三：填写 Webhook 地址 1. 以管理员权限访问企业 Jira 服务地址（Jira Cloud 为例：`https://{example}.atlassian.net`）。 2. 单击页面右上角的图标，选择弹出框中的“Jira 管理设置 \> 系统”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0da3b23dad289e6243193a85f7348c67.png) 3. 在左侧导航树中，选择“高级 \> Webhook”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c0ecaff0f8533ceae7c0b1b678024401.png) 4. 单击页面右上角的“创建网络钩子”按钮。 5. 参考下表，配置参数。 |**参数** |**说明** | |---|---| |名称 |输入自定义的名称。 | |状态 |默认选择“已开启”。 | |URL |粘贴从 DeliveryAI 平台复制的 Webhook 地址信息。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b3b786fea942c4af31355c475ce20e08.png) | |事务相关事件 |勾选以下选项。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b3b009fb4bc8e6f75e7c2c5abdab6000.png) | 6. 单击“创建”按钮，完成操作。 ## 配置企业集成 1. 在 [AgentKit控制台](https://console.volcengine.com/agentkit) 左侧导航树中，选择“DeliveryAI”。 2. 在“DeliveryAI”页面，单击切换至“企业集成”页签。 3. 在企业集成页签中单击“Jira”卡片右下角的“配置”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_673013320c86030acf1c3290378b3aaf.png) 4. 参考下表，配置参数。 |**参数** |**说明** | |---|---| |Jira 服务地址 |Jira 站点访问地址，用于连接 Jira 服务。Jira Cloud 场景通常为 `https://{example}.atlassian.net`。 | |Service Account Client ID |服务账号 Client ID，请参见[步骤一：创建服务账号](https://docs.volcengine.com/docs/86681/2628944?lang=zh#qzgKpfCa)获取，用于保证系统后台服务正常运行。 | |Service Account Client Secret |服务账号 Client Secret，请参见[步骤一：创建服务账号](https://docs.volcengine.com/docs/86681/2628944?lang=zh#qzgKpfCa)获取，用于服务端鉴权，页面中通常以掩码方式展示。 | 5. 单击“确定”按钮保存配置，单击 Jira 卡片右上角的开关，启用此配置。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3f20de1cb7ac29e5d0f1dfc973861861.png) 6. 单击 Jira 卡片下方的“测试”按钮进行连通性测试，待页面提示成功后表明连接测试通过。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_199626a163a6e1fedaaaf7c8a603523a.png)