# Jalankan tugas agen berulang

Gunakan kembali akses yang disetujui, jalankan satu pencarian setiap kejadian yang dijadwalkan, dan pulih tanpa sengaja mengirimkan pekerjaan yang sama lagi.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/recurring-tasks
Diulang: 2026-11-05 oleh FlashData

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

## Pilih bagaimana tugas berjalan

Pengurus agenmu atau OS penjadwalan persediaan waktu. FlashData memasok data. Pilih satu path eksekusi dan uji di lingkungan yang akan berjalan tanpa pengawasan.

| Gunakan | Untuk | Negara untuk melestarikan |
| --- | --- | --- |
| CLI | Seorang agen dengan akses terminal, Cron, atau naskah yang dijadwalkan. | Profil CLI, direktori negara dan asli dijalankan ID. |
| MCP | Host agen dengan server FlashData yang terhubung. | Kredensial host, rekaman kejadian, tugas IDs dan hasil. |

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

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

## Periksa akses dalam lingkungan yang dijadwalkan

Gunakan kembali koneksi pemilik yang ada dengan izin google_search. Klaim akses sementara sebelum penggunaan berulang. Uji dari proses atau sesi yang dijadwalkan baru, tidak hanya satu interaktif.

### CLI

Gunakan Bash dan jq (Git Bash nyala Windows), di bawah OS pengguna yang menyimpan kunci. Set nama profil Anda yang ada dan direktori status absolut di bawah ini. Jalankan kedua blok di terminal yang sama; pelari memakai ulang pengaturan ini.

Pemeriksaan akses harus mencetak true. Bandingkan availableCredits dengan estimatedCredits sebelum pencarian pertama. Cek ini tidak mengirimkan permintaan.

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

#### Cek akses, keseimbangan, dan harga gratis

```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 dalam sesi dijadwalkan segar. Biarkan host menggunakan dan menyegarkan kembali kredensial OAuth yang disetujui. Ini harus dapat mencapai FlashData tanpa sebuah login interaktif di setiap jalankan.

#### Pemeriksaan host bebas

```text
Gunakan kembali koneksi FlashData MCP yang ada dalam lingkungan yang dijadwalkan.
Call get_balance dengan {}.
Call get_pricing dengan {"source":"google_search","request_count":1}.
Laporkan saldo dan perkiraan harga. Jangan cari atau buat akses baru.
```


- [Pasang CLI](https://flashdata.dev/id/docs/guides/flashdata-cli/reference.md#install)
- [Hubungkan MCP](https://flashdata.dev/id/docs/integrations/mcp-clients/reference.md)
- [Klaim akses uji coba](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#claim)

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

## CLI: menyimpan satu tugas per kejadian

Buat folder tugas di bawah ini, lalu simpan request.json dan run-research.sh di dalamnya. Jauhkan folder ini terpisah dari direktori negara kredensial yang ada. Satu tanggal merupakan satu Google query; num set jumlah hasil. Berikan aliran kerja yang berbeda sendiri-ID prefix sebelum eksekusi pertama.

### Membuat 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 dalam folder tugas. Salin skrip lengkap di bawah ini dan simpan sebelum berjalan atau penjadwalan tugas.

Skrip membekukan masukan untuk setiap tanggal dan menyimpan tanda terima, hasil, dan berkas kesalahan untuk setiap percobaan. Hanya upaya sukses menerbitkan result.json dan receipt.json pada tingkat atas folder tertanggal. --recurring cek akses pemilik; ini 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>

### Jalankan sekali, kemudian menguji segar proses coba lagi

Jalankan dari folder tugas. Perintah pertama memberikan pencarian. Yang kedua menggunakan akun yang sama, masukan, profil, dan negara untuk membaca hasil yang disimpan setelah memeriksa akses yang masih valid.

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

### Konfirmasikan hasil yang digunakan kembali

Tanda terima kedua harus menunjukkan cached: true. Penggunaannya milik pencarian aslinya. Array organik yang kosong masih bisa menjadi hasil yang sukses.

#### Inspeksi hasil dan tanda terima yang tersimpan

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

#### Tanda terima kedua

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


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

### Menjaga berkas antar jalan

| Berkas | Gunakan |
| --- | --- |
| runs/DATE/request.json | Masukan yang tepat untuk kejadian itu; mengubahnya membuat pelari berhenti. |
| runs/DATE/result.json + receipt.json | Usaha terakhir yang sukses. Hanya mengkonsumsi mereka setelah perintah saat ini berhasil keluar. |
| runs/DATE/attempt.*/ | Hasil, penerimaan dan kesalahan untuk setiap usaha, termasuk kegagalan. |
| FLASHDATA_STATE_DIR | Kredensial terproteksi dan CLI catatan lari. Pertahankan profil yang sama dan pengguna OS. |

- [Pulihkan suatu run yang terganggu](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)

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

## MCP: pertahankan kejadian dan pekerjaan ID

Gunakan tubuh tugas ini dengan host yang membuat keadaan tugas dapat dipertahankan dan memungkinkan satu eksekusi aktif per kejadian. Simpan pekerjaan yang dikembalikan ID segera; setelah restart, baca pekerjaan yang diterima daripada mencari lagi.

### MCP diulang tugas recurring-task.txt

```text
Gunakan penjadwalan kejadian asli ID dan waktu yang dijadwalkan.
Gunakan ulang yang ada FlashData MCP catatan sambungan dan kejadian tersimpan.
1. Jika kejadian ini selesai, kembalikan hasilnya tanpa mencari.
2. Jika ini memiliki pekerjaan ID, panggil get_job dengan job_id tersebut untuk membaca hasil kerja yang telah ada.
3. Jika sebuah pengajuan dimulai tetapi tidak memiliki hasil atau pekerjaan ID, berhenti untuk tinjauan.
4. Untuk kejadian baru, periksa get_balance dan get_pricing untuk satu google_search.
   Lanjutkan hanya dengan anggaran yang disetujui dan keseimbangan yang tersedia.
