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

# Asana

> 通过已连接的账号，在 Asana 中组织、跟踪并管理团队工作。

# Asana

当你的工作流需要 Asana 工作项、项目结构或任务更新时，请使用此应用。你可以从其他步骤创建、读取并组织任务和项目。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中该步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Asana 账号。 |
| Action | 是 | 要执行的 Asana 操作（例如 Get current user、Create task、Get task、Update task）。 |
| Arguments | 是 | 根据该操作的架构生成的每个操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## Arguments form

当你选择一个操作时，**Arguments** 部分会显示一个由该操作输入架构驱动的表单。引用现有记录的字段包含下拉选择器。

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

## Common actions

| 操作 | 描述 |
| - | - |
| **Get current user** | 获取已认证用户的 Asana 个人资料和可访问的工作区。 |
| **Create task** | 创建一个新任务，包含名称、负责人、项目或父任务。 |
| **Get task** | 通过其 GID 获取任务的完整详情。 |
| **Update task** | 更新现有任务上的字段。 |
| **Add tag to task** | 将现有标签附加到任务。 |
| **Get tags for task** | 列出应用于某个任务的所有标签。 |
| **Create project** | 在工作区或团队中创建一个新项目。 |
| **Get project** | 通过其 GID 获取项目的完整详情。 |
| **Update project** | 更新现有项目上的字段。 |
| **Get tasks from project** | 列出项目中的任务，并可选筛选。 |
| **Create section** | 在项目中创建一个新部分。 |
| **Get sections in project** | 列出项目中的所有部分。 |
| **Add task to section** | 将现有任务移动到项目部分中。 |
| **Create tag** | 在工作区中创建一个新标签。 |
| **Get tags in workspace** | 列出工作区中所有可用的标签。 |

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

## Output

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

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

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

## Example

1. 打开 **Integrations**，如果你还没有这样做过，请连接 Asana。
2. 在你的工作流中添加一个 **Asana** 步骤。
3. 在 **Authentication** 中选择一个已连接账号。
4. 在 **Action** 中选择 **Get current user**。
5. 填写所需字段。使用 **Insert Variable** 为任何字段值引用前一个步骤的输出。
6. 点击步骤标题中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的载荷。

## Use cases

### 从请求创建任务

1. Create task
2. Add tag to task
3. Get task

### 组织项目工作

1. Create section
2. Get sections in project
3. Add task to section

### 查看项目状态

1. Get project
2. Get tasks from project
3. Update project

## Notes

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

## Using Asana as an Agent Tool

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

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