mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-15 00:44:56 -05:00
166 lines
4.9 KiB
Plaintext
166 lines
4.9 KiB
Plaintext
---
|
||
title: Asana
|
||
description: 与 Asana 互动
|
||
---
|
||
|
||
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
||
|
||
<BlockInfoCard
|
||
type="asana"
|
||
color="#E0E0E0"
|
||
/>
|
||
|
||
## 使用说明
|
||
|
||
将 Asana 集成到工作流程中。可以读取、写入和更新任务。
|
||
|
||
## 工具
|
||
|
||
### `asana_get_task`
|
||
|
||
通过 GID 检索单个任务或使用筛选器获取多个任务
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `taskGid` | string | 否 | 任务的全局唯一标识符 \(GID\)。如果未提供，将获取多个任务。 |
|
||
| `workspace` | string | 否 | 用于筛选任务的工作区 GID \(未使用 taskGid 时必需\) |
|
||
| `project` | string | 否 | 用于筛选任务的项目 GID |
|
||
| `limit` | number | 否 | 返回的最大任务数 \(默认值：50\) |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 操作成功状态 |
|
||
| `ts` | string | 响应的时间戳 |
|
||
| `gid` | string | 任务的全局唯一标识符 |
|
||
| `resource_type` | string | 资源类型（任务） |
|
||
| `resource_subtype` | string | 资源子类型 |
|
||
| `name` | string | 任务名称 |
|
||
| `notes` | string | 任务备注或描述 |
|
||
| `completed` | boolean | 任务是否已完成 |
|
||
| `assignee` | object | 分配人详情 |
|
||
|
||
### `asana_create_task`
|
||
|
||
在 Asana 中创建一个新任务
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `workspace` | string | 是 | 创建任务的工作区 GID |
|
||
| `name` | string | 是 | 任务名称 |
|
||
| `notes` | string | 否 | 任务的备注或描述 |
|
||
| `assignee` | string | 否 | 分配任务的用户 GID |
|
||
| `due_on` | string | 否 | 以 YYYY-MM-DD 格式的截止日期 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 操作成功状态 |
|
||
| `ts` | string | 响应的时间戳 |
|
||
| `gid` | string | 任务的全局唯一标识符 |
|
||
| `name` | string | 任务名称 |
|
||
| `notes` | string | 任务备注或描述 |
|
||
| `completed` | boolean | 任务是否已完成 |
|
||
| `created_at` | string | 任务创建时间戳 |
|
||
| `permalink_url` | string | 任务在 Asana 中的 URL |
|
||
|
||
### `asana_update_task`
|
||
|
||
更新 Asana 中的现有任务
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `taskGid` | string | 是 | 要更新任务的全局唯一标识符 \(GID\) |
|
||
| `name` | string | 否 | 更新后的任务名称 |
|
||
| `notes` | string | 否 | 更新后的备注或描述 |
|
||
| `assignee` | string | 否 | 更新后的分配用户 GID |
|
||
| `completed` | boolean | 否 | 将任务标记为已完成或未完成 |
|
||
| `due_on` | string | 否 | 更新后的截止日期，格式为 YYYY-MM-DD |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 操作成功状态 |
|
||
| `ts` | string | 响应的时间戳 |
|
||
| `gid` | string | 任务的全局唯一标识符 |
|
||
| `name` | string | 任务名称 |
|
||
| `notes` | string | 任务备注或描述 |
|
||
| `completed` | boolean | 任务是否已完成 |
|
||
| `modified_at` | string | 任务最后修改时间戳 |
|
||
|
||
### `asana_get_projects`
|
||
|
||
从 Asana 工作区检索所有项目
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `workspace` | string | 是 | 要从中检索项目的工作区 GID |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 操作成功状态 |
|
||
| `ts` | string | 响应的时间戳 |
|
||
| `projects` | array | 项目数组 |
|
||
|
||
### `asana_search_tasks`
|
||
|
||
在 Asana 工作区中搜索任务
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `workspace` | string | 是 | 要搜索任务的工作区 GID |
|
||
| `text` | string | 否 | 在任务名称中搜索的文本 |
|
||
| `assignee` | string | 否 | 按分配用户 GID 筛选任务 |
|
||
| `projects` | array | 否 | 按项目 GID 数组筛选任务 |
|
||
| `completed` | boolean | 否 | 按完成状态筛选 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 操作成功状态 |
|
||
| `ts` | string | 响应的时间戳 |
|
||
| `tasks` | array | 匹配任务的数组 |
|
||
|
||
### `asana_add_comment`
|
||
|
||
向 Asana 任务添加评论（故事）
|
||
|
||
#### 输入
|
||
|
||
| 参数 | 类型 | 必需 | 描述 |
|
||
| --------- | ---- | -------- | ----------- |
|
||
| `taskGid` | string | 是 | 任务的全局唯一标识符 \(GID\) |
|
||
| `text` | string | 是 | 评论的文本内容 |
|
||
|
||
#### 输出
|
||
|
||
| 参数 | 类型 | 描述 |
|
||
| --------- | ---- | ----------- |
|
||
| `success` | boolean | 操作成功状态 |
|
||
| `ts` | string | 响应的时间戳 |
|
||
| `gid` | string | 评论的全局唯一标识符 |
|
||
| `text` | string | 评论的文本内容 |
|
||
| `created_at` | string | 评论的创建时间戳 |
|
||
| `created_by` | object | 评论作者的详细信息 |
|
||
|
||
## 注意事项
|
||
|
||
- 类别：`tools`
|
||
- 类型：`asana`
|