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

# Todoist

> Todoist 可通过你已连接的账户帮你创建和管理任务、项目、部分、标签、评论和工作区。

# Todoist

当你需要在工作流中创建、更新或查找工作项时，可以使用 Todoist。它也适合你把任务整理到项目和部分中，添加标签或评论，以及完成或重新打开任务。

## 配置

| 选项 | 必填 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| 身份验证 | 是 | 此步骤要使用的已连接 Todoist 账户。 |
| 操作 | 是 | 要执行的 Todoist 操作（例如 Create task、Get task、Update task、Close task）。 |
| 参数 | 是 | 根据操作的 schema 生成的各操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于注入 `{{placeholder}}` 值。还提供一个 **Raw JSON** 选项卡，方便高级用法。 |
| 步骤失败时 | 否 | 控制此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## 参数表单

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

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

## 常用操作

| 操作 | 说明 |
| - | - |
| **Create task** | 在 Todoist 中创建新任务。 |
| **Get task** | 通过 ID 获取单个活动任务。 |
| **Update task** | 更新现有任务的属性。 |
| **Close task** | 在 Todoist 中完成一个任务。 |
| **Reopen task** | 重新打开一个已完成的任务。 |
| **Create project** | 在 Todoist 中创建新项目。 |
| **Get project** | 通过 ID 获取项目。 |
| **Update project** | 更新项目的属性。 |
| **Create section** | 在项目中创建一个部分。 |
| **List sections** | 列出该用户的活动部分。 |
| **Create label** | 创建新的个人标签。 |
| **List labels** | 列出所有用户标签。 |
| **Create comment** | 为项目或任务创建评论。 |
| **List comments** | 列出任务或项目上的评论。 |

具有破坏性的操作，例如删除记录，在工作流操作选择器中不可用。

## 输出

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

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

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

## 示例

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

## 使用场景

### 从表单回复创建任务

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

### 在项目中整理工作

1. Create project
2. Create section
3. List sections
4. Update project

### 跟踪协作评论

1. Create comment
2. List comments
3. Get project

## 说明

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

## 将 Todoist 作为智能体工具使用

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

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