> ## 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.

# Monday

> Monday 是一款可自定义的工作管理应用，可通过已连接的账户用于规划、协作和自动化。

# Monday

当你需要在看板和项目项上管理工作时，可以使用 Monday。你可以创建、读取和更新记录，在组之间移动工作，并发布更新。

## 配置

| 选项 | 是否必填 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中该步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Monday 账户。 |
| Action | 是 | 要执行的 Monday 操作（例如 获取看板、创建看板、更新看板、获取看板列）。 |
| Arguments | 是 | 由操作的模式生成的按操作区分的表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于注入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| 当步骤失败时 | 否 | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。 |

在你配置此步骤之前，请通过登录流程在工作区的 **Integrations** 中连接 Monday。如果没有可用的活动连接，步骤会显示警告，并提供指向 **Integrations** 的链接，而不是账户选择器。

## 参数表单

当你选择一个操作时，**Arguments** 部分会根据该操作的输入模式渲染出一个表单。引用现有记录的字段包含下拉选择器。

如果你更喜欢手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常见操作

| 操作 | 说明 |
| - | - |
| **Get boards** | 检索该账户可访问的看板。 |
| **Create board** | 创建一个新看板。 |
| **Update board** | 更新看板设置。 |
| **Get board columns** | 列出一个或多个看板的列。 |
| **Create column** | 向看板添加新列。 |
| **Create item** | 在看板上创建新项目项。 |
| **Get items by IDs** | 按 ID 获取特定项目项。 |
| **Get items page** | 列出看板或组中的项目项。 |
| **Update item** | 更新特定项目项的列值。 |
| **Change column value** | 更改简单文本、状态或下拉值。 |
| **Move item to group** | 将项目项移动到同一看板上的另一个组。 |
| **List groups** | 列出看板上的所有组。 |
| **List users** | 检索该账户中可用的用户。 |
| **Create update** | 发布新的更新或回复。 |
| **Get item updates** | 检索特定项目项的更新。 |

诸如删除记录之类的破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Monday 的响应存储为步骤输出。响应的结构取决于操作。

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

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

## 示例

1. 打开 **Integrations**，如果你还没有连接过 Monday，就先连接它。
2. 在你的工作流中添加一个 **Monday** 步骤。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **Get boards**。
5. 填写必填字段。对任何字段值，使用 **Insert Variable** 引用前一个步骤的输出。
6. 点击步骤标题栏中的 **Run** 测试该操作，然后在 **Output** 中查看返回的有效负载。

## 使用场景

### 创建跟踪的工作

1. 创建看板
2. 创建列
3. 创建项目项
4. 创建更新

### 同步项目项状态

1. 获取项目项页面
2. 获取看板列
3. 更改列值
4. 获取项目项更新

### 移动工作项

1. 列出组
2. 按 ID 获取项目项
3. 将项目项移动到组
4. 更新项目项

## 备注

* 此步骤依赖于你工作区中已连接的 Monday 集成。
* 工作流操作选择器显示的是一组精选操作。拥有 Monday 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Monday 作为代理工具使用

你也可以在 **Agent Editor** 中将 Monday 添加为工具。打开代理，点击 **Add tool**，然后选择 **Monday**。在工具设置面板中，选择代理应使用的已连接账户。代理会在相关于对话时调用 Monday 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.