ドキュメントを探す
ガイド
承認されたアクセスを再利用し、スケジュールされた発生ごとに1つの検索を実行し、誤って同じ作業を再度送信することなく回復します。
このページの内容
タスクの実行方法の選択
エージェントホストまたはOSスケジューラは、タイミングを提供します。 FlashDataはデータを供給します。 1つの実行パスを選択し、無人で実行する環境でテストします。
| 利用条件 | のために | 保存状態 |
|---|---|---|
| CLI | ターミナルアクセス、cron、またはスケジュールされたスクリプトを持つエージェント。 | CLI プロファイル、ステートディレクトリ、元の実行 ID。 |
| MCP | 接続されたFlashDataサーバーが付いている代理店のホスト。 | ホストの資格情報、発生記録、ジョブ IDs と結果。 |
予定されている環境でのアクセスを確認する
google_search 権限で既存の所有者の接続を再利用します。 利用を再開する前に、暫定的なアクセスを主張します。 インタラクティブなプロセスやセッションだけでなく、新しいスケジュールされたプロセスやセッションからテストします。
利用条件 Bash とりあえず jq (Git Bash お問い合わせ Windows)、下 OS キーを保存したユーザ。 既存のプロファイル名と絶対的なステートディレクトリを以下に設定します。 同じターミナルでブロックを実行します。 ランナーはこれらの設定を再利用します。
アクセスチェックは、trueを印刷する必要があります。 availableCreditsとestimatedCreditsを初めて検索する前に比較します。 これらのチェックは、クエリを送信しません。
# Use the profile and state directory that already hold your owner key.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export FLASHDATA_BIN="$(command -v flashdata)"
unset FLASHDATA_API_KEYset -euo pipefail
export FLASHDATA_BIN="${FLASHDATA_BIN:-$(command -v flashdata)}"
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${FLASHDATA_BIN:?Set the absolute path to the FlashData executable}"
profile=${FLASHDATA_PROFILE:-research}
test -d "$FLASHDATA_STATE_DIR" || { echo 'Existing state directory not found.' >&2; exit 1; }
"$FLASHDATA_BIN" --version
jq --version
"$FLASHDATA_BIN" auth status --profile "$profile" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive |
jq -e '.ok and .data.accessVerified
and (.data.identity.identity.recurringAllowed == true)
and (.data.identity.permittedSources | index("google_search") != null)'
"$FLASHDATA_BIN" account balance --profile "$profile" \
--state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
"$FLASHDATA_BIN" account pricing --source google_search --request-count 1 \
--profile "$profile" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive新しく予定されているセッションでこれを実行します。 ホストが承認されたOAuthの認証情報を再利用してリフレッシュしましょう。 各実行時にインタラクティブなログインなしで FlashData に到達できる必要があります。
この予定環境で既存のFlashData MCP接続を再利用します。
get_balance と {} を呼び出します。
get_pricing と {"source":"google_search","request_count":1} を呼び出します。
残高と推定価格を報告します。 新規アクセスの検索や作成は行いません。CLI: 1 回のタスクを 1 件ずつ保存します。
下のタスクフォルダーを作成し、request.json と run-research.sh を保存します。 既存のクレデンシャルステートディレクトリからこのフォルダーを分離します。 1つの日付は1つのGoogleクエリを表します。 numは結果の数を設定します。 最初の実行前に、独自の run-ID プレフィックスを異なるワークフローにします。
mkdir -p flashdata-research
cd flashdata-research{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}保存 run-research.sh
タスクフォルダ内のrequest.jsonの横にあるrun-research.shを作成します。 下の完全なスクリプトをコピーして、タスクを実行またはスケジューリングする前に保存します。
スクリプトは、各日付の入力をフリーズし、各試みのレシート、結果、エラーファイルを保持します。 日付フォルダのトップレベルでresult.jsonとreceipt.jsonを公開するだけの成功した試み。 --recurringは所有者のアクセスをチェックします。 スケジュールを作成していません。
#!/usr/bin/env bash
set -euo pipefail
umask 077
slot=${1:?Pass the scheduled date as YYYY-MM-DD}
[[ "$slot" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || exit 2
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${FLASHDATA_BIN:?Set the absolute path to the FlashData executable}"
profile=${FLASHDATA_PROFILE:-research}
cd -- "$(dirname -- "$0")"
dir="runs/$slot"
mkdir -p "$dir"
if [[ -e "$dir/request.json" ]]; then
cmp -s request.json "$dir/request.json" || {
echo 'Input changed for this slot. Inspect its saved run.' >&2; exit 1;
}
else
(set -C; cat request.json > "$dir/request.json")
fi
attempt=$(mktemp -d "$dir/attempt.XXXXXX")
if ! "$FLASHDATA_BIN" query --input "$dir/request.json" --recurring \
--run-id "scheduled-research:$slot:Asia-Shanghai" \
--profile "$profile" --state-dir "$FLASHDATA_STATE_DIR" \
--output "$attempt/result.json" --timeout 2m --json --non-interactive \
> "$attempt/receipt.json" 2> "$attempt/error.json"; then
cat "$attempt/error.json" >&2
exit 1
fi
jq -e '.ok == true' "$attempt/receipt.json" >/dev/null
jq -e '.source == "google_search" and .status == "done"
and (.results[0].organic | type == "array")' "$attempt/result.json" >/dev/null
# Publish a stable path only after the query and its receipt both succeed.
cp "$attempt/result.json" "$dir/result.next.json"
mv "$dir/result.next.json" "$dir/result.json"
cp "$attempt/receipt.json" "$dir/receipt.next.json"
mv "$dir/receipt.next.json" "$dir/receipt.json"
jq '{runId, cached, usage}' "$attempt/receipt.json"
printf 'Saved result: %s\n' "$dir/result.json"一度実行し、新鮮なプロセス再試行をテストして下さい
タスクフォルダから実行します。 最初のコマンドは、検索を送信します。 2 つは、同じアカウント、入力、プロファイル、状態を使用して、アクセスが有効であることを確認すると保存した結果を読みます。
# Use the date of the intended occurrence, including on retries.
bash run-research.sh 2026-11-04
# Same account, input, profile and state: reuse the completed run.
bash run-research.sh 2026-11-04結果が再使用されたことを確認します
2番目のレシートは、cached: trueを示す必要があります。 元の検索にその使用は属します。 空の有機配列は、まだ成功した結果になることができます。
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json{
"schemaVersion": 1,
"ok": true,
"runId": "scheduled-research:2026-11-04:Asia-Shanghai",
"cached": true
}実行間でファイルを保存する
| ファイルファイル | 利用条件 |
|---|---|
| runs/DATE/request.json | その出来事に対する正確な入力; 変更は、ランナーの停止を行います。 |
| runs/DATE/result.json + receipt.json | 最後の成功の試み。 現在のコマンドが正常に終了した後にのみ消費します。 |
| runs/DATE/attempt.*/ | 失敗を含む各試みの結果、レシート、エラー。 |
| FLASHDATA_STATE_DIR | 保護された資格情報とCLIの実行記録。 同じプロファイルとOSユーザーをキープします。 |
MCP: 発生とジョブを持続させる ID
耐久性のあるタスク状態を維持し、発生ごとに1つのアクティブな実行を可能にするホストを使用して、このタスク ボディを使用します。 すぐに返されたジョブIDを保存します。 再起動後、再度検索する代わりに、承認されたジョブを読み込みます。
スケジューラの元の発生IDおよびスケジュールされた時間を使用して下さい。
既存のFlashData MCP接続と保存された発生記録を再利用します。
1. この発生が完了したら、保存した結果は検索せずに返します。
2. 求人がない場合 ID, コール get_job とそれで job_id 既存の作品を読む。
3. 提出が始まったが、結果や仕事がIDがない場合、レビューを中止します。
4. get_balance と get_pricing を 1 つの google_search でチェックします。
承認されたパータスクの予算と利用可能な残高内でのみ続行してください。
5. google_searchを一度呼ぶ前に持続的なsubmission_started:
{"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}の特長
6. 返されたジョブを保存 ID すぐに。 端末までget_jobで読み、故障を止めてください。
IDをタイムアウトに保ち、ホストの期限を待ち続ける。
7. 結果を保存します。, ソース URLs と使用, その後、この発生を完了マーク.
401、403、402、429、または未知の結果、保存されたレコードを停止し、報告します。
名誉Retry-After。 代替アクセスや別の有料クエリを作成しないでください。
ローカルにレポートを保管し、配送先を個別に設定した場合のみ使用してください。ホストが主張しなければならないもの
重複を防止するだけのプロンプト。 MCP 呼び出しは CLI 実行-ID 保護を継承しません。 ホストは、元の発生、送信状態、およびジョブIDを主張しなければなりません。 不可能な場合は、データステップでCLIランナーを使用してください。 この例のレコードはホストに属しています。MCPリクエストではありません。
{
"occurrence": "research:2026-11-04:Asia-Shanghai",
"state": "accepted",
"job_id": "<returned job ID>",
"output": null
}テストされたタスクをスケジュールする
以下の例では、09:00 Asia/Shanghai.でOpenClawを使用しています。 ジョブを無効化し、保存したジョブを手動で実行し、出力を調べて、有効にします。 別のスケジューラについては、テスト実行制御と同じスケジューラに従います。
| セットアップ | 利用条件 |
|---|---|
| コンポレーション | 耐久性のある状態で、このワークフローの1つのアクティブな実行。 |
| ランタイム | CLI、タスクフォルダ、クレデンシャル状態の同じOSユーザーと絶対パスを使用します。 ターミナルのエクスポートは、実行中のゲートウェイによって自動的に継承されません。 |
| リトリート | 深夜以降を含めて、元の発生日と予定日を保ちます。 マニュアルテストでは、Asia/Shanghai.の呼び出し日を使用します |
| 見逃された発生 | スキップまたはキャッチアップするかどうかを選択します。 昨日の日付でラベルを付けても、現在のデータが返されます。 |
| 配送について | ローカルで最初に保存します。 レポートを送信する前に、宛先と通知ポリシーを設定します。 |
エージェントホスト用のCLIタスクボディ
プロファイルとパスプレースホルダーを交換し、タスクフォルダにrecurring-task.txtを保存します。 CLIの実行、MCPの実行のために上のMCPボディのためにこのボディを使用して下さい。 OSスケジューラは、Bashスクリプトをモデルなしで実行できます。
認証された FlashData リサーチタスクを OS ユーザで実行し、キーを保存します。
ランナー:<run-research.sh>への絶対パス
これらの環境変数をランナープロセスに設定します。
FLASHDATA_BIN: <フラッシュデータへの絶対パス>
FLASHDATA_PROFILE: <既存のプロファイル名>
FLASHDATA_STATE_DIR: <既存の絶対状態ディレクトリ>
FLASHDATA_API_KEY は保存された認証を再利用するために設定を解除します。
Asia/Shanghaiの元の予定日をYYY-MM-DDとして使用して下さい。
マニュアルランの場合は、実行前に呼び出し日を保存します。
実行: bash "<absolute path to run-research.sh>" YYYYY-MM-DD
深夜以降も、その日付を再び残してください。 1つのアクティブな実行を許可します。
同じプロファイル、request.json、および状態ディレクトリを保持します。
コマンドが正常に終了した後に、日付のresult.jsonを読み込みます。
ソースリンクを報告し、IDを実行し、使用状況を実行します。 出力をローカルに保ちます。
エラーで保存されたエラーを止めて報告します。 交換作業を開始したり、新しいアクセスを作成したりしないでください。1. 無効なOpenClawジョブを作成する
実行中のゲートウェイとアクセスチェックを通過した既存のエージェントを使用します。 下記のコマンドは、OpenClaw 2026.10.10 を使用します。--wait が利用できない場合は、古いクライアントを更新してください。 recurring-task.txt を含むフォルダーに、OPENCLAW_AGENT_ID をそのエージェントの ID にセットします。
コマンドは、既存のファイルを上書きせずに openclaw-job.json を保存します。 OPENCLAW_JOB_IDを返されたジョブIDにセットします。 作成が応答を失う場合、自動化は別のジョブを作成する前に --all --json をリストします。 --no-deliver は自動発表を無効にします。タスク ボディはまたローカルにレポートを保ちます。
: "${OPENCLAW_AGENT_ID:?Set the existing OpenClaw agent ID}"
test -s recurring-task.txt || exit 1
# Keep the receipt. An existing file blocks accidental recreation.
(
set -o noclobber
openclaw automations add --name flashdata-daily-research \
--agent "$OPENCLAW_AGENT_ID" \
--cron "0 9 * * *" --tz Asia/Shanghai --exact \
--session isolated --disabled --no-deliver \
--message "$(cat recurring-task.txt)" --json > openclaw-job.json
)2. 保存したジョブを有効化する前にテストする
保存したジョブを一度実行し、スケジュールが無効に保たれます。 1つのテスト検索とモデルコストの予算。マッチング完了したCLIの発生は、結果を再使用することができます。 10まで待ちます。
completionStatusを期待:成功し、保存された結果、ソースリンク、使用量を確認してください。 CLI では、runs/DATE/result.json と receipt.json を読み込み、MCP では、ホストの保存された発生とジョブ結果を読みます。enqueued: true は単独で受け付けており、完了していません。
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
# Run the saved job once; its schedule stays disabled.
(
set -o noclobber
openclaw automations run "$OPENCLAW_JOB_ID" \
--wait --wait-timeout 10m --json > openclaw-test-run.json
)cat openclaw-test-run.jsonタイムアウトや失敗したテストを調べる
ゲートウェイのタスクではなく、タイムアウトが待機停止します。 領収書が空の場合、最近の履歴を読みます。 OPENCLAW_RUN_IDを、レシートや履歴からOpenClaw runIdにセットし、その実行を検査します。 実行コマンドを繰り返さないで、進捗状況を確認できます。
これはスケジューラ実行です ID, ない FlashData 再発の実行 ID または MCP データジョブ ID. エージェントがデータタスクにログインしたり、実行できない場合は、スケジュールを無効にし、その手順を修復してください。
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
cat openclaw-test-run.json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --json
# Set this from the receipt or history; this is OpenClaw's run ID.
: "${OPENCLAW_RUN_ID:?Set the OpenClaw test run ID}"
openclaw automations runs "$OPENCLAW_JOB_ID" \
--run-id "$OPENCLAW_RUN_ID" --json3. 出力を確認した後に有効
保存されたエージェント、スケジュール、タイムゾーン、および完成したテストを確認します。 出力が正しい後だけ有効になり、再発費用が承認されます。 後で無効にすると、将来の呼び出しが停止します。 既に送信されたクエリはキャンセルされません。
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
openclaw automations show "$OPENCLAW_JOB_ID" --json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --jsonopenclaw automations enable "$OPENCLAW_JOB_ID"openclaw automations disable "$OPENCLAW_JOB_ID"コストと失敗のルールを設定する
| 投稿ナビゲーション | アクション |
|---|---|
| コストプランニング | クエリごとの価格 × 計画された発生. モデルとホストのコストを別々に追加します。結果のカウントはクエリカウントではありません。 |
| 共有アカウント残高 | スケジューラまたはホストで予算を強制します。 これらの例では、別々のキーの支出キャップを課さない。 |
| 401 / 403 / 402 | 将来のディスパッチを悪用します。 資格情報、許可、残高の修正、元の発生と保存状態の再開。 |
| 429 | Retry-After の尊重。 新しい投稿が安全であるかどうかを決定する前に、CLI実行またはMCP発生を調べます。 |
| 未知の投稿結果 | 保存された状態を保ち、停止して下さい。 既知の仕事を回復する ID; 不確実性を迂回するために新しい実行 IDを作成しないでください。 |
スケジュールを中止し、別々にアクセスを取り消す
- 将来の呼び出しを停止するためにスケジューラを悪用します。
- エージェントの接続、OAuthアプリ、APIキーをコンソールで再実行します。 Revocation は新しい認証された使用をブロックします。エクスポートされたファイルを消去しません。
- 新鮮なプロセスから無料のアクセスチェックを繰り返します。 再発後に失敗するはずです。 CLI auth ログアウトはローカルの認証情報のみを削除し、リモートアクセスを解除しません。