> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> タスク・プロジェクト・ポートフォリオ・ゴールを管理 — カスタムフィールド、依存関係、時間管理にも完全対応

# Asana

ShanoneのAsana連携では、**115個のツール**をエージェントに提供します — カタログの中でも最も網羅性の高い連携の一つで、タスクやプロジェクトだけでなく、ポートフォリオ、ゴール、カスタムフィールド、依存関係、時間管理、Webhookまでカバーしています。

## はじめに

<Steps>
  <Step title="OAuthで接続する">
    エージェントにAsanaで何か作業をしてもらう(例:「Q3ロードマップのプロジェクトにタスクを作成して」)か、Shanoneダッシュボードの**インテグレーション**から事前に接続します。
  </Step>

  <Step title="ワークスペースを承認する">
    Shanoneにアクセスさせたいワークスペースについて、AsanaのOAuth承認画面で承認します。
  </Step>

  <Step title="リクエストを再試行する">
    接続が完了すると、`asana_*`ツールに対する`shanone_execute_tool`の呼び出しが成功するようになります。
  </Step>
</Steps>

## 利用可能なツール

Shanoneは Asana向けに**115個のツール**を提供しており、以下のカテゴリに分類されています。

<AccordionGroup>
  <Accordion title="タスク">
    `asana_get_task`, `asana_list_tasks`, `asana_search_tasks`, `asana_create_task`, `asana_update_task`, `asana_complete_task`, `asana_assign_task`, `asana_add_comment`, `asana_delete_task`, `asana_add_tag`
  </Accordion>

  <Accordion title="サブタスク、依存関係 & フォロワー">
    `asana_get_subtasks`, `asana_create_subtask`, `asana_set_parent`, `asana_duplicate_task`, `asana_get_dependencies`, `asana_add_dependencies`, `asana_remove_dependencies`, `asana_get_dependents`, `asana_add_dependents`, `asana_remove_dependents`, `asana_get_task_followers`, `asana_add_followers`, `asana_remove_follower`
  </Accordion>

  <Accordion title="プロジェクト">
    `asana_list_projects`, `asana_create_project`, `asana_get_project`, `asana_update_project`, `asana_delete_project`, `asana_duplicate_project`, `asana_get_task_counts`, `asana_search_projects`, `asana_get_project_memberships`, `asana_add_members_for_project`, `asana_remove_members_for_project`, `asana_add_followers_for_project`, `asana_remove_followers_for_project`, `asana_get_project_statuses`, `asana_create_project_status`, `asana_get_project_templates`, `asana_instantiate_project`
  </Accordion>

  <Accordion title="セクション、タグ & タスク-プロジェクトの関連">
    `asana_get_sections`, `asana_get_section`, `asana_create_section`, `asana_update_section`, `asana_delete_section`, `asana_insert_section`, `asana_get_tags_for_workspace`, `asana_create_tag`, `asana_update_tag`, `asana_get_tags_for_task`, `asana_remove_tag_for_task`, `asana_get_tasks_for_tag`, `asana_get_projects_for_task`, `asana_add_project_for_task`, `asana_remove_project_for_task`, `asana_move_task_to_section`
  </Accordion>

  <Accordion title="ポートフォリオ & ゴール">
    `asana_get_portfolios`, `asana_get_portfolio`, `asana_create_portfolio`, `asana_update_portfolio`, `asana_delete_portfolio`, `asana_get_items_for_portfolio`, `asana_add_item_for_portfolio`, `asana_remove_item_for_portfolio`, `asana_get_goals`, `asana_get_goal`, `asana_create_goal`, `asana_update_goal`, `asana_delete_goal`, `asana_add_followers_for_goal`, `asana_remove_followers_for_goal`, `asana_get_parent_goals`, `asana_get_goal_relationships`, `asana_add_supporting_relationship`, `asana_remove_supporting_relationship`
  </Accordion>

  <Accordion title="チーム、ワークスペース & ユーザー">
    `asana_get_teams_for_workspace`, `asana_get_teams_for_user`, `asana_get_team`, `asana_create_team`, `asana_update_team`, `asana_get_team_memberships_for_team`, `asana_get_team_memberships_for_user`, `asana_add_user_for_team`, `asana_remove_user_for_team`, `asana_get_workspaces`, `asana_get_workspace`, `asana_update_workspace`, `asana_get_workspace_memberships_for_user`, `asana_get_workspace_memberships_for_workspace`, `asana_list_users`, `asana_get_user`, `asana_get_users_for_team`, `asana_get_users_for_workspace`, `asana_get_favorites_for_user`
  </Accordion>

  <Accordion title="カスタムフィールド、ストーリー & 時間管理">
    `asana_get_custom_fields_for_workspace`, `asana_get_custom_field`, `asana_create_custom_field`, `asana_get_stories`, `asana_get_story`, `asana_update_story`, `asana_delete_story`, `asana_get_time_tracking_entries_for_task`, `asana_create_time_tracking_entry`, `asana_get_time_tracking_entry`, `asana_update_time_tracking_entry`
  </Accordion>

  <Accordion title="添付ファイル、Webhook & バッチ">
    `asana_get_attachments_for_object`, `asana_get_attachment`, `asana_create_attachment`, `asana_delete_attachment`, `asana_get_webhooks`, `asana_get_webhook`, `asana_create_webhook`, `asana_delete_webhook`, `asana_create_batch_request`, `asana_typeahead_for_workspace`
  </Accordion>
</AccordionGroup>

## よくある使い方

<CardGroup cols={2}>
  <Card title="スプリント/タスクのトリアージ" icon="list-checks">
    プロジェクト内の期限超過・未割り当てタスクを検索し、担当者を割り振る
  </Card>

  <Card title="ゴール & ポートフォリオの集計" icon="target">
    ポートフォリオ配下のプロジェクトの進捗を、紐づくゴールと合わせてまとめる
  </Card>

  <Card title="チーム横断の依存関係マッピング" icon="git-branch">
    マイルストーンを再スケジュールする前に、タスクの依存関係・被依存関係を追跡する
  </Card>

  <Card title="時間管理レポート" icon="clock">
    タスクやプロジェクトの時間管理エントリを取得し、請求やキャパシティのレポートを作成する
  </Card>
</CardGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="asana_create_taskがカスタムフィールドの値不正で失敗する">
    (enum/ドロップダウン型の)カスタムフィールドのオプションIDは、`asana_get_custom_field`が返す値と完全に一致させる必要があります — enum型フィールドには自由入力のテキストは使えません。
  </Accordion>

  <Accordion title="asana_search_tasksの結果が想定より少ない">
    Asanaの検索APIは一度に1つのワークスペース内のみを検索し、独自のフィールド制限ルールがあります。`workspace`パラメータがそのプロジェクトの実際のワークスペースと一致しているか確認してください。
  </Accordion>

  <Accordion title="asana_create_webhookは成功するがイベントが届かない">
    Asanaは作成直後にWebhook先へのハンドシェイクリクエストへの即時応答を求めます — エンドポイントがハンドシェイクを完了できない場合、Asanaは黙ってWebhookを無効化します。
  </Accordion>
</AccordionGroup>