アーキテクチャ更新 (1.13.0)
状態: draft / バージョン: 1.13.0 (2026-02-11)
TL;DR
HITLに必要とされるステートフルな一時停止/再開メカニズムをサポートし、イベント購読APIを提供するため、私たちは実行エンジンをリファクタリングしました。具体的には、ワークフローベースのストリーミング実行と高度なチャット実行は現在Celeryワーカーで実行されます。一方、非ストリーミングのWORKFLOW実行は引き続きAPIプロセスで実行されます…
想定読者
- Dify 1.13.0 へのアップグレードを検討しているチーム
- Architecture Updates 周辺の機能を業務で使うエンジニア／運用者
なぜ重要か
(執筆予定: この機能が解決する課題と運用上のインパクトを書く)
リリースノート抜粋
HITLで要求されるステートフルな一時停止/再開メカニズムをサポートし、イベント購読APIを提供するために、実行エンジンをリファクタリングしました。Workflowベースのストリーミング実行と高度なチャット実行は現在Celeryワーカーで実行されますが、非ストリーミングのWORKFLOW実行は引き続きAPIプロセスで実行されます。
すべての一時停止/再開パス（例: HITL）はCeleryを介して再開され、イベントはRedis Pub/Subを通じてストリーミングで返されます。
大規模デプロイメントおよびセルフホストユーザー向け:
workflow_based_app_executionという名前の新しいCeleryキューを導入しました。標準的なセットアップはすぐに動作しますが、高スループット環境では、安定性とパフォーマンスを確保するために以下の最適化を検討すべきです。
- ワーカーのスケール: 特定のワークロードに基づいて、
workflow_based_app_executionキューを消費するワーカーの数を調整してください。 - 専用Redis (オプション): 大規模デプロイメントの場合、新しい
PUBSUB_REDIS_URL環境変数を設定し、専用のRedisインスタンスを指すようにすることを推奨します。水平スケーラビリティを確保するために、Sharded PubSubを備えたRedis Clusterモードの使用を強くお勧めします。
アウトライン（執筆予定）
1. これまでの課題
(執筆予定)
2. 1.13.0 で何が変わったか
(執筆予定 — 上記抜粋を整理)
3. 使い方 / 設定手順
(執筆予定)
4. 運用上の注意点・トレードオフ
(執筆予定)
5. 関連リンク
(執筆予定)
検証が必要な事項
- [ ] 関連 PR 番号の特定
- [ ] 公式 Docs の該当ページ
- [ ] 実際の挙動確認（Dify Cloud or self-host）
- [ ] 既知の制限事項
ソース:
- GitHub Release 1.13.0
本記事は非公式まとめです。正式仕様は Dify 公式ドキュメント をご確認ください。