> For the complete documentation index, see [llms.txt](https://studio-docs.japan-ai.co.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.japan-ai.co.jp/ruworkflowto/debug-workflow-run-history.md).

# Workflowの実行履歴でデバッグする

Workflowが期待どおりに動かないときは、**実行履歴**で各ノードの入力・出力を確認し、問題のある箇所を特定します。この記事では、履歴の探し方、詳細の読み方、原因の絞り込み、失敗した実行の再実行を説明します。

* 下書きのテスト：[Workflowの下書きをテストする](/ruworkflowto/test-workflow-drafts.md)
* 利用者として結果を確認する場合：[公開済みWorkflowを実行する](/u/run-published-workflow.md)

## 実行方法に対応する履歴を使う

Workflowの履歴は、確認したい版によって見る場所が異なります。

| 見る場所                         | 対象                     | 主な用途            |
| ---------------------------- | ---------------------- | --------------- |
| 編集画面の「実行履歴」                  | 編集画面から実行した下書きのテスト      | 公開前の動作確認        |
| Project設定の「タスクスケジューラ」にある「履歴」 | Projectのタスクスケジューラからの実行 | タスクの日時・状態・結果の確認 |
| Projectのワークフローにある「実行履歴」      | 公開版のWorkflow実行         | 公開後の不具合調査       |

> 編集画面でのテスト実行は、公開版やタスクの履歴とは区別して確認します。どの履歴に表示されるかは、実行した入口・権限・Workflowの構成により異なります。

## 始める前に

* 調べたい実行の、おおよその日時・実行者・起動方法（手動／トリガー）を確認します。
* 実行履歴を閲覧できる権限があることを確認します。見られる範囲は組織やProjectの設定によって異なります。
* 実行の入力・出力には、メール本文や顧客情報などの機密情報が含まれることがあります。画面共有やファイルの受け渡しの範囲に注意してください。

## 1. 対象の実行を探す

### Projectのタスクスケジューラから確認する場合

1. 対象Projectの設定で「タスクスケジューラ」を開きます。
2. 「履歴」タブを選びます。
3. タスク名、日時、状態を照合して、調べる実行を特定します。
4. Workflowの結果へのリンクが表示される場合は、リンクから実行の詳細を確認します。

### Workflowの実行ログから確認する場合

対象Projectのワークフロー画面で「実行履歴」を開きます。Workflow名、日時、実行者、状態で対象を絞り込みます。実行ログには公開版の実行が表示され、編集画面からの下書きテストは含まれません。

実行者が「自動実行」と表示される実行は、トリガーやスケジュールなど、人が直接操作していない起動です。

## 2. 実行の詳細を読む

対象の実行を選ぶと「ログの詳細」が開きます。

| 表示   | 確認すること                    |
| ---- | ------------------------- |
| 概要   | ステータス、経過時間、クレジット、エラーメッセージ |
| 結果   | Workflowの最終出力             |
| ステップ | 実行されたノードの順序と、各ノードの入力・出力   |

### ステータスの読み方

* **成功**：処理が最後まで完了したことを示します。**業務上正しい結果であることの保証ではありません。** 出力の内容も確認してください。
* **失敗**：途中のノードでエラーが発生しました。エラーメッセージと、ステップでの失敗箇所を確認します。
* **部分的成功**：一部の処理が完了していない可能性があります。どのノードまで期待どおりかをステップで確認します。
* **停止**：途中で停止されました。停止前に完了した処理が残っている場合があります。

## 3. 問題のあるノードを特定する

ステップを最初のノードから順に確認し、**値が最初に想定と異なったノード**を探します。エラーが出たノードより前に、原因があることがよくあります。

1. 開始ノードの出力（入力値やイベントの情報）が想定どおりか確認します。
2. 次のノードの入力に、前のノードの出力が正しく渡っているか確認します。
3. 各ノードの出力が、次の処理に必要な形式になっているか確認します。
4. 最初に想定と異なったノードを、修正の対象にします。

### よくある原因

| 症状                 | 考えられる原因                   | 確認先                                                                               |
| ------------------ | ------------------------- | --------------------------------------------------------------------------------- |
| 入力が空になっている         | 変数の参照先の誤り、別の経路の変数を参照している  | [Workflowの変数・分岐を設定する](/ruworkflowto/configure-workflow-variables-and-branches.md) |
| 想定と違う分岐に進んだ        | 条件の演算子・値の誤り、「含む」の部分一致     | [Workflowの変数・分岐を設定する](/ruworkflowto/configure-workflow-variables-and-branches.md) |
| AIの出力形式が崩れる        | 指示の不足、出力形式の指定が曖昧          | 該当ノードのプロンプト                                                                       |
| 外部サービスでエラー         | 連携の失効、権限不足、相手先の制限         | 連携の状態・管理者                                                                         |
| トリガーで起動しない         | 未公開、連携の失効、絞り込み条件          | [Workflowトリガーを設定する](/ruworkflowto/configure-workflow-triggers.md)                 |
| Projectのタスクが実行できない | タスクや実行対象の状態、入力・接続・実行条件の問題 | Project設定のタスクスケジューラにあるタスク一覧と履歴                                                    |

## 4. 実行データを保存する

詳細画面から、実行データをJSON形式でダウンロードできる場合があります。管理者や開発担当へ調査を依頼するときに添付すると、状況を正確に伝えられます。

> ダウンロードしたファイルには入力・出力がそのまま含まれます。保存先と共有相手に注意してください。

## 5. 失敗した実行を再実行する

トリガーなどイベントで起動した実行が失敗した場合、詳細画面に「再実行」が表示されることがあります。

1. 失敗の原因（連携の失効など）を先に解消します。
2. 「再実行」を選択します。
3. 確認画面の内容を確認し、「再実行する」を選択します。
4. 「再実行を開始しました」と表示されたら、一覧で新しい実行の結果を確認します。

* 再実行は、**保存された入力**で実行されます。入力を変更することはできません。
* 失敗前に完了していた書き込み（Objectへの保存など）がある場合、**再実行によってデータが重複する可能性があります。** 対象データを確認してから実行してください。
* 「再実行」は、失敗した実行のうち、イベントで起動した実行にだけ表示される場合があります。手動で実行した失敗をやり直す場合は、Projectのワークフロー一覧にある「手動実行」またはAppの実行画面から改めて実行します。

## 6. 修正して確認する

1. 編集画面で、特定したノードを修正します。
2. 一時保存し、問題が起きた入力に近い値でテストします（[Workflowの下書きをテストする](/ruworkflowto/test-workflow-drafts.md)）。
3. テスト結果を編集画面の「実行履歴」で確認します。
4. 問題が解消したら公開します（[Workflowを公開する](/ruworkflowto/publish-workflow.md)）。
5. Projectのワークフローの実行履歴、またはタスクスケジューラの履歴で、公開後の実行結果を確認します。

> 修正を公開しても、すでに失敗した実行の結果は変わりません。必要に応じて再実行や、手動での実行を行ってください。

## チェックリスト

* [ ] 調べたい実行が、公開版・タスク・下書きテストのどれかを区別した
* [ ] Projectのワークフローの実行履歴またはタスクスケジューラの履歴で対象を特定した
* [ ] 結果とステップを確認した
* [ ] 値が最初に想定と異なったノードを特定した
* [ ] 機密情報の扱いに注意してJSONを保存・共有した
* [ ] 再実行による重複の影響を確認した
* [ ] 修正後にテストし、公開後の実行も確認した

## 次に読む記事

* [タスクスケジューラを設定する](/ruworkflowto/configure-task-scheduler.md)
* [Workflowが起動しない・失敗する](/toraburushtingu/workflow-not-starting-or-failing.md)
* [Workflow・自動実行の仕様・制限](/shi-yang-zhi-xian/workflow-and-automation-specs.md)
