İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Kılavuzlar

Tekrarlanan ajan görevleri

Onaylanmış erişim, planlanan bir olay için bir arama yapın ve yanlışlıkla aynı çalışmayı tekrar sunmadan geri alın.

Bu sayfada

Görevin nasıl çalıştığını seçin

Ajanınız ev sahibi veya OS programlayıcısı zamanlamayı sağlar. FlashData verileri sağlar. Bir infaz yolunu seçin ve istenmeyen çalışacak ortamda test edin.

KullanımİçinDevlet korumak için
CLITerminal erişimi, cron veya planlanan bir senaryo ile bir ajan.CLI profili, eyalet rehberi ve orijinal run ID.
MCPbağlantılı bir FlashData sunucusu ile evlenen bir ajan.Ev sahibinin kimlikleri, olay kaydı, iş IDs ve sonuçlar.

Planlanan ortamda kontrol erişim

google_search izni ile mevcut bir sahibinin bağlantısını kullanın. Tekrarlanan kullanımdan önce geçici erişim talep edin. Yeni bir planlanan süreçten veya seanstan test edin, sadece interaktif bir tane değil.

Use Use Use Bash Ve ve jq (Git Bash Onda Windows), altında OS Anahtarı kurtaran kullanıcı. Mevcut profil adını ve mutlak eyalet rehberinizi aşağıda ayarlayın. Aynı terminaldeki her iki blok da çalıştırın; koşucu bu ayarları yeniden kullanır.

Erişim kontrolü true'u yazdırmalıdır. availableCredits ile ilk aramadan önce estimatedCredits ile karşılaştırın. Bu çekler bir sorgu göndermiyor.

Kurtaran bağlantınızı ayarlayın
# 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
Ücretsiz erişim, denge ve fiyat kontrolleri
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

CLI: Bir görevin gerçekleşmesi

Aşağıdaki görev klasörü oluşturun, sonra request.json ve run-research.sh'u içeride kurtarın. Bu klasörü mevcut kriedential state directory'ten ayrı tut. Bir tarih bir Google sorguyu temsil eder; num sonuçları sayısını ayarlar. Kendi run-ID ilk infazından önce başka bir iş akışı verin.

Görev klasörü oluşturun
mkdir -p flashdata-research
cd flashdata-research
request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}

Save Kaydet run-research.sh

Create Create CreateCreate Create Create run-research.sh yanında başka bir yerde request.json Görev klasöründe. Aşağıdaki tam senaryoyu kopyalayın ve görevi çalıştırmadan veya planlamadan önce tasarruf edin.

Senaryo her tarih için girişi donduruyor ve her deneme için bir makbul, sonuç ve hata dosyasını tutar. Sadece başarılı denemeler result.json ve receipt.json'u yayınlanan klasörün üst seviyesinde yayınlar. --recurring checks owner access; bu bir program yaratmaz.

run-research.sh
#!/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"

Bir kez çalıştırın, sonra taze bir işlem yeniden denemesini test edin

Görev klasöründen hareket edin. İlk komut bir arama gönderir. İkincisi, erişimin hala geçerli olduğunu kontrol ettikten sonra kaydedilen sonucu okumak için aynı hesabı, giriş, profili ve durumu kullanır.

Bir olay · iki süreç başlar
# 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

Sonuç tekrarlananı doğrulayın

İkinci makbuz cached: true'u göstermelidir. Onun kullanımı orijinal aramaya aittir. Boş organik bir dizi hala başarılı bir sonuç olabilir.

Kurtarılan sonucun ve makbulunma
jq '{ok, runId, cached, usage}' runs/2026-11-04/receipt.json
jq '.results[0].organic | map({title, link})' runs/2026-11-04/result.json
İkinci makbuz · alıntı
{
  "schemaVersion": 1,
  "ok": true,
  "runId": "scheduled-research:2026-11-04:Asia-Shanghai",
  "cached": true
}

Run the files between running

DosyaKullanım
runs/DATE/request.jsonBu olay için Exact girişi; koşucuyu değiştirmek.
runs/DATE/result.json + receipt.jsonSon başarılı girişim. Sadece mevcut komut çıkışından sonra onları tüketin.
runs/DATE/attempt.*/Sonuç, başarısızlıklar da dahil olmak üzere her girişim için makbuz ve hata.
FLASHDATA_STATE_DIRKorumalı kimlikler ve CLI iş kayıtları. Aynı profili ve OS kullanıcısını tut.

MCP: olayı ve işi devam ettirin ID

Bu görevi, kalıcı bir görev devleti tutan bir ev sahibi ile kullanın ve meydana gelen bir aktif infaza izin verin. Geri dönen iş ID'u hemen kurtarın; bir yeniden başlatmadan sonra, tekrar arama yerine kabul edilen işi okuyun.

