バージョン管理

はじめに

バージョン管理とは、Difyのチャットフローやワークフロー管理インターフェースの核となる機能です。この機能により、ユーザーはアプリの複数バージョンを効率的に管理および公開することができます。

バージョン管理機能を使用することで、ユーザーは下書きバージョンと公開バージョンを明確に区別し、必要に応じて過去のバージョンにロールバックすることが可能です。これにより、アプリの改良と管理がより簡単で直感的になり、継続的な更新と安定性が確保されます。

関連用語の説明

• 下書きバージョン（Current Draft）： Difyのチャットフローやワークフロー管理インターフェースにおいて、現在の作業状態を示す唯一のバージョンです。ユーザーはこのバージョンでチャットフローやワークフローの編集、修正、プレビューを行うことができます。

Current draft

• 公開バージョン（Published Version）： ユーザーがオンラインに公開したすべてのバージョンの総称です。最新の公開バージョンと過去の公開バージョンの総称です。公開操作を実行するたびに、新しい公開バージョンが生成されます。

• 最新公開バージョン（Latest Version）： ユーザーが最後にオンラインに公開したバージョンです。Difyのバージョン管理インターフェースでは、これをLatestとしてマークし、他の過去の公開バージョンと区別しています。

Latest version

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

Previous version

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

Restore feature

主な機能

• バージョン一覧の表示： バージョン管理インターフェースで、公開されたすべてのバージョンとその詳細情報を確認できます。

• バージョンの検索： フィルター機能を使用して、必要なバージョンを素早く見つけることができます。

• 新バージョンの公開： 新しいアプリバージョンを公開し、名前と説明を付けることができます。

• 公開バージョン情報の編集： 公開済みバージョンの名前や説明を後から編集することができます。

• 過去バージョンの削除： 不要になった過去のバージョンを削除し、バージョンリストを整理できます。

• 過去バージョンへのロールバック： バージョン復元機能を使用して、過去のバージョンの内容を下書きに読み込み、必要に応じて修正することができます。

バージョン一覧の表示方法

1. 右上のバージョン管理ボタンをクリックして、バージョン管理インターフェースにアクセスします。

View all versions

1. バージョン管理インターフェースには、時系列の降順で並べられたバージョンリストが表示されます。各バージョンの名前、説明情報、公開日時、公開者を確認できます。

2. （オプション） バージョンリストが多数ある場合は、さらに読み込むボタンをクリックすると、より多くのバージョン履歴を表示できます。

Load more

特定のバージョンを検索する方法

• 自分が公開したバージョンを探す： フィルターボタンをクリックするとフィルターオプションが表示されます。以下の2つの選択肢があります：

  • すべてのバージョン： あなた自身と他のユーザーが公開したすべてのバージョンを表示します。

  • 自分が公開したバージョン： あなたが公開したバージョンのみを表示します。 必要に応じて、適切なフィルターを選択して、対応するバージョンをご確認いただけます。

  

  All or only yours
• 名前付きバージョンを検索: 名前が付けられたバージョンのみを表示したい場合は、名前付きバージョンを検索オプションをクリックしてください。このオプションを有効にすると、名前付きバージョンのみがバージョンリストに表示され、名前のないバージョンは非表示になります。

Only show named versions

新しいバージョンの公開方法

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

Publish new version

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

Latest version marked

公開済みバージョンの情報編集方法

1. バージョン管理インターフェースで、編集したいバージョンを見つけ、そのバージョンの右上にあるアクションメニューをクリックします。

• 以前にデフォルト名でバージョンを保存した場合は、このバージョンに名前を付けるをクリックします。

Name this version

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

Edit version info

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

Edit version info

履歴バージョンを削除するには？

1. バージョン管理画面で、削除したい公開済みバージョンを見つけ、そのバージョンの右上にある操作メニューをクリックします。

2. 削除を選択すると、確認ダイアログが表示されます。

Delete version

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

Delete Version Confirmed

• 下書きバージョン（Current Draft）は、現在のチャットフロー/ワークフロー画面で編集中のバージョンであり、削除できません。

• 最新公開バージョン（「Latest」とマークされているバージョン）は、ユーザーが最後に公開したバージョンであり、削除できません。

特定の公開済みバージョンに戻すには？

1. バージョン管理画面で、ロールバックしたい履歴バージョンを見つけ、そのバージョンの右上にある操作メニューをクリックします。

2. ロールバックを選択すると、確認ダイアログが表示されます。

Restore version

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

Restore version confirmed

使用シナリオ

以下では、典型的なユースケースを通じて、各バージョン間の関係を説明します。

同じ色は同じバージョン内容を表します。

ステージ1

• システムが自動的に下書きバージョン Version Aを作成します。

Phase 1

ステージ2：初回公開

• Version Aが公開され、最新公開バージョンになります。

• システムが自動的に下書きバージョン Version Bを作成します。

Phase 2

ステージ3：再公開

• Version Bが公開され、最新公開バージョンになります。

• Version Aは履歴公開バージョンになります。

• システムが自動的に下書きバージョン Version Cを作成します。

Phase 3

ステージ4：ロールバック操作

• Version Aが下書きバージョンとして復元され、Version Cが上書きされます。

• Version Bは引き続き最新公開バージョンです。

Phase 4

ステージ5：ロールバック後の公開

• 復元されたVersion Aが公開され、最新公開バージョンになります。

• 以前のVersion AとVersion Bは履歴公開バージョンになります。

• システムが自動的に下書きバージョン Version Dを作成します。

Phase 5

全体フロー

Workflow

よくある質問

• 下書きバージョン、公開済みバージョン、最新公開バージョン、履歴公開バージョンの違いは何ですか？

定義	操作方法	オンラインアクセス	削除可能か	ロールバック可能か
下書きバージョン	編集・修正を行い、公開（Publish）操作でオンライン環境に反映させることができます。	不可（公開操作後のみアクセス可能）	削除できません。	ロールバックできません。
最新公開バージョン	直接編集はできません。新しいドラフトバージョンを作成し、公開することで更新できます。	可能（現在のオンラインバージョン）	削除できません。	可能
過去の公開バージョン	ロールバック（Restore）操作で過去のバージョンをドラフトバージョンに読み込み、編集・公開できます。	不可（バージョンリストにのみ存在）	削除できません。	可能
公開済みバージョン	最新公開バージョンと過去の公開バージョンの総称です。	-	-	-

よくある質問

• 履歴バージョンへのロールバック後、現在の下書きは消えてしまいますか？

履歴バージョンにロールバックすると、選択したバージョンが新しい下書きとして自動的に作成されます。この下書きで編集を行い、公開することができます。

そのため、ロールバック操作を行うと、既存の下書きは失われますのでご注意ください。

• バージョン管理機能は、どのタイプのアプリで利用できますか？

現在、バージョン管理機能はチャットフローとワークフローのみ対応しています。チャットボット、テキスト生成、エージェントには対応していません。