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

# ClickUp

> 通过已连接的账号，ClickUp 可帮助团队管理任务、文档、目标、聊天和时间追踪。

# ClickUp

当你的工作流需要任务、文档、目标、聊天或时间追踪时，请使用 ClickUp。你可以在整个工作区中创建、读取和更新工作项。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 ClickUp 账号。 |
| Action | 是 | 要执行的 ClickUp 操作（例如 Get authorized user、List spaces、List folders、List lists）。 |
| Arguments | 是 | 根据操作的模式生成的逐操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于注入 `{{placeholder}}` 值。还提供了一个 **Raw JSON** 选项卡，适合高级用法。 |
| When the step fails | 否 | 控制当此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## Arguments form

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

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

## Common actions

| Action | 描述 |
| - | - |
| **Get authorized user** | 获取已连接的 ClickUp 用户资料。 |
| **List spaces** | 列出工作区中可用的 Spaces。 |
| **List folders** | 列出某个 Space 中的文件夹。 |
| **List lists** | 列出某个文件夹中的列表。 |
| **List tasks** | 列出某个列表中的任务。 |
| **Get task** | 获取某个任务的完整详情。 |
| **Create task** | 在某个列表中创建新任务。 |
| **Update task** | 更新现有任务上的字段。 |
| **Create task comment** | 为任务添加评论。 |
| **List task comments** | 列出某个任务上的评论。 |
| **Create doc** | 在工作区中创建新的 ClickUp Doc。 |
| **Get doc content** | 获取文档的完整内容。 |
| **Create doc page** | 向现有文档添加页面。 |
| **List doc pages** | 列出文档中的页面。 |
| **Create goal** | 在工作区中创建新目标。 |

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

## 输出

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

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

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

## 示例

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

## Use cases

### 从请求创建任务

1. List lists
2. Create task
3. Create task comment

### 起草项目文档

1. Create doc
2. Create doc page
3. Get doc content

### 跟踪任务上的工作

1. Get task
2. Create time entry
3. Update task

## Notes

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

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

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

另请参阅：[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.