开发人员提交代码后，往往还需要手动进入Jira创建缺陷工单、填写复现步骤、指定负责人——这套流程不仅繁琐，还容易遗漏或延迟，导致问题越积越多。如果能直接在Dify平台中集成Jira，让AI在检测到代码变更或用户反馈时自动生成结构化工单并分配相关人员，团队效率将大幅提升。下面从凭证配置到工作流闭环，逐步详解具体操作。

配置Jira API凭证与连接

首先登录Jira Cloud控制台，依次进入“设置 → 安全 → API令牌”，点击“创建API令牌”，为其命名（例如dify-integration），生成后立即复制并妥善保存——【该令牌仅显示一次，丢失后只能重新生成】，切勿在未保存前关闭窗口。

返回Dify平台，在“设置 → 插件与集成 → 自定义HTTP工具”中新增一项。名称填写“jira-create-issue”，基础URL设为https://your-domain.atlassian.net/rest/api/3/issue（请将your-domain替换为实际公司域名）。认证方式选择“Basic Auth”，用户名填写注册Jira时使用的邮箱，密码栏粘贴刚才复制的API令牌。

点击“测试连接”，如果返回状态码200，说明凭证配置正确。若失败，请检查：邮箱是否输入正确？令牌是否已过期？Jira账户是否拥有项目创建权限？这些细节往往是出错的根源。

定义Jira工单创建工具参数

在Dify工作流编辑器中新建一个“工具调用”节点，选中已注册的jira-create-issue工具。

展开“参数映射”区域，根据Jira REST API要求填写必填字段：

• project.key（字符串）——填写项目缩写，例如“QA”。
• summary（字符串）——从上游提取的标题内容。
• description（字符串）——支持格式化文本，可在此写入复现步骤。
• issuetype.name（字符串）——固定填写“Bug”或“Task”，根据实际需求选择。
• assignee.name（字符串）——填写接收人的Jira账户名，例如“zhangsan”。

特别注意：assignee.name必须为目标成员在Jira中的实际账户名（而非显示名称）。填写错误不会报错，只会静默忽略该字段——届时工单虽创建成功，但未指派给任何人，排查起来非常隐蔽。

构建自动化工单生成工作流

整个流程共分五步，环环相扣：

第一步：接收事件——添加一个“HTTP请求”节点，URL指向Git Webhook地址或内部消息队列端点，用于接收代码提交事件或用户反馈消息。

第二步：LLM结构化提取——接入“LLM节点”，系统提示词可设为：“你是一个Jira工单生成助手。请从输入中提取问题现象、复现步骤、影响范围，并输出JSON格式：{‘title’: ‘…’, ‘steps’: ‘…’, ‘impact’: ‘…’}”。注意，输出必须为纯JSON，不含任何解释性文字，否则后续解析将出错。

第三步：变量映射——将LLM输出送入“变量提取”节点。使用JSONPath $.title提取标题，$.steps提取步骤，$.impact提取影响范围，然后分别映射到后续工具节点的summary和description字段。

第四步：参数固化——在工具节点参数中，project.key和issuetype.name设为常量（固定值），assignee.name绑定为环境变量JIRA_ASSIGNEE（例如预设为“lisi”）。这样无需每次硬编码，灵活性更高。

第五步：状态校验与告警——添加“条件判断”节点，检查工具调用返回的状态码是否为201。若是，输出“工单创建成功”；否则抛出错误日志并触发告警通知。毕竟自动化工单若静默失败，等于白费功夫。

整个闭环打通后：开发提交代码 → 事件触发 → AI提取关键信息 → 调用Jira API → 自动指派 → 状态反馈，一气呵成，人工盯流程的时代就此结束。