Asana

• AIエージェントにイベントやユーザーのリクエストに応じてAsanaのタスクやプロジェクトを作成・更新させたい場合。
• プロジェクトやワークスペース全体のタスクのステータス、担当者、期日をプログラムで照会する必要がある場合。
• タスクが変更されたときに外部システムに通知されるようAsanaのWebhookを設定したい場合。
• OAuthの認証情報を自分で管理せずに、Asanaへの読み取りまたは書き込みを行うワークフロー自動化を構築している場合。

• Asana以外のサードパーティアプリと統合する必要がある場合は、代わりにapi-gateway スキルを使用してください。
• Asanaのプランが無料プランであり、高度な検索が必要な場合（タスク検索にはAsana Premiumサブスクリプションが必要です）。

すべてのリクエストはMatonゲートウェイ（gateway.maton.ai）を経由してプロキシされ、AsanaのOAuthトークンが自動的に挿入されます。必要なのは MATON_API_KEY 一つだけで、OAuthのセットアップ、トークンの更新ロジック、認証情報の保存は一切不要です。

任意のプロジェクト全体でタスクの作成、読み取り、更新、削除を行います。担当者、完了日、プロジェクトGIDによるフィルタリングをサポートしており、任意の親タスク配下でのサブタスクの作成と一覧表示にも対応しています。

ワークスペース内のプロジェクトを一覧表示、作成、更新、削除します。プログラムによってユーザーを追加または削除することで、ワークスペースのメンバーシップを管理します。

ワークスペース、チーム、または個別のGIDでユーザーを取得します。/users/me エンドポイントを使用して、現在認証されているユーザーを検索します。

タスクやプロジェクトが変更された際にリアルタイム通知を受け取るために、AsanaのWebhookを作成、一覧表示、更新、削除します。リソースタイプ、アクション、特定のフィールドによるフィルタリングをサポートしています。

offset パラメータを使用したAsanaネイティブのカーソルベースページネーションにより、大規模な結果セットを処理します。レスポンスには、簡単に反復処理できるよう next_page オブジェクトが含まれています。

AIエージェントがユーザーのリクエスト（例：「Q2レポートをAliceが金曜日までにレビューするタスクを作成して」）を受け取り、このスキルを呼び出して、適切な担当者と期日を設定した上で正しいAsanaプロジェクトにタスクを作成します — 手動入力は一切不要です。

エージェントはプロジェクト内のすべてのタスクを照会し、完了ステータスと期日でフィルタリングして、チームのスタンドアップ向けに自然言語によるステータスサマリーまたはダッシュボードの更新情報を生成します。

別のシステムでチケットがクローズされたとき、エージェントはこのスキルを使用して、対応するAsanaタスクを完了としてマークし、完了メモを追加することで、両方のシステムを同期した状態に保ちます。

エージェントはプロジェクトにAsanaのWebhookを登録し、タスクの期日または完了ステータスが変更されるたびに、ダウンストリームのパイプラインが自動的にトリガーされるようにします。