Dify でワークフローが呼び出す Workflow Tool の中で何が起きているか、今まで「Tool スパンが通った」「Tool スパンが失敗した」しか見えなかった。内部の LLM コールやステップが追えなかった。v1.19.0 でそれが変わった。

この記事で分かること：

Dify 1.19.0（2026-11-04 リリース）の3つの主要変更

ネストしたワークフロートレースの仕組みと実務での使い所

アップグレード前に確認すべき Docker Compose 2.35.0 以上の要件

Dify 1.19.0 は 2026-11-04 にリリースされた。変更の全容は公式リリースページ（https://github.com/langgenius/dify/releases/tag/1.19.0）で確認できる。大企業内で Dify Enterprise を使っている立場から、実務に直結する3か所を整理する。

1. ネストしたワークフロートレース（Nested Workflow Tracing）

変更内容：ワークフロー内で Workflow Tool を呼び出したとき、その内部のステップや LLM コールが外部トレース（Langfuse など）に階層構造で出るようになった。

今まで：

v1.19.0 以降：

注意点：

大企業内で Dify を使っていると、ワークフローが複数の Workflow Tool を呼び出す複雑な構成になることがある。今まで「どの Tool で詰まっているか」を切り分けるのに、ログをひとつひとつ確認する必要があった。ネストトレースが取れると、この調査時間が大きく変わる。

2. Workflow Tools の App パッケージへの同梱（.ifpkg v2）

変更内容：App をエクスポートすると、そのアプリが使っている Workflow Tools も一緒に .ifpkg パッケージに含まれるようになった。

今まで：

v1.19.0 以降：

重要な注意：すべての Dify App エクスポートが format v2 になった。古い v1 のインポーターは受け付けない可能性がある。インポート先も 1.19.0 以上に揃えてからパッケージをインポートすること。

複数の Dify 環境（開発・ステージング・本番）を使っている場合に、この変更の影響が出る。移行の順序は「インポート先を先に 1.19.0 にアップグレードしてから、エクスポート・インポートを行う」という手順になる。

変更内容：difyctl に Skills を管理する6つのコマンドが追加された。

コマンド	操作
`difyctl get skill`	Skills の一覧（キーワード・タグフィルタあり）
`difyctl describe skill`	詳細・ドラフトハッシュ・最新版の確認
`difyctl get skill version`	公開済みバージョンの一覧
`difyctl export skill`	ドラフトまたは指定バージョンを ZIP でエクスポート
`difyctl import skill --files`	ローカルファイルから Skill を作成またはドラフトを置き換え
`difyctl publish skill`	ドラフトを新しいバージョンとして公開

注意点：

CI/CD に組み込んで Skill のバージョン管理をしたい場合に使える。今まで Skill の変更は GUI からしか行えなかったが、コマンドラインから操作できるようになったことで、自動化の幅が広がる。

変更内容：Docker Compose の最小必須バージョンが 2.35.0 になった。

これは .env ファイルの優先順位の解決方法が変わったことに関係している。root の .env オーバーライドが service のデフォルトより優先されるように動くには 2.35.0 以上が必要。

確認コマンド：

docker compose version

2.35.0 未満の場合はアップグレードしてから Dify 1.19.0 に更新する。

ローリングデプロイを行う場合は、トレースキューの移行手順が必要。新しいキュー ops_trace_v2 を、API・worker・Beat のすべてで同時に切り替える必要がある。古いキュー ops_trace のワーカーは、溜まっているタスクが空になってから停止する。

その他のアップグレード注意点：

v1.19.0 の変更のうち、企業 Dify 運用に直結するのは次の3点：

Dify の活用場面や設計についてはこちらでも書いている：
Copilotで議事録を作るとき、事前にやること