---
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 | 操作の成功ステータス |
| `output` | object | taskGidが提供されたかどうかに応じて、単一のタスクの詳細またはタスクの配列 |

### `asana_create_task`

Asanaで新しいタスクを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | はい | タスクが作成されるワークスペースのGID |
| `name` | string | はい | タスクの名前 |
| `notes` | string | いいえ | タスクのメモや説明 |
| `assignee` | string | いいえ | タスクを割り当てるユーザーのGID |
| `due_on` | string | いいえ | YYYY-MM-DD形式の期日 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作の成功ステータス |
| `output` | object | タイムスタンプ、GID、名前、メモ、パーマリンクを含む作成されたタスクの詳細 |

### `asana_update_task`

Asanaの既存タスクを更新する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | はい | 更新するタスクのグローバル一意識別子（GID） |
| `name` | string | いいえ | タスクの更新された名前 |
| `notes` | string | いいえ | タスクの更新されたメモや説明 |
| `assignee` | string | いいえ | 更新された担当者のユーザーGID |
| `completed` | boolean | いいえ | タスクを完了または未完了としてマークする |
| `due_on` | string | いいえ | YYYY-MM-DD形式の更新された期日 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | タイムスタンプ、gid、名前、メモ、更新タイムスタンプを含む更新されたタスクの詳細 |

### `asana_get_projects`

Asanaワークスペースからすべてのプロジェクトを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | はい | プロジェクトを取得するワークスペースGID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | gid、名前、リソースタイプを含むプロジェクトのリスト |

### `asana_search_tasks`

Asanaワークスペース内のタスクを検索する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `workspace` | string | はい | タスクを検索するワークスペースGID |
| `text` | string | いいえ | タスク名で検索するテキスト |
| `assignee` | string | いいえ | 担当者ユーザーGIDでタスクをフィルタリング |
| `projects` | array | いいえ | タスクをフィルタリングするプロジェクトGIDの配列 |
| `completed` | boolean | いいえ | 完了ステータスでフィルタリング |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | 検索条件に一致するタスクのリスト |

### `asana_add_comment`

Asanaタスクにコメント（ストーリー）を追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `taskGid` | string | はい | タスクのグローバル一意識別子（GID） |
| `text` | string | はい | コメントのテキスト内容 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | 操作成功ステータス |
| `output` | object | gid、テキスト、作成タイムスタンプ、作成者を含むコメントの詳細 |

## 注意事項

- カテゴリー: `tools`
- タイプ: `asana`
