如何在Dify中调用Linear API自动整理并提交软件缺陷报告-人工智能-PHP中文网

dify可自动识别用户反馈为缺陷并提交至linear：配置linear_api_token和linear_team_id环境变量后，通过workflow提取json结构化信息，再经http或python节点调用graphql api创建issue，自动关联团队、优先级与标签。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如何在dify中调用linear api自动整理并提交软件缺陷报告

你需要让Dify自动把用户反馈的软件问题识别为缺陷，生成标准格式报告，并通过Linear API提交到对应项目看板——整个流程不依赖人工中转，且能正确关联到指定团队、优先级和标签。

在Linear中创建专用API Token并配置权限

登录Linear → Settings → Developer settings → Create new token → 勾选“Issues: write”和“Projects: read”权限 → 复制生成的token值（形如 lin_api_abc123xyz）。

【必须勾选Issues: write】否则Dify调用时会返回403错误，且该权限无法事后补开，删掉重创是唯一补救方式。

把token保存在安全位置，后续将填入Dify的环境变量，不要硬编码进提示词或工作流。

在Dify中配置Linear API连接

进入Dify控制台 → App → Settings → Environment Variables → 新增变量：LINEAR_API_TOKEN → 值为你刚复制的token。

再新增变量：LINEAR_TEAM_ID → 值为你要提交缺陷的目标团队ID（可在Linear团队页面URL中提取，例如 https://linear.app/your-org/teams/team-abc123/issues 中的 team-abc123）。

这一步做完后，所有后续工作流都能直接引用这两个变量，无需每次手动传参。

构建缺陷识别与结构化提取工作流

新建Workflow → 添加Text Input节点（接收用户原始反馈，如“登录页点击‘忘记密码’后页面白屏，iOS 17.5上必现”）→ 连接LLM节点。

在LLM节点Prompt中写明输出格式要求：必须用JSON输出，字段固定为{“title”: “简明标题”, “description”: “带复现步骤的完整描述”, “priority”: “urgent/medium/low”, “labels”: [“frontend”, “ios”]}；禁止任何额外说明文字或Markdown格式。

php获得文件的mime type类

下载

添加JSON Parse节点校验输出，失败时触发Fallback：返回“无法解析缺陷信息，请用中文描述具体现象和操作步骤”。

调用Linear API创建Issue

方法一：使用HTTP请求节点直连

添加HTTP Request节点 → Method选POST → URL填 https://api.linear.app/graphql → Headers加 Authorization: Bearer {{LINEAR_API_TOKEN}} 和 Content-Type: application/json。

Body用GraphQL写入，模板如下：

{"query":"mutation IssueCreate($input: IssueCreateInput!) { issueCreate(input: $input) { success issue { id url } } }","variables":{"input":{"title":"{{workflow.outputs.title}}","description":"{{workflow.outputs.description}}","priority":"{{workflow.outputs.priority}}","teamId":"{{LINEAR_TEAM_ID}}","labelIds":["lab-xyz123"]}}}

【labelIds必须填Linear中实际存在的标签ID】不能填标签名称，需提前在Linear标签页复制ID（格式 lab-xxx），填错会导致创建成功但无标签。

方法二：用Python代码节点封装调用（适合需要动态查标签ID的场景）

添加Code node（Python）→ 输入代码：先GET /labels接口查出“bug”和“mobile”的ID → 再POST /issues携带这些ID → 返回issue.url给下游。

这一步执行完，Linear看板里会出现新Issue，状态默认为“Backlog”，标题、描述、优先级、标签全部按Dify提取结果自动填充。