Asana

• 您希望 AI 代理根據事件或使用者請求來建立或更新 Asana 任務與專案。
• 您需要以程式化方式查詢跨專案和工作區的任務狀態、指派對象或截止日期。
• 您希望設定 Asana webhooks，以便在任務變更時通知外部系統。
• 您正在建立工作流程自動化，可在不自行管理 OAuth 憑證的情況下讀取或寫入 Asana。

• 您需要與 Asana 以外的第三方應用程式整合——請改用 api-gateway skill。
• 您的 Asana 方案為免費版，且您需要進階搜尋功能（任務搜尋需要 Asana Premium 訂閱）。

所有請求均透過 Maton 閘道（gateway.maton.ai）進行代理，該閘道會自動注入您的 Asana OAuth 權杖。您只需提供單一的 MATON_API_KEY，無需進行 OAuth 設定、權杖刷新邏輯或憑證儲存。

在任何專案中建立、讀取、更新及刪除任務。支援依指派人、完成日期及專案 GID 進行篩選，並可在任何父任務下建立及列出子任務。

列出、建立、更新及刪除工作區內的專案。透過程式化方式新增或移除使用者，以管理工作區成員資格。

依工作區、團隊或個別 GID 擷取使用者。使用 /users/me 端點查詢目前已驗證的使用者。

建立、列出、更新及刪除 Asana webhooks，以便在任務或專案發生變更時接收即時通知。支援依資源類型、動作及特定欄位進行篩選。

透過 offset 參數，使用 Asana 的原生基於游標的分頁機制來處理大型結果集。回應中包含 next_page 物件，以便輕鬆進行迭代。

AI 代理收到使用者請求（例如：「建立一個任務，讓 Alice 在星期五前審閱 Q2 報告」），並呼叫此技能，在正確的 Asana 專案中以正確的負責人和截止日期建立任務——無需手動輸入。

代理程式查詢專案中的所有任務，依完成狀態與截止日期進行篩選，並為團隊站立會議生成自然語言的狀態摘要或儀表板更新。

當另一個系統中的工單關閉時，客服人員可使用此技能將 Asana 中對應的任務標記為已完成，並新增完成備註，以保持兩個系統的同步。

代理程式在 Asana 專案上註冊一個 webhook，使得每當任務的截止日期或完成狀態發生變更時，下游管線會自動被觸發。