> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> 配置一个使用已连接的 Linear 账户创建或查询 Linear issue 和 team 的工作流步骤

# 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**。                                                      |

在配置此步骤之前,请在工作区的 **Integrations** 中连接 Linear。如果没有可用的活动 Linear 连接,该步骤会显示警告并链接到 **Integrations**,而不是账户选择器。

## 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** 按钮显示在数组标签旁边。            | 否(数组项不支持变量插入)                    |

当你选择已连接账户时,所有下拉选项都会在一个请求中获取,因此打开设置面板不会触发多次 API 调用。如果特定字段的查找失败,它会退回到普通文本输入,这样你仍可以手动输入值或使用 `{{variable}}`。

切换到 **Raw JSON** 标签可供高级用户使用,或当你倾向于手写完整参数对象时使用。两个标签之间的更改保持同步。

## 操作

| 操作           | 说明                         |
| ------------ | -------------------------- |
| Create Issue | 在指定的 team 中创建新 issue。      |
| List Issues  | 搜索或列出 issue,可选筛选。          |
| Update Issue | 通过 ID 修改现有 issue。          |
| List Teams   | 列出已连接 Linear 工作区中的所有 team。 |

## 输出

此步骤将 Linear API 响应存储为步骤输出。响应的形状取决于操作。

在后续步骤中使用完整输出引用:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

例如,在 **Create Issue** 步骤之后,你可以引用新 issue 的 ID:

```text theme={null}
{{step_3.output.id}}
```

## 示例

1. 打开 **Integrations** 并连接 Linear(如果尚未连接)。
2. 将 **Linear** 步骤添加到你的工作流。
3. 在 **Authentication** 中选择已连接的账户。
4. 在 **Action** 中选择 **Create Issue**。
5. 在 **Arguments** 表单中,使用 **Team** 下拉菜单(从你的 Linear 账户自动填充)选择 team,填写 **Title** 和可选的 **Description**。在任何字段标签旁边使用 **Insert Variable** 来引用早前步骤的输出——例如,将 `{{step_1.output}}` 作为 issue 标题。
6. 点击步骤标题中的 **Run** 来测试操作,然后在 **Output** 中查看返回的载荷。

{/* Add screenshot: Linear step output tab after a test run */}

## 备注

* 此步骤依赖于工作区中已连接的 Linear 集成。
* 如果你倾向于直接编写 JSON,Arguments 中的 **Raw JSON** 标签始终可用。
* **Team**、**Project** 和 **Issue** 字段显示从你已连接的 Linear 工作区填充的下拉菜单。如果没有选项加载,请检查集成在 **Integrations** 中是否处于活动状态。
* **Update Issue** 操作提供 **Issue** 下拉菜单,因此你可以按标题选择现有 issue,而无需手动输入 ID。

## 将 Linear 用作智能体工具

你也可以在 **Agent Editor** 中将 Linear 添加为工具。打开智能体,点击 **Add tool**,然后选择 **Linear**。在工具设置面板中,选择智能体应使用的已连接 Linear 账户。智能体将在对话中相关时自动创建、搜索和更新 issue。

另见:[Integrations](../../../workspace/integrations)、[创建和编辑](../../creating-and-editing) 和 [测试与迭代](../../testing-and-iteration)