MCP tekrarlanan görev · recurring-task.txt
Programın orijinal olay ID'yu kullanın ve planlanan zamanı kullanın.
Mevcut FlashData MCP bağlantısını kullanın ve olay rekorunu kurtardı.
1. Eğer bu olay tamamlanmışsa, aramadan kurtarılan sonucu geri döndürür.
2. Eğer bir iş varsa ID, mevcut işi okumak için job_id ile get_job'u arayın.
3. Eğer bir başvuru başladıysa, sonuç veya iş ID, incelemeyi bırakın.
4. Yeni bir olay için, get_balance ve get_pricing'yu bir google_search için kontrol edin.
   Sadece onaylanmış per-task bütçesi ve mevcut denge içinde devam edin.
5. Persist submission_started aramadan önce aramadan önce google_search Bir kez:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Geri dönen iş ID'u hemen kurtarın. Bunu get_job ile terminale kadar okuyun; başarısızlıktan vazgeçin.
   ID'u zamanında tut ve ev sahibinin son zamanlarda beklemeyi bırakın.
7. Sonuç tasarruf edin, kaynak URLs ve kullanımı, sonra bu olayı tam olarak işaretleyin.
Onda 401, 403, 402, 429 Ya da bilinmeyen bir sonuç, durdurma ve kaydedilen kaydı rapor edin.
Honor Retry-After. Yedek erişim veya başka ücretli bir sorgu oluşturma.
Rapor yerel tutun; sadece ayrı yapılandırılırsa bir teslimat hedefi kullanın.

Ne ev sahibi devam etmeli

Tek başına bir tane tekrarları engelleyebilir. MCP aramaları CLI run-ID korumayı miras almamaktadır. Ev sahibiniz orijinal olayı, teslim durumu ve işi ID’u devam ettirmelidir. Eğer yapamıyorsa, CLI koşucuyu veri adım için kullanın. Bu örnek kayıt ev sahibinize aittir; bir MCP isteği değildir.

Host record · açıklayıcı
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}

Test edilen görevi not edin

Aşağıdaki örnek kullanımları kullanır OpenClaw At at at at in at at, 09:00 Asia/Shanghai. İşi devre dışı bırakmak, işi manuel olarak kullanan koşmak, çıktısını kontrol edin, sonra etkinleştirin. Başka bir programcı için, test-run kontrolleriyle aynı sırayı takip edin.

ayar ayarıKullanım
ConcurrencyBu iş akışı için aktif bir infaz, dayanıklı devletle.
RuntimeAynı OS kullanıcısı ve CLI için mutlak yollar kullanın, görev klasörü ve credential state. Terminal ihracat otomatik olarak çalışan bir Gateway tarafından miras alınmaz.
Emeklileri Yeniden Yeniden YenidenGece yarısından sonra da dahil olmak üzere orijinal olayı ve planlanan tarihi tutun. Bir manuel test, Asia/Shanghai.'daki iptal tarihini kullanır
Bayan olaylarAtlama veya yakalamayı seç. Bir arama bugün mevcut verileri döndürür, dünün tarihini etiketle bile.
Teslimat TeslimatıÖnce yerel olarak tasarruf edin. Rapor göndermeden önce bir varış ve bildirim politikası yapılandırın.

CLI görev bir ajan ev sahibi için vücut

Profil ve yol yer sahibini değiştirir, sonra görev klasöründe recurring-task.txt'u kurtarır. CLI infazı veya MCP vücut MCP infazı için kullanın. Doğrudan bir OS programcı, Bash senaryoyu bir model olmadan çalıştırabilir.

recurring-task.txt
Onaylanmış FlashData araştırma görevini anahtarı kaydeden OS kullanıcısıyla çalıştır.
Çalıştırıcı: <absolute path to run-research.sh>
Çalıştırıcı işlemi için şu ortam değişkenlerini ayarla:
FLASHDATA_BIN: <absolute path to flashdata>
FLASHDATA_PROFILE: <existing profile name>
FLASHDATA_STATE_DIR: <existing absolute state directory>
Kayıtlı kimlik bilgisini kullanmak için FLASHDATA_API_KEY değişkenini ayarlama.
Asia/Shanghai saat dilimindeki özgün planlanan tarihi YYYY-MM-DD biçiminde kullan.
Elle çalıştırmada, çağrı tarihini çalıştırmadan önce kaydet.
Çalıştır: bash "<absolute path to run-research.sh>" YYYY-MM-DD
Gece yarısından sonra bile tekrar denemelerde aynı tarihi koru. Aynı anda yalnızca bir çalıştırmaya izin ver.
Aynı profil, request.json ve durum klasörünü koru.
Tarihli result.json dosyasını yalnızca komut başarıyla tamamlandıktan sonra oku.
Kaynak bağlantılarını, çalıştırma ID değerini ve kullanımı bildir. Çıktıları yerel tut.
Hata durumunda dur ve kaydedilen hatayı bildir. Yerine yeni iş başlatma veya yeni erişim oluşturma.

