# エージェントの統合を回復する

CLI または MCP タスクを中断したまま、保存された実行、ジョブ、または結果 ID を使用して復元します。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/agent-recovery
レビュー: FlashData による 2026-11-05

<a id="start"></a>

## 保存したIDから始めましょう

失敗したタスクやスケジュールを悪用します。 タスクフォルダやエージェントの履歴で領収書を見つけ、マッチングパスに従ってください。 これらのIDsは変更できません。

| お問い合わせ | 利用条件 |
| --- | --- |
| CLI runId | CLIは、元のプロファイルと状態ディレクトリーで、以下の手順を実行します。 |
| MCPジョブID・ジョブ_. | 既存のMCP接続上のget_job。 |
| MCP 結果 ID · 結果_. | get_result から finish への大きい応答を読みます。 |
| OpenClaw は ID を実行します | OpenClawは、その実行によって記録されたFlashData IDの実行履歴を実行します。 |

- [CLI回復](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md#inspect)
- [MCP回復](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw 実行履歴](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md#inspect-test)

<a id="inspect"></a>

## 1. CLI の実行を点検して下さい

営業拠点 Bash (Git Bash お問い合わせ Windows) 元のとして OS タスクの出力フォルダにユーザー、。 元のタスクから、以下の3つの値をすべて置換します。 2 と 3 の手順でこのターミナルが開きます。 FLASHDATA_API_KEY の初期設定では、CLI は、このプロファイルに保存されたキーを使用します。

### 既存のタスク・このターミナルを選択

```bash
# Replace these with the values used by the original task.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export RUN_ID='scheduled-research:2026-11-04:Asia-Shanghai'
unset FLASHDATA_API_KEY
```

### ローカル検査・API呼び出しなし

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata doctor --offline --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata runs show "$RUN_ID" --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


<a id="run-status"></a>

### 回復アクションを選択

実行記録の data.status、data.remoteId および data.errorCode を読んで下さい。

| 記録されたステータス | 対処方法 |
| --- | --- |
| succeeded | 保存した結果は、アクセスチェックを行い、3のステップでエクスポートします。 |
| accepted | アクセスを確認し、承認されたジョブをステップで回復します。 3. |
| uncertain / intent | タスクを一時停止させる。 remoteId、candidateRemoteIds、History をチェックして、もう一度何かを提出するかを決めてください。 |
| failed | errorCodeを最初に固定して下さい。 失敗したレコードが保持されます。 交換は新しいタスクであり、クレジットを使用することができます。 |
| partial | 利用可能な出力を保持します。 既知のジョブを回復します。バルクワークでは、失敗したアイテムを交換する前に各行を調べます。 |
| run_not_found | プロファイル、OSユーザーとステートディレクトリを確認します。 ジャーナルが失われた場合、保存されたレシートやHistoryを探します。 |

- [オープン履歴リクエスト](https://flashdata.dev/app/jobs)
- [バルク結果の回復](https://flashdata.dev/ja/docs/guides/bulk/reference.md)

<a id="decide"></a>

## 2. CLIアカウントアクセスを確認する

これらの無料チェックは、元のアカウントとAPIの起源へのアクセスが必要です。 結果を回復する前に、認証エラーを解決します。

### アクセスの確認と残高確認

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata account balance --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


<a id="access-result"></a>

### これらのフィールドをチェックする

ゼロバランスは、新しい仕事のための資金問題です。 鍵が無効であるということは、それ自体が意味しません。

| auth status フィールド | 期待される |
| --- | --- |
| data.accessVerified | true; それ以外の場合は、結果を読む前にアクセスを修正. |
| data.identity.identity.accountId | タスクを提出したアカウント。 |
| data.identity.permittedSources | 保存されたタスクで使用されるソースが含まれています。 |
| data.identity.identity.recurringAllowed | true 再発タスクを再開する前に。 |


<a id="account-change"></a>

### アカウントが変更されたか、または私はただ試用を要求しました

run_account_mismatch は保存された実行が別のアカウントか API の起源に属していることを意味します。 プロファイル名を再利用すると、その実行を転送しません。

| 投稿ナビゲーション | アクション |
| --- | --- |
| 間違ったアカウント | 環境キーのオーバーライド、選択したプロファイル、およびmanagement/dataの起源を確認してください。 回復する前に意図したアカウントを復元します。 |
| キーは回しました | 必要なソース権限で同じアカウントの置換キーを使用します。 元のプロファイル、ステートディレクトリをキープし、IDを実行します。 |
| クレームトライアル | オーナーアカウントは、仮アカウントとは異なる。 既にエクスポートしたトライアル出力を読みます。 意図した新しい所有者のタスクだけのために、新しい実行IDを使用して下さい;それは所有者の残高を使用します。 |

- [オーナーキーの置換](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [試用とアカウント連携](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md#owner-result)

<a id="handoff"></a>

### 中断されたクレームを再開

24-hour handoff ウィンドウ内の元のプロファイルで auth finish を実行します。 オーナーキーを保存し、確認し、インストールを認めます。 2 番目のコマンドは、保存されたアクセスを新しいプロセスでチェックします。

#### 既存の handoff を終えて下さい

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
# Resume an already approved claim in its original profile.
flashdata auth finish --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive

# A second process checks the saved owner access.
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```

- [クレームや紛失した登録対応](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md#help)
- [認証プロトコル](https://flashdata.dev/auth.md)

<a id="recover"></a>

## 3. CLI結果を回復する

保存したステータスをステップ1から選択します。 存在しない出力ファイル名を使用します。 どちらのコマンドもアクセスを検証し、元の実行を維持します。置換クエリを提出しません。

### 成功を救出

#### 保存した結果のエクスポート

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs show "$RUN_ID" --result --output recovered.json \
  --profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


### async ジョブの承認

ポーリングタイムアウトは、ローカルの待機を停止します。 同じジョブを待ち続けるために再びこの回復コマンドを実行します。

#### オリジナルジョブの待ち合わせ

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs recover "$RUN_ID" --output recovered.json --timeout 10m \
  --profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


- [既知のリモートジョブ ID](https://flashdata.dev/ja/docs/guides/async-batch/reference.md#job-status)

<a id="verify"></a>

### 再開前の回復を確認します

1. 0とok: trueの出口コードを確認し、recovered.jsonを開きます。 保存されたresultエクスポートにはcached: trueがあります。 使用法は元の実行を参照します。
2. 同じアカウント、プロファイル、状態を保持し、この発生を再試行するときにIDを実行します。 ジャーナルを削除したり、再試行を強制するために実行の名前を変更しないでください。
3. アクセス後にのみスケジューリングを再開し、結果が検証されます。 ID を実行して、それぞれ新しいスケジュールされた発生を行います。

- [再発タスクランナー](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md#slot)
- [後で使用するために結果を保存します](https://flashdata.dev/ja/docs/guides/save-results/reference.md)

<a id="mcp"></a>

## MCPタスクを回復する

MCP 呼び出しは、CLI 実行レコードを作成していません。 既存のMCP接続を使用して、ジョブを提出したアカウントに使用します。 このプロンプトでジョブIDを置換し、接続されたエージェントに送信します。

### 接続されたエージェントに貼り付ける

```text
既存のFlashDataジョブを回復:job_REPLACE_WITH_SAVED_ID。
現在の MCP 接続を使用します。 get_balance と {} を呼び出して、アクセスをチェックします。
それから get_job ここまで job_id.
返信にresult_idが含まれている場合、finishはget_resultのチャンクを読みます
JSON を解析する前に組み合わせます。
job.statusの保留または処理のために、同じ仕事を5秒毎に置きます
2分までは、最新の状態を報告し、停止します。
完了すると、出力を保存し、そのソースURLsとこのタスクでの使用状況を保存します。
アクセスエラーでは、ジョブが失敗したり、利用不能になったり、IDを中止して報告します。
ソースツールを実行し、バッチを送信したり、新しい資格情報を作成したりしないでください。
```

- [MCPホストを再接続する](https://flashdata.dev/ja/docs/guides/agent-access/reference.md)
- [MCPツール参照](https://flashdata.dev/ja/docs/mcp/reference.md)

<a id="mcp-job"></a>

### オリジナルの求人を読んでください。

カスタムMCPクライアントの場合、このオブジェクトをjob_idを交換した後にcallToolに渡します。 これは、シェルコマンドではなく、ツールコールです。 get_jobは、ジョブアカウントとソースのパーミッションをチェックします。 成功したget_balanceチェックだけで、このジョブへのアクセスは証明されません。

#### get_job

```json
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}
```


<a id="mcp-status"></a>

### MCPのジョブステータスを確認する

| レスポンス | 次のアクション |
| --- | --- |
| job.status: pending / processing | その後、同じジョブIDを読みます。 ローカルタイムアウトはキャンセルしません。 |
| job.status: completed | 出力を保存します。 その使用は元のクエリに帰属します。 get_jobは新しいクエリを提出または請求しません。 |
| job.status: failed / isError: true | 任意の出力を使用する前にエラーを読みます。 ソースを自動的に再実行しないでください。 |
| code: result_unavailable | 過渡配達失敗の読み込みを繰り返します。 保存した結果が期限切れとなった場合は、以前のエクスポートを使用します。 Async JSON 結果は、24 時間のために保持されます。 |


<a id="mcp-chunks"></a>

### 大きい MCP 応答は中断されました

保存したresult_idを同じAPIキーで使用して下さい。 オフセット 0 で開始して、応答全体を再構築します。以前のチャンクを保ち、代わりに next_offset を使用してください。 このツールを呼び出す前にプレースホルダーを交換します。

1. nullまで、各チャンクを注文して、next_offsetを使用してください。 最後のチャンクの後にだけ結合されたJSONをパースします。
2. キャッシュは 10 分を持続し、キーごとに4つの最新の大きな応答を保持します。 期限が切れたり、悪用されたり、ID を保存したりすると、get_job を再度呼び出して、新しいチャンクを読んでください。
3. リアルタイム応答は、回復可能なバックグラウンドジョブが保証されていません。 ID やエクスポートが保存されていない場合は、History をチェックし、新しい有料クエリを実行する前に尋ねます。

#### get_result

```json
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}
```

- [MCPクライアントとチャンク処理](https://flashdata.dev/ja/docs/guides/mcp-custom-client/reference.md)

<a id="missing-id"></a>

## ID の実行やジョブがない

タスクの保存ファイル、エージェントツールの履歴、所有者の要求のHistoryを確認してください。 request_idはjob_idではなく診断IDです。 応募が認められているかどうか確認できない場合は、タスクをパユースしておく。 元のソースコールを繰り返すと、別の料金が作成できます。

- [オープン履歴リクエスト](https://flashdata.dev/app/jobs)

<a id="errors"></a>

## エラーコードで修正を探す

| シグナル伝達 | フィックス |
| --- | --- |
| 400 / 422 | ツールやエンドポイントスキーマに対する引数をチェックします。 CLIリクエストは、新しいタスクの前にクエリ--dry-runを使用します。 |
| 401 / 403 | CLI では、2 のステップでアクセスを確認してください。 MCP OAuthでは、ホストがリフレッシュできるようにします。 再発された助成金は、所有者承認された再接続を必要とします。 APIキーで、ホストの秘密とソースの権限を確認してください。 |
| 402 | 所有者が資金を解決するまで、新しい作業を停止します。 |
| 406 | Accept:application/json.の使用 サポートされているコンテンツエンドポイントのリクエストでは、X-Respond-With: markdown で Markdown をリクエストします。 |
| 429 | Retry-After を名誉にし、再び提出する前に、既知の仕事を回復します。 待ち時間は失敗したCLIの実行レコードをクリアしません。 |
| タイムアウト / 5xx / 失われた応答 | 既知の受理ジョブを回復します。 Historyを悪用し、確認する未知の投稿結果を保持します。 |
| run_id_input_conflict | 元の入力を復元します。 新しい入力は、非審美的な新しいタスクを必要とし、IDを実行します。 |
| run_account_mismatch | 2のステップでアカウント変更チェックリストを使用する; 新しい実行IDは回復ショートカットではありません。 |
| output_exists | 新しい出力ファイル名を選択します。 保存された実行を保ちましょう。 |
| result_unavailable | MCPでは、上記のジョブまたはチャンクの手順を確認してください。 CLIは、受理されたリモートジョブを回復します。 既存の結果は、以前のエクスポートまたは独自のストレージが必要です。 |

- [HTTP エラー参照](https://flashdata.dev/ja/docs/errors/reference.md)
- [MCPホストを再接続する](https://flashdata.dev/ja/docs/guides/agent-access/reference.md)

<a id="support"></a>

## 診断を支えるために送ります

CLI では、この jq フィルタを error.json で実行します。 MCP、コード、http_status、request_idをツール応答からコピーし、保存されたjob_idまたはresult_id。 クライアントバージョン、エンドポイント、UTC時間、受入確認や不明なものを含む。 認証情報、クッキー、署名されたURLsを除外します。

### 診断分野・ローカルのみを選択

```bash
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json
```

- [サポートへのお問い合わせ](https://flashdata.dev/ja/contact)