5. Persist 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 kembali ID segera. Baca dengan get_job sampai terminal; berhenti pada kegagalan.
   Jaga ID di seluruh waktu dan berhenti menunggu di tenggat waktu tuan rumah.
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 catatan yang disimpan.
Kehormatan Retry-After. Jangan buat akses pengganti atau permintaan bayaran lain.
Pertahankan laporan lokal; gunakan tujuan pengiriman hanya jika dikonfigurasi secara terpisah.
```

- [MCP alat](https://flashdata.dev/id/docs/mcp/reference.md)
- [Baca pekerjaan yang diterima](https://flashdata.dev/id/docs/mcp/reference.md#jobs)

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

### Apa yang tuan rumah harus bertahan

Sebuah prompt saja tidak dapat mencegah duplikat. MCP panggilan tidak mewarisi CLI run- ID perlindungan. Host Anda harus bertahan pada kejadian asli, pengajuan keadaan dan pekerjaan ID. Jika tidak bisa, gunakan pelari CLI untuk langkah data. Rekaman ini milik host Anda; ini bukan permintaan MCP.

#### Catatan host

```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 tugas dinonaktifkan, jalankan tugas yang disimpan secara manual, periksa hasilnya, lalu aktifkan. Untuk penjadwalan lain, ikuti urutan yang sama dengan test- run kontrol.

| Tatanan | Gunakan |
| --- | --- |
| konkuenCity in Texas, United States | Satu eksekusi aktif untuk alur kerja ini, dengan keadaan tahan lama. |
| Runtime | Gunakan pengguna OS yang sama dan path absolut untuk CLI, folder tugas dan keadaan kredensial. ekspor terminal tidak secara otomatis diwariskan oleh Gateway yang sedang berjalan. |
| Ulangi | Pertahankan kejadian aslinya dan tanggal yang dijadwalkan, termasuk setelah tengah malam. Sebuah tes manual menggunakan tanggal pengdoa di Asia/Shanghai. |
| Kejadian yang tidak terjawab | Pilih apakah akan melewatkan atau mengejar ketinggalan. Sebuah pencarian hari ini kembali data saat ini, bahkan jika berlabel dengan tanggal kemarin. |
| Pengiriman | Simpan lokal pertama. Atur kebijakan tujuan dan pemberitahuan sebelum mengirim laporan. |

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

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

### CLI tugas tubuh untuk host agen

Ganti profil dan placeholder path, lalu simpan recurring-task.txt dalam folder tugas. Gunakan tubuh ini untuk eksekusi CLI, atau MCP tubuh di atas untuk eksekusi MCP. Sebuah penjadwalan OS langsung dapat menjalankan skrip Bash dengan variabel lingkungan ini tanpa sebuah model.

#### recurring-task.txt

```text
Jalankan tugas penelitian FlashData yang disetujui di bawah pengguna OS yang menyimpan kuncinya.
Runner: < path absolut ke run-research.sh >
Set variabel lingkungan ini untuk proses runner:
FLASHDATA_BIN: < path absolut ke flashdata >
FLASHDATA_PROFILE: < nama profil yang ada >
FLASHDATA_STATE_DIR: < direktori keadaan absolut yang ada >
Pertahankan FLASHDATA_API_KEY unset untuk menggunakan kembali kredensial yang disimpan.
Gunakan tanggal aslinya di Asia/Shanghai, seperti YYYY-MM- DD.
Untuk menjalankan manual, menyimpan tanggal doa sebelum eksekusi.
Jalankan: bash "<absolute path to run-research.sh>" YYYYY-MM- DD
Tetap ingat tanggal itu, bahkan setelah tengah malam. Ijinkan satu eksekusi aktif.
Pertahankan profil yang sama, request.json dan direktori negara.
Hanya membaca tanggal result.json setelah perintah keluar dengan sukses.
Laporkan link sumber, jalankan ID dan penggunaan. Tetap keluar dari tempat ini.
Pada galat, berhenti dan laporkan galat yang disimpan. Jangan mulai pekerjaan pengganti atau membuat akses baru.
```


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

