このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。アプリをエクスポートすると、コピーを手元に残したり、他の人に渡したり、別の Dify インスタンスやワークスペースに移したりできます。エクスポートしたアプリは、アプリパッケージ(
.ifpkg ファイル)になります。
アプリパッケージをインポートすると、新しいアプリを作成できます。既存のアプリを更新することもでき、たとえばテスト済みで本番公開の準備が整ったバージョンに置き換えられます。
同じワークスペース内でアプリをコピーするだけなら、アプリのメニューから 複製 を選択してください。
- アプリのエクスポートとインポートには、エディター以上のロールが必要です。
- パッケージに、アプリがツールとして呼び出すワークフローが含まれている場合、インポートにはオーナーまたは管理者のロールが必要です。ただし、このワークスペースからエクスポートしたパッケージで、元のツールがまだ残っている場合は除きます。
アプリのエクスポート
アプリまたは Agent のカードのメニューから、アプリをエクスポート または エージェントをエクスポート をクリックします。アプリや Agent を開いている場合は、左上のメニューからも操作できます。 Workflow、Chatflow、新しい Agent の場合、エクスポートされるのは現在のドラフトで、未公開の変更も含まれます。公開済みのバージョンをエクスポートするには、バージョン履歴 を開きます。そのバージョンのメニューから アプリをエクスポート または エージェントをエクスポート を選択します。 その他のアプリタイプでは、最後に公開した設定がエクスポートされます。エクスポートに含まれないもの
アプリを構成するものは、次を除いてすべてエクスポートされます:- 使用している統合(インポート時に、不足しているものをワンクリックでまとめてインストールできます)
- 関連付けたナレッジベース
- Swagger API と MCP のツール、および新しい Agent または新しい Agent ノードで使用するワークフローツール
- Agent の ファイルシステム にある永続ファイル(ビルドモードでインストールしたプログラムなど)
- サービス API キー
- モデルとツールの認証情報
- ログと注釈
- 過去のバージョン
- インテグレーショントリガーのサブスクリプション
シークレット値をエクスポートするかの選択
Secret 型の環境変数を持つ Workflow や Chatflow をエクスポートする際は、その値を含めるかどうかを選択できます。バージョン履歴からのエクスポートには、シークレット値は一切含まれません。
インポートによる新しいアプリの作成
スタジオ または Agents で、作成 > アプリをインポート をクリックします。 この操作では必ず新しいアプリが作成され、独自の Web アプリ URL が割り当てられます。既存のアプリには影響しません。既存の Workflow や Chatflow に取り込みたい場合は、代わりに そのアプリを更新 してください。Web アプリ URL と API キーはそのまま維持されます。 インポート後、エクスポートに 含まれないもの のうち、新しいアプリに必要なものを設定してください。インポートによる既存アプリの更新
Workflow または Chatflow を開き、アプリの左上のメニューまたはキャンバスの右クリックメニューから アプリをインポート をクリックします。アプリパッケージは、Workflow または Chatflow からエクスポートしたもので、そのアプリで使えるノードだけを含んでいる必要があります。Workflow には回答ノードを、Chatflow には出力ノードやトリガーノードを含めることはできません。 インポートすると、ドラフトに加えて、アプリの名前、説明、アイコンが置き換わります。アプリ自体は同じままで、ログ、注釈、API キー、Web アプリと MCP サーバーの URL も変わりません。更新したドラフトを公開するまで、ユーザーには公開済みのバージョンが提供され続けます。 アプリパッケージにシークレット値が含まれていない場合は、公開前に入力し直してください。以前の Dify バージョンへのインポート
Dify 1.19.0 以降でエクスポートしたアプリパッケージは、1.19.0 以降にのみインポートできます。対象は Workflow、Chatflow、チャットボット、レガシー Agent、テキストジェネレーターのアプリです。1.18.x からエクスポートしたアプリパッケージは、1.18.0 以降にインポートできます。 以前の Dify バージョンにアプリを取り込むには、パッケージ(ZIP ファイル)を展開し、中にあるapp.yaml DSL ファイルだけをインポートします。
Web アプリ設定やアップロードしたアイコンなど、一部の設定は引き継がれません。インポート後に確認し、設定し直してください。
パッケージに含まれるワークフローツールも引き継がれません。アプリを実行する前に、ツールとして呼び出すワークフローをインポート先のワークスペースで用意してください。
新しい Agent ノード を使用するワークフローは、Dify 1.18.0 以降にのみインポートできます。