バージョン管理
はじめに
バージョン管理とは、Difyのチャットフローやワークフロー管理インターフェースの核となる機能です。この機能により、ユーザーはアプリの複数バージョンを効率的に管理および公開することができます。
バージョン管理機能を使用することで、ユーザーは下書きバージョンと公開バージョンを明確に区別し、必要に応じて過去のバージョンにロールバックすることが可能です。これにより、アプリの改良と管理がより簡単で直感的になり、継続的な更新と安定性が確保されます。
関連用語の説明
下書きバージョン(Current Draft): Difyのチャットフローやワークフロー管理インターフェースにおいて、現在の作業状態を示す唯一のバージョンです。ユーザーはこのバージョンでチャットフローやワークフローの編集、修正、プレビューを行うことができます。

公開バージョン(Published Version): ユーザーがオンラインに公開したすべてのバージョンの総称です。最新の公開バージョンと過去の公開バージョンの総称です。公開操作を実行するたびに、新しい公開バージョンが生成されます。
最新公開バージョン(Latest Version): ユーザーが最後にオンラインに公開したバージョンです。Difyのバージョン管理インターフェースでは、これを
Latest
としてマークし、他の過去の公開バージョンと区別しています。

過去の公開バージョン(Previous Version): 以前に公開されたが、現在は最新ではなくなったバージョンを指します。

バージョンの復元(Restore): バージョン管理の復元機能を使用すると、アプリを特定の過去のバージョンに戻すことができます。

主な機能
バージョン一覧の表示: バージョン管理インターフェースで、公開されたすべてのバージョンとその詳細情報を確認できます。
バージョンの検索: フィルター機能を使用して、必要なバージョンを素早く見つけることができます。
新バージョンの公開: 新しいアプリバージョンを公開し、名前と説明を付けることができます。
公開バージョン情報の編集: 公開済みバージョンの名前や説明を後から編集することができます。
過去バージョンの削除: 不要になった過去のバージョンを削除し、バージョンリストを整理できます。
過去バージョンへのロールバック: バージョン復元機能を使用して、過去のバージョンの内容を下書きに読み込み、必要に応じて修正することができます。
バージョン一覧の表示方法
右上のバージョン管理ボタンをクリックして、バージョン管理インターフェースにアクセスします。

バージョン管理インターフェースには、時系列の降順で並べられたバージョンリストが表示されます。各バージョンの名前、説明情報、公開日時、公開者を確認できます。
(オプション) バージョンリストが多数ある場合は、さらに読み込むボタンをクリックすると、より多くのバージョン履歴を表示できます。

特定のバージョンを検索する方法
自分が公開したバージョンを探す: フィルターボタンをクリックするとフィルターオプションが表示されます。以下の2つの選択肢があります:
すべてのバージョン: あなた自身と他のユーザーが公開したすべてのバージョンを表示します。
自分が公開したバージョン: あなたが公開したバージョンのみを表示します。 必要に応じて、適切なフィルターを選択して、対応するバージョンをご確認いただけます。
All or only yours 名前付きバージョンを検索: 名前が付けられたバージョンのみを表示したい場合は、名前付きバージョンを検索オプションをクリックしてください。このオプションを有効にすると、名前付きバージョンのみがバージョンリストに表示され、名前のないバージョンは非表示になります。

新しいバージョンの公開方法
チャットフロー/ワークフローの作成が完了したら、画面右上の公開する > 公開更新をクリックすると、現在のバージョンが公開されます。

公開後、この最新バージョンは
Latest
としてマークされ、関連情報がバージョン管理インターフェースに表示されます。

公開済みバージョンの情報編集方法
バージョン管理インターフェースで、編集したいバージョンを見つけ、そのバージョンの右上にあるアクションメニューをクリックします。
以前にデフォルト名でバージョンを保存した場合は、このバージョンに名前を付けるをクリックします。

すでに名前を付けている場合は、バージョン情報を編集をクリックして、バージョン名と説明を修正できます。

公開するをクリックして、バージョン情報を公開します。

履歴バージョンを削除するには?
バージョン管理画面で、削除したい公開済みバージョンを見つけ、そのバージョンの右上にある操作メニューをクリックします。
削除を選択すると、確認ダイアログが表示されます。

削除をクリックすると、そのバージョンがバージョン管理画面から削除されます。

下書きバージョン(Current Draft)は、現在のチャットフロー/ワークフロー画面で編集中のバージョンであり、削除できません。
最新公開バージョン(「Latest」とマークされているバージョン)は、ユーザーが最後に公開したバージョンであり、削除できません。
特定の公開済みバージョンに戻すには?
バージョン管理画面で、ロールバックしたい履歴バージョンを見つけ、そのバージョンの右上にある操作メニューをクリックします。
ロールバックを選択すると、確認ダイアログが表示されます。

ロールバックをクリックすると、現在の下書きバージョンがその履歴バージョンに置き換えられます。

使用シナリオ
以下では、典型的なユースケースを通じて、各バージョン間の関係を説明します。
同じ色は同じバージョン内容を表します。
ステージ1
システムが自動的に下書きバージョン Version Aを作成します。

ステージ2:初回公開
Version Aが公開され、最新公開バージョンになります。
システムが自動的に下書きバージョン Version Bを作成します。

ステージ3:再公開
Version Bが公開され、最新公開バージョンになります。
Version Aは履歴公開バージョンになります。
システムが自動的に下書きバージョン Version Cを作成します。

ステージ4:ロールバック操作
Version Aが下書きバージョンとして復元され、Version Cが上書きされます。
Version Bは引き続き最新公開バージョンです。

ステージ5:ロールバック後の公開
復元されたVersion Aが公開され、最新公開バージョンになります。
以前のVersion AとVersion Bは履歴公開バージョンになります。
システムが自動的に下書きバージョン Version Dを作成します。

全体フロー

よくある質問
下書きバージョン、公開済みバージョン、最新公開バージョン、履歴公開バージョンの違いは何ですか?
下書きバージョン
編集・修正を行い、公開(Publish)操作でオンライン環境に反映させることができます。
不可(公開操作後のみアクセス可能)
削除できません。
ロールバックできません。
最新公開バージョン
直接編集はできません。新しいドラフトバージョンを作成し、公開することで更新できます。
可能(現在のオンラインバージョン)
削除できません。
可能
過去の公開バージョン
ロールバック(Restore)操作で過去のバージョンをドラフトバージョンに読み込み、編集・公開できます。
不可(バージョンリストにのみ存在)
削除できません。
可能
公開済みバージョン
最新公開バージョンと過去の公開バージョンの総称です。
-
-
-
よくある質問
履歴バージョンへのロールバック後、現在の下書きは消えてしまいますか?
履歴バージョンにロールバックすると、選択したバージョンが新しい下書きとして自動的に作成されます。この下書きで編集を行い、公開することができます。
そのため、ロールバック操作を行うと、既存の下書きは失われますのでご注意ください。
バージョン管理機能は、どのタイプのアプリで利用できますか?
現在、バージョン管理機能はチャットフローとワークフローのみ対応しています。チャットボット、テキスト生成、エージェントには対応していません。
Last updated