AgentFlow
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_SIZE100
JIRA_MAX_PAGES50
JIRA_TIMEOUT_MS30000 毫秒

拉取失败时先检查网络、认证方式、JQL 和 Jira 项目访问权限;不要通过重复创建任务规避同步错误。