1. Engelli bir OpenClaw iş oluşturun

Access check'i geçen bir koşu Gateway ve mevcut bir ajan kullanın. Aşağıdaki komutlar OpenClaw 2026.10.10; --wait kullanılamıyorsa eski müşterileri güncellemek. recurring-task.txt içeren klasörde, OPENCLAW_AGENT_ID'u bu ajanın ID'ya ayarlar.

Komut mevcut bir dosyayı yazmadan openclaw-job.json'u kurtarır. Bunu okuyun ve OPENCLAW_JOB_ID'u geri dönen iş ID'ya ayarlar. Yaratılış yanıtını kaybederse, otomasyon liste --all --json başka bir iş yaratmadan önce. --no-deliver otomatik duyuruyu devre dışı bırakır; görev vücudu da yerel raporları tutar.

Bash · engelli bir iş yaratıyor
: "${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. Kurtarılan işi daha önce test edin

Planın engelli kaldığı bir kez kaydedilen işi çalıştırın. Bir test arama ve model maliyetleri için bütçe; bir eşleştirme tamamlanmış CLI olayı sonucu yeniden kullanabilir. Bu komut 10 dakikalarına kadar bekler.

completionStatus: başarılı oldu, sonra kurtarılan sonucu, kaynak bağlantılarını ve kullanımını kontrol edin. CLI için, runs/DATE/result.json ve receipt.json'u okuyun; MCP için, ev sahibinin kurtarılmış olayı ve iş sonuçlarını okuyun. enqueued: true tek başına kabul edilmez, tamamlanmaz.

Bir kez çalıştırın · test makbuzunu kurtarmak
: "${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
)
Test makbuzunu okuyun
cat openclaw-test-run.json

Bir süre boyunca veya başarısız bir test

Bir süre bekleme durur, Gateway görevi değil. Son tarih okuyun eğer makbuz boşsa. OPENCLAW_RUN_ID'u OpenClaw runId'u makbul veya tarihten itibaren kontrol edin. İlerlemeyi kontrol etmek için run komutunu tekrar etmeyin.

Bu, ID, FlashData'u tekrar eden ID veya bir MCP veri işi ID. Eğer ajan veri görevini yerine getiremediyse, ilk önce bu adımı devre dışı bırakma ve tamir etmeye devam edin.

Inspect the same execution
: "${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

3. Çıktıyı kontrol ettikten sonra

Kayıtlı ajanı, zamanlamayı, saat dilimini ve tamamlanmış testi inceleyin. Yalnızca çıktı doğruysa ve düzenli maliyet onaylandıysa etkinleştirin. Sonradan devre dışı bırakmak gelecek çağrıları durdurur; gönderilmiş sorguyu iptal etmez.

Kurtarılan işi gözden geçirin ve tarih test edin
: "${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
Günlük programlanabilir
openclaw automations enable "$OPENCLAW_JOB_ID"
Pause future gerektiğinde çalışır
openclaw automations disable "$OPENCLAW_JOB_ID"

Set maliyet ve başarısızlık kuralları

Durum durumuAction Action Action
Maliyet PlanlamasıSorgu başına fiyat × planlı olaylar. Model ekleyin ve ev sahibi maliyetleri ayrı ekleyin; sonuç sayı sorgu sayımı değildir.
Paylaşılan hesap dengesiBütçeyi zamanlayıcıda veya istemci platformunda uygulayın. Bu örnekler anahtara ayrı bir harcama sınırı koymaz.
401 / 403 / 402Pause future sentes. Bilgi, izin veya denge; orijinal olayla birlikte devam edin ve devleti kurtarın.
429Retry-After'a saygı gösterin. CLI koşmak veya MCP olayı yeni bir gönderimin güvenli olup olmadığına karar vermeden önce.
Bilinmeyen gönderme sonuçlarıKurtarılan durumu tut ve durdur. Bilinen bir iş ID; belirsizliği atlamak için taze bir koşu ID yaratmaz.

Programı durdurun ve ayrı ayrı ayrı erişime geri dönün

  1. Programcıyı gelecekteki davetleri durdurmak için kullanın.
  2. Konsoldan ajan bağlantısını, OAuth uygulamasını veya API anahtarını iptal edin. İptal yeni kimliği doğrulanmış kullanımı engeller; dışa aktarılan dosyaları silmez.
  3. Yeni bir süreçten ücretsiz erişim kontrolü tekrarlayın. Bu, geri bildirimden sonra başarısız olmalıdır. CLI auth logout sadece yerel kimlikleri kaldırır; Uzak erişimi geri çevirmez.