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

# Trello

> 一个用于通过已连接账户管理 Trello 看板、列表、卡片、标签、检查清单和成员分配的 Trello 应用。

# Trello

当你想从工作流中创建或更新 Trello 工作项时，可以使用这个应用。你也可以在进行更改之前查找看板、列表、卡片和检查清单详情。

## 配置

| Option | Required | Description |
| - | - | - |
| Name | No | 工作流画布中该步骤的标签。 |
| Authentication | Yes | 此步骤要使用的已连接 Trello 账户。 |
| Action | Yes | 要执行的 Trello 操作（例如 Create board、Get board、Create list、List board lists）。 |
| Arguments | Yes | 由操作的架构生成的按操作区分的表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | No | 控制如果此步骤失败，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## Arguments form

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

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

## Common actions

| Action | Description |
| - | - |
| **Create board** | 创建一个新的 Trello 看板。 |
| **Get board** | 按 ID 获取某个看板的详情。 |
| **Create list** | 在看板上创建一个新列表。 |
| **List board lists** | 列出看板上的列表。 |
| **Rename list** | 更新列表名称。 |
| **Create card** | 在列表中创建一张新卡片。 |
| **Get card** | 按 ID 获取某张卡片。 |
| **List cards** | 列出列表中的卡片。 |
| **Add comment** | 向卡片添加评论。 |
| **Create checklist** | 在卡片或看板上创建一个新的检查清单。 |
| **List checklists** | 列出卡片上的检查清单。 |
| **Add check item** | 向检查清单添加一个新的检查项。 |
| **Update check item state** | 更新检查项的完成状态。 |
| **Create label** | 在看板上创建一个新标签。 |
| **Add label** | 将现有标签添加到卡片。 |

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

## Output

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

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

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

## Example

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

## Use cases

### Create a task card

1. Create list
2. Create card
3. Add label

### Track checklist progress

1. Create checklist
2. Add check item
3. Update check item state

### Review board work

1. Get board
2. List board lists
3. List cards

## Notes

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

## Using Trello as an Agent Tool

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

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