### 1. Buat tugas OpenClaw yang dinonaktifkan

Gunakan Gateway yang sedang berjalan dan agen yang ada yang melewati pemeriksaan akses. Perintah di bawah ini digunakan OpenClaw 2026.10.10; perbarui klien yang lebih tua bila --wait tidak tersedia. Dalam folder yang berisi recurring-task.txt, set OPENCLAW_AGENT_ID untuk agen yang ID.

Perintah menyimpan openclaw-job.json tanpa menimpa berkas yang telah ada. Baca dan atur OPENCLAW_JOB_ID ke pekerjaan yang kembali ID. Jika penciptaan kehilangan respons, periksa daftar otomatisasi --all --json sebelum menciptakan pekerjaan lain. --no-deliver menonaktifkan pengumuman otomatis; badan tugas juga menyimpan laporan lokal.

#### 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 setup](https://flashdata.dev/id/docs/integrations/openclaw/reference.md)
- [OpenClaw penjadwalan referensi](https://docs.openclaw.ai/cli/cron)

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

### 2. Uji tugas yang disimpan sebelum mengaktifkan

Jalankan pekerjaan yang disimpan sekali sementara jadwalnya tetap dinonaktifkan. Anggaran untuk satu biaya pencarian dan model; kecocokan yang selesai CLI dapat menggunakan kembali hasilnya. Perintah ini menunggu sampai 10 menit.

Mengharapkan 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 yang disimpan host. enqueued: true saja berarti diterima, belum selesai.

#### Jalankan sekali

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

#### Baca tanda terima tes

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


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

### Inspeksi sebuah timed- out atau tes gagal

Waktu berhenti menunggu, bukan tugas Gateway. Baca sejarah baru-baru ini jika tanda terima kosong. Set OPENCLAW_RUN_ID ke OpenClaw runId dari tanda terima atau sejarah, kemudian periksa eksekusi itu. Jangan ulangi perintah jalankan untuk memeriksa kemajuan.

Ini adalah eksekusi penjadwalan ID, bukan FlashData dijalankan berulang ID atau MCP tugas data ID. Jika agen tidak dapat masuk atau menjalankan tugas data, pastikan jadwal dinonaktifkan dan perbaiki langkah itu terlebih dahulu.

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

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

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

### 3. Aktifkan setelah memeriksa keluaran

Tinjau agen yang disimpan, jadwal, zona waktu dan tes selesai. Aktifkan hanya setelah keluaran benar dan biaya yang berulang disetujui. Menonaktifkan penghentian pemanggilan ke depan; ini tidak membatalkan permintaan yang telah dimasukkan.

#### Ulas tugas yang disimpan dan riwayat uji

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

#### Aktifkan jadwal harian

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

#### Jeda masa depan berjalan ketika dibutuhkan

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


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

## Set aturan biaya dan kegagalan

| Situasi | Aksi |
| --- | --- |
| Perencanaan biaya | Harga per query × telah direncanakan. Tambahkan biaya model dan host secara terpisah; jumlah hasil tidak dihitung. |
| Saldo akun bersama | Memaksakan anggaran Anda dalam penjadwalan atau host. Contoh-contoh ini tidak memberikan kunci yang terpisah untuk pembelanjaan. |
| 401 / 403 / 402 | Jeda pengiriman masa depan. Perbaiki kredensial, izin atau keseimbangan; lanjutkan dengan kejadian asli dan keadaan disimpan. |
| 429 | Menghormati Retry-After. Inspeksi CLI atau kejadian MCP sebelum memutuskan apakah pengiriman baru aman. |
| Hasil pengiriman tidak diketahui | Jaga negara yang selamat dan berhenti. Cari kembali pekerjaan yang dikenal ID; jangan membuat run segar ID untuk melewati ketidakpastian. |

- [Harga saat ini](https://flashdata.dev/id/pricing)
- [Keputusan pemulihan](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)

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

## Hentikan jadwal dan batalkan akses secara terpisah

1. Jeda penjadwalan untuk menghentikan doa di masa depan.
2. Kembalikan koneksi agen, aplikasi OAuth atau kunci API di konsol. Pemindahan memblokir penggunaan terotentikasi baru; ini tidak menghapus berkas yang diekspor.
3. Ulangi pemeriksaan akses gratis dari proses yang baru. Ini harus gagal setelah pembatalan. CLI auth hanya menghapus kredensial lokal; ini tidak mencabut akses jarak jauh.

- [Connected apps dan agen](https://flashdata.dev/app/settings/connections)
- [Tombol API](https://flashdata.dev/app/api-keys)
- [Lifecycle akses](https://flashdata.dev/id/docs/guides/agent-access/reference.md)
