Trello 是一个可视化协作工具,帮助您使用看板、列表和卡片来组织项目、任务和工作流程。
在 Sim 中使用 Trello,您可以:
- 列出看板和列表:查看您有权限访问的看板及其关联的列表。
- 列出和搜索卡片:检索看板上的所有卡片,或按列表筛选以查看其内容和状态。
- 创建卡片:向 Trello 列表中添加新卡片,包括描述、标签和到期日期。
- 更新和移动卡片:编辑卡片属性,将卡片移动到不同的列表,并设置到期日期或标签。
- 获取最近活动:检索看板和卡片的操作和活动历史记录。
- 评论卡片:向卡片添加评论以便协作和跟踪。
将 Trello 与 Sim 集成,可以让您的代理以编程方式管理团队的任务、看板和项目。通过您的 AI 代理,自动化项目管理工作流程,保持任务列表的最新状态,与其他工具同步,或响应 Trello 事件触发智能工作流程。
使用说明
集成 Trello 以管理看板和卡片。列出看板、列出卡片、创建卡片、更新卡片、获取操作记录以及添加评论。
工具
trello_list_lists
列出 Trello 看板上的所有列表
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
boardId | string | 是 | 要列出列表的看板 ID |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 操作是否成功 |
lists | array | 包含 id、name、closed、pos 和 idBoard 的列表对象数组 |
count | number | 返回的列表数量 |
error | string | 如果操作失败的错误信息 |
trello_list_cards
列出 Trello 看板上的所有卡片
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
boardId | string | 是 | 要列出卡片的看板 ID |
listId | string | 否 | 可选:按列表 ID 筛选卡片 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 操作是否成功 |
cards | array | 包含 id、name、desc、url、board/list IDs、labels 和到期日期的卡片对象数组 |
count | number | 返回的卡片数量 |
error | string | 如果操作失败的错误信息 |
trello_create_card
在 Trello 看板上创建新卡片
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
boardId | string | 是 | 要创建卡片的看板 ID |
listId | string | 是 | 要创建卡片的列表 ID |
name | string | 是 | 卡片的名称/标题 |
desc | string | 否 | 卡片的描述 |
pos | string | 否 | 卡片的位置(top、bottom 或正浮点数) |
due | string | 否 | 到期日期(ISO 8601 格式) |
labels | string | 否 | 逗号分隔的标签 ID 列表 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 卡片是否创建成功 |
card | object | 创建的卡片对象,包含 id、name、desc、url 和其他属性 |
error | string | 如果操作失败,返回错误信息 |
trello_update_card
更新 Trello 上的现有卡片
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
cardId | string | 是 | 要更新的卡片 ID |
name | string | 否 | 卡片的新名称/标题 |
desc | string | 否 | 卡片的新描述 |
closed | boolean | 否 | 归档/关闭卡片(true)或重新打开卡片(false) |
idList | string | 否 | 将卡片移动到其他列表 |
due | string | 否 | 到期日期(ISO 8601 格式) |
dueComplete | boolean | 否 | 将到期日期标记为已完成 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 卡片是否更新成功 |
card | object | 更新的卡片对象,包含 id、name、desc、url 和其他属性 |
error | string | 如果操作失败,返回错误信息 |
trello_get_actions
获取看板或卡片的活动/操作
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
boardId | string | 否 | 要获取操作的看板 ID(boardId 或 cardId 必填其一) |
cardId | string | 否 | 要获取操作的卡片 ID(boardId 或 cardId 必填其一) |
filter | string | 否 | 按类型筛选操作(例如 "commentCard,updateCard,createCard" 或 "all") |
limit | number | 否 | 返回的最大操作数(默认:50,最大:1000) |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 操作是否成功 |
actions | array | 包含类型、日期、成员和数据的操作对象数组 |
count | number | 返回的操作数量 |
error | string | 如果操作失败,返回的错误信息 |
trello_add_comment
向 Trello 卡片添加评论
输入
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
cardId | string | 是 | 要评论的卡片 ID |
text | string | 是 | 评论内容 |
输出
| 参数 | 类型 | 描述 |
|---|---|---|
success | boolean | 评论是否成功添加 |
comment | object | 创建的评论对象,包含 id、text、date 和 member creator |
error | string | 如果操作失败,返回的错误信息 |
注意事项
- 类别:
tools - 类型:
trello