Linear
当你希望工作流步骤从已连接的 Linear 工作区创建 issue、列出 issue、更新 issue 或检索 team 信息时,请使用 Linear。配置
| 选项 | 是否必填 | 说明 |
|---|---|---|
| Name | 否 | 步骤在工作流画布中的标签。 |
| Authentication | 是 | 此步骤使用的已连接 Linear 账户。 |
| Action | 是 | 要执行的 Linear 操作(Create Issue、List Issues、Update Issue、List Teams)。 |
| Arguments | 是 | 由操作的 schema 生成的每操作表单字段。每个文本字段都有一个 Insert Variable 按钮用于注入 {{placeholder}} 值。提供 Raw JSON 标签供高级使用。 |
| When the step fails | 否 | 控制此步骤失败时工作流应 Terminate Workflow 还是 Continue。 |
Arguments 表单
当你选择一个操作时,Arguments 区域会自动渲染一个由该操作输入 schema 驱动的表单——无需手动编辑 JSON。每个字段包含:- 来自操作 schema 的标签和描述。
- 标签旁边的 Insert Variable 按钮,可在光标位置注入诸如
{{step_1.output.id}}的引用。 - 如果必填字段为空,则显示内联验证反馈。
字段类型
| 字段类型 | 渲染方式 | 是否支持 Insert Variable |
|---|---|---|
| 文本 / 数字 | 普通输入框。 | 仅在 Create Issue 和 Update Issue 中 |
| 布尔值 | 开关(标签在左,开关在右)。 | 否 |
Team(team_id) | 从已连接 Linear 工作区填充的下拉菜单——按名称选择你的 team。 | 否 |
Project(project_id) | 从已连接 Linear 工作区填充的下拉菜单——按名称选择你的项目。 | 否 |
Issue(issue_id) | 从已连接 Linear 工作区填充的下拉菜单——按标题选择一个 issue。 | 否 |
| Label IDs / 字符串数组 | 文本输入列表。Add 按钮显示在数组标签旁边。 | 否(数组项不支持变量插入) |
{{variable}}。
切换到 Raw JSON 标签可供高级用户使用,或当你倾向于手写完整参数对象时使用。两个标签之间的更改保持同步。
操作
| 操作 | 说明 |
|---|---|
| Create Issue | 在指定的 team 中创建新 issue。 |
| List Issues | 搜索或列出 issue,可选筛选。 |
| Update Issue | 通过 ID 修改现有 issue。 |
| List Teams | 列出已连接 Linear 工作区中的所有 team。 |
输出
此步骤将 Linear API 响应存储为步骤输出。响应的形状取决于操作。 在后续步骤中使用完整输出引用:示例
- 打开 Integrations 并连接 Linear(如果尚未连接)。
- 将 Linear 步骤添加到你的工作流。
- 在 Authentication 中选择已连接的账户。
- 在 Action 中选择 Create Issue。
- 在 Arguments 表单中,使用 Team 下拉菜单(从你的 Linear 账户自动填充)选择 team,填写 Title 和可选的 Description。在任何字段标签旁边使用 Insert Variable 来引用早前步骤的输出——例如,将
{{step_1.output}}作为 issue 标题。 - 点击步骤标题中的 Run 来测试操作,然后在 Output 中查看返回的载荷。
备注
- 此步骤依赖于工作区中已连接的 Linear 集成。
- 如果你倾向于直接编写 JSON,Arguments 中的 Raw JSON 标签始终可用。
- Team、Project 和 Issue 字段显示从你已连接的 Linear 工作区填充的下拉菜单。如果没有选项加载,请检查集成在 Integrations 中是否处于活动状态。
- Update Issue 操作提供 Issue 下拉菜单,因此你可以按标题选择现有 issue,而无需手动输入 ID。