AI Jira咨询配置：从零搭建智能工单助手的完整步骤
想把 Jira 里堆积的咨询类工单自动分类、自动回复，甚至让 AI 先给出初步答案？
这篇教程按零基础也能照做的顺序，讲清楚 AI Jira咨询配置 的准备条件、操作路径和验证方法。
先明确适用条件：你需要有 Jira Cloud 或 Jira Data Center 的管理员权限，并且能访问一个可用的 AI 服务接口（例如 OpenAI API 或企业自建模型服务）。
如果只是普通项目成员，无法修改自动化规则和字段配置，建议先联系 Jira 管理员。
配置前需要理清的三件事
在动手点按钮之前，先把下面三个问题想清楚，后面会少走很多弯路。
- 咨询工单的入口在哪里：是客户通过邮件创建，还是通过门户表单提交？不同入口对应的触发器不同。
- AI 要处理哪一步：是自动打标签、自动分配负责人，还是自动生成第一条回复？建议第一版只做“分类 + 建议回复”，稳定后再增加自动流转。
- 回复内容由谁审核：AI 生成的回复如果直接发给客户，风险较高，建议先写入工单评论，由人工确认后再发送。
第一步：在 Jira 中准备自定义字段
进入 Jira 管理后台，路径为 设置 → 问题 → 自定义字段，新建两个字段：
AI分类结果：类型选“单选列表”，选项包括“产品咨询”“账单问题”“技术故障”“其他”。AI建议回复：类型选“多行文本”，用于存放 AI 返回的回复草稿。
创建后，把这两个字段关联到咨询工单所在的项目和问题类型中，否则自动化规则里选不到字段。
第二步：配置自动化规则对接 AI 服务
进入项目设置，找到 自动化 → 创建规则，按以下逻辑配置：
- 触发器：选择“问题已创建”，并限制问题类型为“咨询”。
- 条件：判断描述字段不为空。
- 操作：选择“发送网络请求”，方法选
POST，URL 填写你的 AI 服务接口地址。请求体可以使用 Jira 智能值插入工单描述，例如：
{
"model": "你的模型名称",
"messages": [
{"role": "user", "content": "请将以下咨询分类为产品咨询、账单问题、技术故障或其他，并给出一句回复建议：{{issue.description}}"}
]
}请求头中需要带上 Authorization: Bearer 你的API密钥 和 Content-Type: application/json。
- 后续操作：再添加一个“编辑问题”动作，把网络请求返回的内容写入
AI建议回复字段。如果接口返回结构化分类，可以用智能值提取后写入AI分类结果。
保存规则后，先不要启用，点击“测试规则”用一条模拟工单验证请求是否成功。
避坑指南：这几个地方最容易出错
- API 密钥不要明文写在规则描述里：Jira 自动化支持密钥管理，建议把密钥存为“自动化密钥”，在请求头中引用，避免泄露。
- 网络请求超时时间要设置合理：AI 接口响应可能超过 10 秒，建议把超时设置为 30 秒，否则规则会提前失败。
- 字段类型要匹配：如果 AI 返回的是 JSON，而字段是纯文本，需要先用智能值解析，否则写入会失败。
- 不要对历史工单批量触发：规则首次启用时，建议加上“仅对创建时间晚于规则启用时间”的条件，避免旧工单被重复处理。
验证配置是否生效
提交一条测试咨询工单，等待 1 到 2 分钟，然后检查三处：
- 工单的
AI分类结果字段是否已自动填充。 AI建议回复字段中是否有 AI 返回的文本。- 自动化规则执行记录中是否显示“成功”。如果失败，查看记录里的错误信息，常见原因是密钥无效、URL 不可达或请求体格式错误。
确认无误后，再开启“自动将 AI 建议回复添加为内部评论”的动作，让客服人员先审核再对外发送。
常见疑问
AI 服务必须用国外的吗？ 不一定。
只要你的 Jira 实例能访问该接口，并且接口支持标准的 HTTP 请求，国内模型服务也可以使用。
配置后会影响现有工单流程吗？ 只要规则条件限制在“咨询”类型且只做字段写入，不会改变原有状态流转。
建议先在测试项目验证。
AI 返回内容不准确怎么办？ 第一版把 AI 输出定位为“建议”而非“最终答案”，由人工审核后再使用，同时根据错误样本调整提示词。
完成以上步骤后，你的 Jira 咨询工单就有了初步的 AI 辅助能力。
后续可以根据实际效果，逐步增加自动分配和自动回复的环节，但每次改动后都要用测试工单验证一遍，确保规则稳定。
