Temporalによるナレッジ更新の同時実行制御

url: https://tech.layerx.co.jp/entry/2026/05/14/173940 date: 2026-05-14 topics: ai-agent-implementation, ai-llm, corporate-engineering tier: Tier2（企業技術ブログ・設計解説）

要約

LayerXバクラクヘルプデスクエージェントで、Notion/Google Drive同期・削除・日次バッチなど複数経路からのナレッジ更新の同時実行制御をTemporalで実現。Workflow IDにパス構造を持たせてプレフィックス検索で削除時に関連同期を一括キャンセルする設計を採用。

主要な主張

• Entity Workflow + Signalキューは長寿命ワークフローのバージョニング・履歴上限・削除待機の問題があり不採用
• 採用設計：Workflow IDにフォルダ/ページのパス構造を付与（例：folder/{id}/page/{id}/sync）
• 同期の重複排除：ページ同期は固定ID（Temporalが自動スキップ）、フォルダ同期はユニークID（並列実行許容）
• 削除時：プレフィックス検索＋一括キャンセルで即座に削除処理へ移行
• CancellationScope.nonCancellable()でキャンセル時の後処理を保護し整合性を維持

Tier判定

Tier2 - LayerX技術ブログ（設計解説）