# エージェントのタスクを再帰する

承認されたアクセスを再利用し、スケジュールされた発生ごとに1つの検索を実行し、誤って同じ作業を再度送信することなく回復します。

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

<a id="choose"></a>

## タスクの実行方法の選択

エージェントホストまたはOSスケジューラは、タイミングを提供します。 FlashDataはデータを供給します。 1つの実行パスを選択し、無人で実行する環境でテストします。

| 利用条件 | のために | 保存状態 |
| --- | --- | --- |
| CLI | ターミナルアクセス、cron、またはスケジュールされたスクリプトを持つエージェント。 | CLI プロファイル、ステートディレクトリ、元の実行 ID。 |
| MCP | 接続されたFlashDataサーバーが付いている代理店のホスト。 | ホストの資格情報、発生記録、ジョブ IDs と結果。 |

- [CLI タスク](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md#input)
- [MCP タスク](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md#mcp)
- [日常のブリーフィングを構築](https://flashdata.dev/ja/docs/guides/daily-research-briefing/reference.md)

<a id="prepare"></a>

## 予定されている環境でのアクセスを確認する

google_search 権限で既存の所有者の接続を再利用します。 利用を再開する前に、暫定的なアクセスを主張します。 インタラクティブなプロセスやセッションだけでなく、新しいスケジュールされたプロセスやセッションからテストします。

### CLI

利用条件 Bash とりあえず jq (Git Bash お問い合わせ Windows)、下 OS キーを保存したユーザ。 既存のプロファイル名と絶対的なステートディレクトリを以下に設定します。 同じターミナルでブロックを実行します。 ランナーはこれらの設定を再利用します。

アクセスチェックは、trueを印刷する必要があります。 availableCreditsとestimatedCreditsを初めて検索する前に比較します。 これらのチェックは、クエリを送信しません。

#### 保存された接続を設定する

```bash
# 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_KEY
```

#### 無料アクセス、残高、価格チェック

```bash
set -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
```


### MCP

新しく予定されているセッションでこれを実行します。 ホストが承認されたOAuthの認証情報を再利用してリフレッシュしましょう。 各実行時にインタラクティブなログインなしで FlashData に到達できる必要があります。

#### 無料ホストチェック

```text
この予定環境で既存のFlashData MCP接続を再利用します。
get_balance と {} を呼び出します。
get_pricing と {"source":"google_search","request_count":1} を呼び出します。
残高と推定価格を報告します。 新規アクセスの検索や作成は行いません。
```


- [CLIをインストール](https://flashdata.dev/ja/docs/guides/flashdata-cli/reference.md#install)
- [MCPを接続して下さい](https://flashdata.dev/ja/docs/integrations/mcp-clients/reference.md)
- [クレームトライアルアクセス](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md#claim)

<a id="input"></a>

## CLI: 1 回のタスクを 1 件ずつ保存します。

下のタスクフォルダーを作成し、request.json と run-research.sh を保存します。 既存のクレデンシャルステートディレクトリからこのフォルダーを分離します。 1つの日付は1つのGoogleクエリを表します。 numは結果の数を設定します。 最初の実行前に、独自の run-ID プレフィックスを異なるワークフローにします。

### タスクフォルダを作成する

```bash
mkdir -p flashdata-research
cd flashdata-research
```

### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}
```


<a id="runner"></a>

### 保存 run-research.sh

タスクフォルダ内のrequest.jsonの横にあるrun-research.shを作成します。 下の完全なスクリプトをコピーして、タスクを実行またはスケジューリングする前に保存します。

スクリプトは、各日付の入力をフリーズし、各試みのレシート、結果、エラーファイルを保持します。 日付フォルダのトップレベルでresult.jsonとreceipt.jsonを公開するだけの成功した試み。 --recurringは所有者のアクセスをチェックします。 スケジュールを作成していません。

#### run-research.sh

```bash
#!/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"
```


<a id="slot"></a>

### 一度実行し、新鮮なプロセス再試行をテストして下さい

タスクフォルダから実行します。 最初のコマンドは、検索を送信します。 2 つは、同じアカウント、入力、プロファイル、状態を使用して、アクセスが有効であることを確認すると保存した結果を読みます。

#### 1つの発生・2つの工程が始まります

```bash
# 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
```


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

### 結果が再使用されたことを確認します

2番目のレシートは、cached: trueを示す必要があります。 元の検索にその使用は属します。 空の有機配列は、まだ成功した結果になることができます。

#### 保存した結果とレシートを調べる

```bash
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json
```

#### 第二レシート・抜粋

```json
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "scheduled-research:2026-11-04:Asia-Shanghai",
  "cached": true
}
```


<a id="files"></a>

### 実行間でファイルを保存する

| ファイルファイル | 利用条件 |
| --- | --- |
| runs/DATE/request.json | その出来事に対する正確な入力; 変更は、ランナーの停止を行います。 |
| runs/DATE/result.json + receipt.json | 最後の成功の試み。 現在のコマンドが正常に終了した後にのみ消費します。 |
| runs/DATE/attempt.*/ | 失敗を含む各試みの結果、レシート、エラー。 |
| FLASHDATA_STATE_DIR | 保護された資格情報とCLIの実行記録。 同じプロファイルとOSユーザーをキープします。 |

- [中断された実行を回復する](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md)

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

## MCP: 発生とジョブを持続させる ID

耐久性のあるタスク状態を維持し、発生ごとに1つのアクティブな実行を可能にするホストを使用して、このタスク ボディを使用します。 すぐに返されたジョブIDを保存します。 再起動後、再度検索する代わりに、承認されたジョブを読み込みます。

### MCP再帰タスク・保存としてrecurring-task.txt

```text
スケジューラの元の発生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ツール](https://flashdata.dev/ja/docs/mcp/reference.md)
- [受理された仕事を読む](https://flashdata.dev/ja/docs/mcp/reference.md#jobs)

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

### ホストが主張しなければならないもの

重複を防止するだけのプロンプト。 MCP 呼び出しは CLI 実行-ID 保護を継承しません。 ホストは、元の発生、送信状態、およびジョブIDを主張しなければなりません。 不可能な場合は、データステップでCLIランナーを使用してください。 この例のレコードはホストに属しています。MCPリクエストではありません。

#### ホストレコード・イラスト

```json
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}
```


<a id="schedule"></a>

## テストされたタスクをスケジュールする

以下の例では、09:00 Asia/Shanghai.でOpenClawを使用しています。 ジョブを無効化し、保存したジョブを手動で実行し、出力を調べて、有効にします。 別のスケジューラについては、テスト実行制御と同じスケジューラに従います。

| セットアップ | 利用条件 |
| --- | --- |
| コンポレーション | 耐久性のある状態で、このワークフローの1つのアクティブな実行。 |
| ランタイム | CLI、タスクフォルダ、クレデンシャル状態の同じOSユーザーと絶対パスを使用します。 ターミナルのエクスポートは、実行中のゲートウェイによって自動的に継承されません。 |
| リトリート | 深夜以降を含めて、元の発生日と予定日を保ちます。 マニュアルテストでは、Asia/Shanghai.の呼び出し日を使用します |
| 見逃された発生 | スキップまたはキャッチアップするかどうかを選択します。 昨日の日付でラベルを付けても、現在のデータが返されます。 |
| 配送について | ローカルで最初に保存します。 レポートを送信する前に、宛先と通知ポリシーを設定します。 |

- [サーバやコンテナを用意する](https://flashdata.dev/ja/docs/guides/production-deployment/reference.md)

<a id="cli-task"></a>

### エージェントホスト用のCLIタスクボディ

プロファイルとパスプレースホルダーを交換し、タスクフォルダにrecurring-task.txtを保存します。 CLIの実行、MCPの実行のために上のMCPボディのためにこのボディを使用して下さい。 OSスケジューラは、Bashスクリプトをモデルなしで実行できます。

#### recurring-task.txt

```text
認証された 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を実行し、使用状況を実行します。 出力をローカルに保ちます。
エラーで保存されたエラーを止めて報告します。 交換作業を開始したり、新しいアクセスを作成したりしないでください。
```


<a id="openclaw-schedule"></a>

### 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 は自動発表を無効にします。タスク ボディはまたローカルにレポートを保ちます。

#### Bash · 無効なジョブを作成します。

```bash
: "${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
)
```

- [OpenClawセットアップ](https://flashdata.dev/ja/docs/integrations/openclaw/reference.md)
- [OpenClawのスケジューリングの参照](https://docs.openclaw.ai/cli/cron)

<a id="test-schedule"></a>

### 2. 保存したジョブを有効化する前にテストする

保存したジョブを一度実行し、スケジュールが無効に保たれます。 1つのテスト検索とモデルコストの予算。マッチング完了したCLIの発生は、結果を再使用することができます。 10まで待ちます。

completionStatusを期待:成功し、保存された結果、ソースリンク、使用量を確認してください。 CLI では、runs/DATE/result.json と receipt.json を読み込み、MCP では、ホストの保存された発生とジョブ結果を読みます。enqueued: true は単独で受け付けており、完了していません。

#### 一度走る・テストレシートを保存

```bash
: "${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
)
```

#### テストレシートを読んで下さい

```bash
cat openclaw-test-run.json
```


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

### タイムアウトや失敗したテストを調べる

ゲートウェイのタスクではなく、タイムアウトが待機停止します。 領収書が空の場合、最近の履歴を読みます。 OPENCLAW_RUN_IDを、レシートや履歴からOpenClaw runIdにセットし、その実行を検査します。 実行コマンドを繰り返さないで、進捗状況を確認できます。

これはスケジューラ実行です ID, ない FlashData 再発の実行 ID または MCP データジョブ ID. エージェントがデータタスクにログインしたり、実行できない場合は、スケジュールを無効にし、その手順を修復してください。

#### 同じ実行を調べる

```bash
: "${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" --json
```

- [FlashDataデータステップを回復](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md)

<a id="manage-schedule"></a>

### 3. 出力を確認した後に有効

保存されたエージェント、スケジュール、タイムゾーン、および完成したテストを確認します。 出力が正しい後だけ有効になり、再発費用が承認されます。 後で無効にすると、将来の呼び出しが停止します。 既に送信されたクエリはキャンセルされません。

#### 保存されたジョブとテスト履歴を確認する

```bash
: "${OPENCLAW_JOB_ID:?Set the saved OpenClaw job ID}"
openclaw automations show "$OPENCLAW_JOB_ID" --json
openclaw automations runs "$OPENCLAW_JOB_ID" --limit 5 --json
```

#### 毎日のスケジュールを有効にする

```bash
openclaw automations enable "$OPENCLAW_JOB_ID"
```

#### 必要に応じて、将来の動作を悪用

```bash
openclaw automations disable "$OPENCLAW_JOB_ID"
```


<a id="budget"></a>

## コストと失敗のルールを設定する

| 投稿ナビゲーション | アクション |
| --- | --- |
| コストプランニング | クエリごとの価格 × 計画された発生. モデルとホストのコストを別々に追加します。結果のカウントはクエリカウントではありません。 |
| 共有アカウント残高 | スケジューラまたはホストで予算を強制します。 これらの例では、別々のキーの支出キャップを課さない。 |
| 401 / 403 / 402 | 将来のディスパッチを悪用します。 資格情報、許可、残高の修正、元の発生と保存状態の再開。 |
| 429 | Retry-After の尊重。 新しい投稿が安全であるかどうかを決定する前に、CLI実行またはMCP発生を調べます。 |
| 未知の投稿結果 | 保存された状態を保ち、停止して下さい。 既知の仕事を回復する ID; 不確実性を迂回するために新しい実行 IDを作成しないでください。 |

- [現在の価格設定](https://flashdata.dev/ja/pricing)
- [回復決定](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md)

<a id="stop"></a>

## スケジュールを中止し、別々にアクセスを取り消す

1. 将来の呼び出しを停止するためにスケジューラを悪用します。
2. エージェントの接続、OAuthアプリ、APIキーをコンソールで再実行します。 Revocation は新しい認証された使用をブロックします。エクスポートされたファイルを消去しません。
3. 新鮮なプロセスから無料のアクセスチェックを繰り返します。 再発後に失敗するはずです。 CLI auth ログアウトはローカルの認証情報のみを削除し、リモートアクセスを解除しません。

- [Connected appsおよび代理店](https://flashdata.dev/app/settings/connections)
- [APIキー](https://flashdata.dev/app/api-keys)
- [アクセスのライフサイクル](https://flashdata.dev/ja/docs/guides/agent-access/reference.md)
