# _Runtuhkan tugas

Akses yang disetujui, jalankan satu pencarian per kejadian yang dijadwalkan, dan pulih tanpa sengaja menyerahkan pekerjaan yang sama lagi.

Referensi boonical: https://flashdata.dev/ms/docs/guides/recurring-tasks
Diulas: 2026-11-05 oleh FlashData

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

## Pilih bagaimana tugas berjalan

Hos ejen atau penjadual OS menentukan masa pelaksanaan. FlashData membekalkan data. Pilih satu kaedah pelaksanaan dan ujinya dalam persekitaran yang akan berjalan tanpa pengawasan.

| Guna | * Untuk * | Negara bagian untuk melestarikan |
| --- | --- | --- |
| CLI | Agen agen dengan akses terminal, cron, atau naskah terjadwal. | Profil CLI, direktori negara bagian dan asli jalankan ID. |
| MCP | Hos ejen dengan pelayan FlashData yang telah disambungkan. | Kelayakan host, catatan kejadian, pekerjaan IDs dan hasil. |

- [Tugas CLI](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md#input)
- [Tugas MCP](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md#mcp)
- [Buatlah pengarahan harian](https://flashdata.dev/ms/docs/guides/daily-research-briefing/reference.md)

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

## Periksa akses di lingkungan yang dijadwalkan

¡Use koneksi pemilik yang sudah ada dengan izin google_search. Tuntutan pengungkapan akses sementara sebelum penggunaan berulang. Tes dari proses atau sesi yang dijadwalkan baru, bukan hanya yang interaktif.

### CLI

Guna Bash Dan jq (Git Bash Pada WindowsDi bawah OS Pengguna yang menyelamatkan kuncinya. Tetapkan nama profil Anda yang sudah ada dan direktori negara mutlak di bawah ini. Jalankan kedua blok di terminal yang sama; pelari menggunakan kembali pengaturan ini.

Pemeriksaan akses harus mencetak true. Abandingkan availableCredits dengan estimatedCredits sebelum pencarian pertama. Pemeriksaan ini tidak mengajukan pertanyaan.

#### Kemudikan set sambungan tersimpan anda

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

#### Akses gratis, saldo dan harga cek

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

Jalankan ini di sesi baru yang dijadwalkan. Biarkan tuan rumah menggunakan ulang dan menyegarkan kembali kelayakan OAuth yang disetujui. Ini harus dapat mencapai FlashData tanpa login interaktif pada setiap larian.

#### Periksa rumah gratis

```text
Andaikan kembali koneksi FlashData MCP yang ada di lingkungan terjadwal ini.
Panggil get_balance dengan {}.
Panggil get_pricing dengan {"source":"google_search","request_count":1}.
Melaporkan keseimbangan dan perkiraan harga. Jangan mencari atau membuat akses baru.
```


- [Pasang CLI](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#install)
- [Gnect MCP](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md)
- [Klaim klaim pengadilan akses](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#claim)

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

## CLI: simpan satu tugas per kejadian

Buat folder tugas di bawah ini, kemudian simpan request.json Dan run-research.sh Di dalamnya. menjaga folder ini terpisah dari direktori negara kredensial yang ada. Satu tanggal mewakili satu pertanyaan Google; num menetapkan jumlah hasil. ¡ID awalan sebelum eksekusi pertama.

### Cipta folder tugas

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

### Simpan run-research.sh

Buat run-research.sh di samping request.json di dalam folder tugas. Salin naskah lengkap di bawah ini dan simpan sebelum menjalankan atau menjadwalkan tugas.

Naskah membekukan input untuk setiap tanggal dan menyimpan berkas penerimaan, hasil dan kesalahan untuk setiap percobaan. Hanya upaya sukses yang berhasil yang menerbitkan result.json dan receipt.json di tingkat atas folder tertanggal. --recurring memeriksa akses pemilik; tidak membuat jadwal.

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

### Lari sekali, lalu uji coba lagi proses segar

Jalankan dari folder tugas. Perintah pertama mengirimkan pencarian. ¡A kedua menggunakan akun, masukan, profil dan keadaan yang sama untuk membaca hasil yang disimpan setelah memeriksa bahwa akses masih valid.

#### Satu kejadian · dua proses dimulai

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

### Konfirmasi bahwa hasilnya digunakan kembali

Penerimaan kedua harus menunjukkan cached: true. Penggunaannya dimiliki oleh pencarian aslinya. Sebuah susunan organik yang kosong masih dapat menjadi hasil yang sukses.

#### Periksa hasil dan penerimaan yang disimpan

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

#### Penerimaan Kedua Memerlukan Penerimaan

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


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

### Jaga file antar larian

| Fijiafrica. kgm | Guna |
| --- | --- |
| runs/DATE/request.json | Masukan persis untuk kejadian itu; mengubahnya membuat pelari berhenti. |
| runs/DATE/result.json + receipt.json | Usaha terakhir yang berhasil. Hanya konsumsi mereka setelah perintah saat ini keluar berhasil. |
| runs/DATE/attempt.*/ | Result, penerimaan dan kesalahan untuk setiap upaya, termasuk kegagalan. |
| FLASHDATA_STATE_DIR | Catatan lari kelayakan dan CLI. ¡Jaga profil yang sama dan pengguna OS. |

- [Pulihkan kembali jangka terganggu](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)

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

## MCPBerpajangkan kejadian dan pekerjaan ID

Use this task body with a host yang menyimpan keadaan tugas yang tahan lama dan memungkinkan satu eksekusi aktif per kejadian. Simpan pekerjaan yang dikembalikan ID segera; setelah restart, membaca pekerjaan yang diterima daripada mencari lagi.

### Tugas MCPRUPULAR · · simpan sebagai recurring-task.txt

```text
Dianogue menggunakan jadwal ulangan asli ID dan waktu yang dijadwalkan.
Tak lama kemudian, gunakan kembali sambungan FlashData MCP yang sudah ada dan simpan catatan kejadian.
1. Jika kejadian ini selesai, kembalikan hasil yang disimpan tanpa mencari.
2. Jika memiliki pekerjaan ID, hubungi get_job dengan job_id untuk membaca karya yang sudah ada.
3. Jika penyerahan dimulai tetapi tidak memiliki hasil atau pekerjaan ID, berhenti untuk meninjau.
4. Untuk kejadian baru, periksa get_balance dan get_pricing untuk satu google_search.
   Hanya lanjutkan dalam anggaran per-tugas yang disetujui dan keseimbangan yang tersedia.
5. ¡submission_started sebelum memanggil google_search sekali dengan:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Simpan pekerjaan yang dikembalikan ID segera. Bacalah dengan get_job sampai terminal; berhentilah pada kegagalan.
   Biarkan ID melintasi waktu habis dan berhenti menunggu di batas waktu host.
7. Simpan hasilnya, sumber URLs dan penggunaan, kemudian tandai kejadian ini selesai.
Pada 401, 403, 402, 429 atau hasil yang tidak diketahui, berhenti dan laporkan rekor tersimpan.
Kehormatan Retry-After. Jangan membuat akses penggantian atau pertanyaan lain yang terbayar.
WACKES menyimpan laporan lokal; gunakan tujuan pengiriman hanya jika dikonfigurasi secara terpisah.
```

- [Alat MCP](https://flashdata.dev/ms/docs/mcp/reference.md)
- [Bacalah pekerjaan yang diterima](https://flashdata.dev/ms/docs/mcp/reference.md#jobs)

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

### Apa yang harus terus dilakukan oleh tuan rumah

Menyalahkan saja tidak dapat mencegah duplikat. Panggilan MCP tidak mewarisi CLI run-ID proteksi. Kau harus bertahan dari kejadian asli, keadaan penyerahan dan pekerjaan ID. Jika tidak bisa, gunakan pelari CLI untuk langkah data. Catatan contoh ini milik tuan rumah Anda; ini bukan permintaan MCP.

#### Catatan Host palsu · ilustrasi

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


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

## Jadwalkan tugas yang telah diuji

Contoh di bawah ini menggunakan OpenClaw di 09:00 Asia/Shanghai. Buat pekerjaan dinonaktifkan, jalankan pekerjaan yang disimpan secara manual, periksa keluarannya, kemudian aktifkan. Untuk penjadwal lain, ikuti urutan yang sama dengan kontrol uji-larinya.

| Pemadapan | Guna |
| --- | --- |
| Konkurrensi | Salah satu eksekusi aktif untuk aliran kerja ini, dengan keadaan tahan lama. |
| Waktu Runtime | Unagn pengguna OS yang sama dan jalur mutlak untuk CLI, folder tugas dan keadaan kredensial. Ekspor Terminal eksportase tidak secara otomatis diwariskan oleh Gateway yang berjalan. |
| Retries | Dia menyimpan kejadian asli dan tanggal dijadwalkan, termasuk setelah tengah malam. Uji manual menggunakan tanggal pemanggilannya dalam Asia/Shanghai. |
| Kejadian yang tak terjawab | Tak perlu pergi atau mengejar ketinggalan. Pencarian hari ini akan mengembalikan data saat ini, bahkan jika dilabel dengan tanggal kemarin. |
| Pengiriman | Selamatkan yang lokal dulu. Mengkonfigurasi kebijakan destinasi dan notifikasi sebelum mengirim laporan. |

- [Siapkan server atau kontainer](https://flashdata.dev/ms/docs/guides/production-deployment/reference.md)

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

### badan tugas CLI untuk agen tuan rumah

Merebut profil dan placeholders path, kemudian menyimpan recurring-task.txt di folder tugas. Use badan ini untuk eksekusi CLI, atau badan MCP di atas untuk eksekusi MCP. Penjadwal OS secara langsung dapat menjalankan skrip Bash dengan variabel lingkungan ini tanpa model.

#### recurring-task.txt

```text
Jalankan tugas penelitian FlashData yang disetujui di bawah pengguna OS yang menyimpan kunci.
Runner: <absolut jalur ke run-research.sh>
Anda telah menetapkan variabel lingkungan ini untuk proses pelari:
FLASHDATA_BIN: <absolutute jalur ke flashdata>
FLASHDATA_PROFILE: <nama profil yang ada>
FLASHDATA_STATE_DIR: <existing direktori negara absolut>
Keep FLASHDATA_API_KEY unset untuk menggunakan kembali kredensial tersimpan.
Diarsipkan menggunakan tanggal terjadwal asli di Asia/Shanghai, sebagai YYYY-MM-DD.
Untuk menjalankan manual, simpan tanggal pemanggilannya sebelum eksekusi.
Jalankan: bash "<absolute path to run-research.sh>" YYYY-MM-DD
Simpan tanggal itu pada ulang tahun, bahkan setelah tengah malam. Memungkinkan satu eksekusi aktif.
Tetap menjaga profil yang sama, request.json dan direktori negara bagian.
Hanya baca result.json tertanggal setelah perintah keluar berhasil.
Sumber link Report source Report, jalankan ID dan penggunaan. Tetap keluarkan keluaran lokal.
Kesalahan, berhenti dan laporkan kesalahan yang disimpan. Jangan mulai pekerjaan pengganti atau membuat akses baru.
```


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

### 1. Terapkan OpenClaw yang dilumpuhkan

Kau menggunakan Gateway yang sedang berjalan dan agen yang sudah melewati cek akses. Perintah di bawah ini menggunakan OpenClaw 2026.10.10; update klien lama jika --wait tidak tersedia. Di folder yang berisi recurring-task.txt, set OPENCLAW_AGENT_ID ke agen itu ID.

Perintah command menyimpan openclaw-job.json tanpa menimpa berkas yang ada. Baca dan set OPENCLAW_JOB_ID ke pekerjaan yang dikembalikan ID. Jika penciptaan kehilangan responnya, inspeksi automasi list --all --json sebelum membuat pekerjaan lain. --no-deliver menonaktifkan pengumuman otomatis; badan tugas juga terus melaporkan lokal.

#### Bash · menciptakan pekerjaan yang dinonaktifkan

```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
)
```

- [Persediaan OpenClaw](https://flashdata.dev/ms/docs/integrations/openclaw/reference.md)
- [Rujukan penjadwalan OpenClaw](https://docs.openclaw.ai/cli/cron)

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

### 2. Tes pekerjaan yang disimpan sebelum mengaktifkannya

Anda pernah menjalankan pekerjaan yang disimpan sekali sementara jadwalnya tetap dinonaktifkan. Anggaran belanja untuk satu tes pencarian dan biaya model; pencocokan selesai CLI kecocokan dapat menggunakan kembali hasilnya. Perintah ini menunggu hingga 10 menit.

Expect completionStatus: berhasil, kemudian memeriksa hasil yang disimpan, sumber link dan penggunaan. Untuk CLI, baca runs/DATE/result.json dan receipt.json; untuk MCP, baca kejadian dan hasil kerja tersimpan tuan rumah. enqueued: true saja berarti diterima, tidak selesai.

#### Memerlukan sekali · simpan penerimaan pengujian

```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
)
```

#### Membaca penerimaan tes

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


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

### Periksa waktu habis atau ujian gagal

Waktu habis berhenti menunggu, bukan tugas Gateway. Membaca sejarah baru-baru ini jika penerimaan kosong. **Ditetapkan* OPENCLAW_RUN_ID Ke OpenClaw runId Pembatalan dari penerimaan atau riwayat, kemudian memeriksa pelaksanaan itu. Jangan ulangi perintah untuk memeriksa kemajuan.

Ini adalah eksekusi penjadwalan ID, bukan FlashDataRUPULAKAN menjalankan ID atau MCP pekerjaan data ID. Jika agen tidak dapat log masuk atau melaksanakan tugas data, pastikan jadwal tidak aktif dan memperbaiki langkah tersebut terlebih dahulu.

#### Periksa eksekusi yang sama

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

- [Memulihkan langkah data FlashData](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)

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

### 3. Benarkan setelah memeriksa output

Tinjau agen tersimpan, jadwal, zona waktu dan ujian selesai. Membenarkan hanya setelah output benar dan biaya yang berulang disetujui. Membatalkan nanti menghentikan panggilan di masa depan; tidak membatalkan pertanyaan yang sudah diajukan.

#### Tinjaulah riwayat kerja dan ujian yang disimpan

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

#### Buat jadwal harian

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

#### Akan ada masa depan yang akan datang ketika dibutuhkan

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


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

## Aturan biaya dan kegagalan

| Situasi Orang Asing | Aksi |
| --- | --- |
| Perencanaan biaya pabrik | Harga kueri per pertanyaan × kejadian direncanakan. Tambah model dan biaya host secara terpisah; jumlah hasil bukan hitungan pertanyaan. |
| Imbangan akun terkongsi | Wafine mengerahkan anggaran Anda dalam penjadwal atau tuan rumah. Contoh - contoh ini tidak memaksakan tutupan pengeluaran kunci yang terpisah. |
| 401 / 403 / 402 | Tak lama lagi akan dikirim. \"Ferance Fix\" (Perbaiki kelayakan, izin atau keseimbangan; lanjutkan dengan kejadian asli dan keadaan tersimpan.) |
| 429 | Hormat Retry-After. Periksalah CLI run atau MCP kecocokan sebelum memutuskan apakah penyerahan baru aman. |
| Hasil pengiriman tidak diketahui oleh golongan yang tidak diketahui | Tetap jaga negara yang diselamatkan dan berhenti. Kemulihkan pekerjaan yang diketahui ID; jangan membuat larian baru ID untuk melewati ketidakpastian. |

- [Kepriyawaan Semasa](https://flashdata.dev/ms/pricing)
- [Keputusan Pemulihan Liut](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)

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

## Hentikan jadwal dan batalkan akses secara terpisah

1. Wachida menunda jadwal untuk menghentikan invokasi masa depan.
2. Beritahu kembali koneksi agen, aplikasi OAuth atau kunci API di konsol. Blok pembatalan gyzaw blok penggunaan terotentikasi baru; ia tidak menghapus berkas tereksport.
3. Ulangi cek akses bebas dari proses baru. Ini harus gagal setelah pembatalan. CLI log keluar owan log keluar hanya menghapus kelayakan lokal; ia tidak mencabut akses jauh.

- [Ejen dan Connected apps](https://flashdata.dev/app/settings/connections)
- [Kekunci API](https://flashdata.dev/app/api-keys)
- [Sepeda Hidup Akses Bekal Bekal](https://flashdata.dev/ms/docs/guides/agent-access/reference.md)
