> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 履歴とバージョン

> ワークフローのバージョン履歴と実行履歴について学ぶ

## 概要

Jinba Flowは、ワークフローのバージョンを自動的に追跡し、完全な実行履歴を維持します。これにより、過去の変更を表示し、以前のバージョンを復元し、ワークフロー実行パターンを分析できます。

## ワークフローバージョン

### バージョンとは？

ワークフローに重要な変更を加えるたびに、Jinba Flowは新しいバージョンを作成します：

* **自動バージョン管理**: 公開、復元、またはCopilotの変更を受け入れるときに自動的にバージョンが作成されます
* **バージョン履歴**: すべてのバージョンが保存され、ワークフローの進化を確認できます
* **バージョンラベル**: バージョンは目的を示すためにラベル付けされます（PUBLISH、RESTORE、COPILOT\_CHANGE\_ACCEPTION）

### バージョンのタイプ

#### 公開バージョン

現在公開され、APIまたはMCP経由でアクセス可能なバージョン：

* **安定した参照**: ワークフローを編集しても、このバージョンは変更されません
* **APIアクセス**: 外部システムはこのバージョンを使用します
* **MCPツール**: AIアシスタントはワークフローを呼び出すときにこのバージョンを使用します

#### 現在/編集可能なバージョン

現在編集中のバージョン：

* **アクティブな開発**: これが作業中のバージョンです
* **未公開の変更**: まだ公開されていない変更がある場合があります
* **プレビューモード**: このバージョンを作業バージョンとして保持しながら、他のバージョンをプレビューできます

#### 以前のバージョン

ワークフロー履歴内の他のすべてのバージョン：

* **履歴記録**: すべてのワークフロー変更の完全な履歴
* **復元**: 現在の編集可能なバージョンに復元できます
* **比較**: 現在のバージョンと比較できます

## バージョン履歴の表示

### バージョンへのアクセス

1. フローエディタでワークフローを開く
2. **バージョン**パネルに移動（通常は右サイドバー）
3. すべてのワークフローバージョンのリストを表示

### バージョン情報

各バージョンは以下を表示：

* **作成日**: バージョンが作成された日時
* **ラベル**: バージョンのタイプ（PUBLISH、RESTORE、COPILOT\_CHANGE\_ACCEPTION）
* **ステータス**: 公開済み、現在、または以前のバージョンかどうか
* **ステップ**: その時点でのワークフローステップ

### バージョンのプレビュー

現在のバージョンにせずに、任意のバージョンをプレビューできます：

1. バージョンリストでバージョンをクリック
2. ワークフローエディタがそのバージョンのステップを表示
3. その時点でのワークフローの見た目を確認
4. 現在のバージョンを再度クリックしてプレビューモードを終了

**注意**: バージョンをプレビューしても、現在の編集可能なバージョンは変更されません。作業に影響を与えずにプレビューして比較できます。

## バージョンの復元

### 復元するタイミング

以前のバージョンを復元したい場合：

* **最近の変更が問題を引き起こした**: 最近の編集がワークフローを壊した
* **安定したバージョンに戻る**: 既知の動作するバージョンに戻る
* **誤った変更を元に戻す**: 意図しない変更から回復する

### 復元方法

1. **バージョン**パネルを開く
2. 復元したいバージョンを見つける
3. **復元**ボタン（または類似のアクション）をクリック
4. 復元を確認
5. 選択したバージョンが現在の編集可能なバージョンになります

**重要な注意事項**:

* 復元すると、ラベル「RESTORE」で新しいバージョンが作成されます
* 現在の編集可能なバージョンは履歴に保存されます
* 復元されたバージョンが作業バージョンになります
* 必要に応じて再度復元できます

## バージョンラベル

バージョンは、作成方法に基づいて自動的にラベル付けされます：

### PUBLISH

ワークフローを公開するときに作成：

* **目的**: 公開されたバージョンをマーク
* **安定性**: このバージョンはAPI/MCPアクセス用に安定したまま
* **更新**: 新しい公開で新しいPUBLISHバージョンが作成されます

### RESTORE

以前のバージョンを復元するときに作成：

* **目的**: 履歴から復元されたバージョンをマーク
* **回復**: 以前の状態に戻ったことを示します
* **履歴**: 履歴に復元アクションを保存します

