コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

ガイド

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

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

このページの内容

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

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

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

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

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

既存のタスク・このターミナルを選択
# 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呼び出しなし
: "${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

回復アクションを選択

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

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

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

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

アクセスの確認と残高確認
: "${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

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

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

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

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

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

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

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

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

既存の handoff を終えて下さい
: "${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

3. CLI結果を回復する

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

保存した結果のエクスポート
: "${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

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

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

MCPタスクを回復する

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

接続されたエージェントに貼り付ける
既存の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クライアントの場合、このオブジェクトをjob_idを交換した後にcallToolに渡します。 これは、シェルコマンドではなく、ツールコールです。 get_jobは、ジョブアカウントとソースのパーミッションをチェックします。 成功したget_balanceチェックだけで、このジョブへのアクセスは証明されません。

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

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

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

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

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

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

ID の実行やジョブがない

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

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

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

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

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

診断分野・ローカルのみを選択
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json