---
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`
