任務

任務

任務功能在執行進入佇列之前定義意圖層級提供者工作請求。 它為您提供了明確的編排控制，因此可以確定性地建立、檢查和觸發收件匣操作。

為什麼這很重要

此功能透過使任務記錄所請求工作的真實來源，將業務意圖與佇列執行細節分開。它支援作業扇出先前的明確觸發和可審核性，從而在自動化需要介入時保持操作員控制清晰。

核心流程

客戶端建立一個具有類型、目標和負載的任務，然後使用該記錄作為執行的規範意圖。觸發後，將從任務建立佇列作業，後續讀取反映任務狀態和連結的作業結果。

操作

| 營運 | 端點 | 目的 | | -------- | --------------------------------------------- | -------------------------- | ------------------ | | 建立任務 | POST /api/accounts/:account_id/tasks | 註冊新的帳戶範圍的任務意圖 | | 列出任務 | GET /api/accounts/:account_id/tasks | 取得帳戶的任務時間表 | | 搜尋任務 | POST /api/accounts/:account_id/tasks/search | 按類型/狀態篩選器查詢任務 | | 取得任務 | GET /api/tasks/:task_id | 檢索一項任務 | | 更新任務 | PATCH /api/tasks/:task_id | 修改可變任務欄位 | | 刪除任務 | DELETE /api/tasks/:task_id | 刪除任務 | | 觸發任務 | POST /api/tasks/:task_id/trigger | 從任務 | 開始或重新啟動執行 |

關鍵數據和狀態

{
  id: "tsk_...",
  account_id: "acc_...",
  task_type: "imap_sync_messages",
  target_credential_id: "pc_...",
  payload: { folder: "INBOX" },
  priority: 0
}

故障模式與控制

在佇列執行開始之前，無效的任務負載或目標參考將被拒絕。觸發操作是明確的並且是任務範圍的，帳戶存取檢查適用於建立/讀取/改變邊界，且任務刪除不會作為不相關作業清理的副作用而發生。

相關

任務、作業、08-任務與手動觸發。