### COPILOT\_CHANGE\_ACCEPTION

Copilotが提案した変更を受け入れるときに作成：

* **目的**: AI支援によって作成されたバージョンをマーク
* **コラボレーション**: AI支援によるワークフロー改善を追跡
* **学習**: AI提案のパターンを特定するのに役立ちます

## 実行履歴

### 実行履歴とは？

実行履歴はすべてのワークフロー実行を追跡します：

* **完全な記録**: すべてのワークフロー実行が記録されます
* **バージョン追跡**: 各実行は実行されたバージョンにリンクされます
* **パフォーマンスデータ**: 実行時間と結果が追跡されます
* **エラーログ**: 失敗した実行にはエラー詳細が含まれます

### 実行履歴の表示

1. ワークフローに移動
2. **実行**または**履歴**タブを開く
3. すべての実行の時系列リストを表示

### 実行情報

各実行は以下を表示：

* **実行日**: ワークフローが実行された日時
* **ステータス**: 成功、失敗、または進行中
* **バージョン**: 実行されたワークフローバージョン
* **実行時間**: ワークフローの実行にかかった時間
* **入力**: ワークフローに渡された引数
* **出力**: 実行からの結果
* **エラー**: 発生したエラー（失敗した場合）

### 実行履歴のフィルタリング

実行履歴を以下でフィルタリングできます：

* **ステータス**: 成功、失敗、または実行中の実行のみを表示
* **日付範囲**: 実行が発生した日時でフィルタリング
* **バージョン**: 特定のバージョンの実行を表示
* **ソース**: ワークフローがどのようにトリガーされたかでフィルタリング（手動、API、スケジュールなど）

## デバッグのための履歴の使用

### バージョン比較

異なるバージョンを比較して変更を理解：

1. 以前のバージョンをプレビュー
2. 現在のバージョンと比較
3. バージョン間の変更を特定
4. 変更の影響を理解

### 実行分析

実行履歴を使用して：

* **パターンの特定**: 繰り返し発生する問題や成功を見つける
* **パフォーマンス追跡**: どのバージョンがより良いパフォーマンスを示したかを確認
* **エラー分析**: 失敗した実行を確認して問題を特定
* **使用パターン**: ワークフローがどのように使用されているかを理解

### ワークフローのデバッグ

1. **問題のあるバージョンを特定**: 問題がいつ始まったかを特定
2. **バージョンを比較**: 動作するバージョンと壊れたバージョンの間の変更を確認
3. **実行を確認**: そのバージョンの実行履歴を確認
4. **必要に応じて復元**: 現在のバージョンに問題がある場合は、動作するバージョンを復元

## ベストプラクティス

1. **定期的な公開**: チェックポイントを作成するために定期的に安定したバージョンを公開
2. **意味のある変更**: 新しいバージョンを作成する前に重要な変更を行う
3. **バージョン確認**: 進化を理解するために定期的にバージョン履歴を確認
4. **実行監視**: 問題がないか定期的に実行履歴を確認
5. **戦略的な復元**: 必要に応じて復元を使用するが、新しいバージョンが作成されることを理解
6. **変更の文書化**: ワークフローの説明またはノートパッドを使用して主要な変更を文書化

## バージョン管理

### バージョンのライフサイクル

1. **作成**: 重要なアクションで自動的にバージョンが作成される
2. **開発**: 現在の編集可能なバージョンが作業場所
3. **公開**: 公開により安定したPUBLISHバージョンが作成される
4. **履歴**: すべてのバージョンが履歴に保存される
5. **復元**: 以前のバージョンを復元できる

### バージョン制限

* **ストレージ**: すべてのバージョンが無期限に保存される
* **アクセス**: 履歴内の任意のバージョンにアクセスできる
* **パフォーマンス**: 大きなバージョン履歴は読み込みに時間がかかる場合がある

## 関連機能

* [公開](/ja/pages/basics/publish) - ワークフローの公開について学ぶ
* [デバッグ](/ja/pages/basics/debug) - ワークフローのデバッグについて学ぶ
* [アーカイブ機能](/ja/pages/basics/archive) - ワークフローのアーカイブについて学ぶ