AGENTFLOW DOCUMENTATION
Jira 与智能分配
把缺陷信息转成完整任务,让 Agent 从正确的上下文开始。
配置 Jira 数据源
在服务端环境或“设置 → 对接配置”中配置 Jira。环境文件修改后需重启服务。JQL 只填写过滤条件,排序由适配器添加。
dotenv
ISSUE_PROVIDER=jira
JIRA_BASE_URL=https://your-team.atlassian.net
JIRA_EMAIL=you@example.com
JIRA_API_TOKEN=replace-with-your-token
JIRA_JQL=project = DEMO也支持 JIRA_ACCESS_TOKEN Bearer 认证,设置后优先于邮箱与 API Token。凭据保存在服务端,不下发到浏览器。OAuth 网关与站点地址不同时,可使用 JIRA_SITE_URL 生成问题链接。
同步并创建任务
进入“缺陷工作台”,点击“立即拉取”,按标题、编号或经办人查找问题。打开详情,核对描述和附件后生成任务。同步间隔和定时开关在“设置 → 对接配置”管理;服务重启后定时同步默认关闭。
建议与自动分配
在“设置 → 分配规则”维护候选人员及职责。启用 AI 分配后生成经办人建议;只有开启自动分配时,系统才会调用 Jira 修改经办人。
在“设置 → 对接配置”选择预设模型或手动添加模型 ID,再在“高级配置”填写模型服务的 Base URL 和 API Key。点“测试连接”验证当前输入,点“保存配置”应用到当前空间。内网模型服务需由部署管理员设置对应租户的 OPENAI_BASE_URL 后重启。
dotenv
ENABLE_AI_ASSIGNMENT=true
ENABLE_AUTO_ASSIGNMENT=false
OPENAI_API_KEY=replace-with-your-key
OPENAI_BASE_URL=https://api.openai.com/v1同步限制
| 参数 | 默认值 |
|---|---|
| JIRA_PAGE_SIZE | 100 |
| JIRA_MAX_PAGES | 50 |
| JIRA_TIMEOUT_MS | 30000 毫秒 |
拉取失败时先检查网络、认证方式、JQL 和 Jira 项目访问权限;不要通过重复创建任务规避同步错误。
发现问题或需要补充?在 GitHub 提交反馈 ↗