タスク (機能) | Inbox Manager API ドキュメント

Tasks

タスク機能は、実行がキューに入る前に、インテントレベルのプロバイダー作業リクエストを定義します。これにより、明示的なオーケストレーション制御が可能になるため、受信トレイの操作を決定的に作成、検査、トリガーできます。

なぜこれが重要なのか

この機能は、タスクレコードを要求された作業の信頼できる情報源にすることで、ビジネスの意図をキューの実行の詳細から分離します。ジョブのファンアウト前の明示的なトリガーと監査機能をサポートしており、自動化の介入が必要な場合にオペレーターの制御を明確に保ちます。

コアフロー

クライアントは、タイプ、ターゲット、ペイロードを指定してタスクを作成し、そのレコードを実行の正規のインテントとして使用します。トリガーされると、キュージョブがタスクから作成され、後続の読み取りにはタスクの状態とリンクされたジョブの結果が反映されます。

操作

| Operation | エンドポイント | 目的 | | ------------------ | --------------------------------------------- | ------------------------------------------------------ | -------------------------------- | | Create task | POST /api/accounts/:account_id/tasks | 新しいアカウントスコープのタスクインテントを登録する | | タスクをリストする | GET /api/accounts/:account_id/tasks | アカウントのタスクタイムラインを取得する | | タスクの検索 | POST /api/accounts/:account_id/tasks/search | タイプ/状態フィルターによるタスクのクエリ | | タスクを取得 | GET /api/tasks/:task_id | 1 つのタスクを取得する | | タスクを更新 | 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
}

故障モードと制御

無効なタスクペイロードまたはターゲット参照は、キューの実行が開始される前に拒否されます。トリガーアクションは明示的かつタスクスコープであり、アカウントアクセスチェックは境界の作成/読み取り/変更に適用され、無関係なジョブのクリーンアップの副作用としてタスクの削除は発生しません。

Tasks

なぜこれが重要なのか

コアフロー

操作

主要なデータと状態

故障モードと制御

関連