Belgeleri incele
Kılavuzlar
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 | İçin | Devlet korumak için |
|---|---|---|
| CLI | Terminal erişimi, cron veya planlanan bir senaryo ile bir ajan. | CLI profili, eyalet rehberi ve orijinal run ID. |
| MCP | bağ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.
# 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-interactiveBunu taze bir planlanan oturumda çalıştırın. Ev sahibi yeniden bir hale getirelim ve onaylanan OAuth kimliklerini yenilemeye izin verin. FlashData'ye her bir runda interaktif bir giriş olmadan ulaşabilmelidir.
Bu zamanlanmış ortamdaki mevcut FlashData MCP bağlantısını kullan.
get_balance aracını {} ile çağır.
get_pricing aracını {"source":"google_search","request_count":1} ile çağır.
Bakiyeyi ve tahmini fiyatı bildir. Arama yapma ve yeni erişim oluşturma.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.
mkdir -p flashdata-research
cd flashdata-research{
"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.
#!/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.
# 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-04Sonuç 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.
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
}Run the files between running
| Dosya | Kullanım |
|---|---|
| runs/DATE/request.json | Bu olay için Exact girişi; koşucuyu değiştirmek. |
| runs/DATE/result.json + receipt.json | Son 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_DIR | Korumalı 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.
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.
{
"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 |
|---|---|
| Concurrency | Bu iş akışı için aktif bir infaz, dayanıklı devletle. |
| Runtime | Aynı 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 Yeniden | Gece 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 olaylar | Atlama 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.
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.
: "${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.
: "${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.jsonBir 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.
: "${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. Çı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.
: "${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"Set maliyet ve başarısızlık kuralları
| Durum durumu | Action 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 dengesi | Bütçeyi zamanlayıcıda veya istemci platformunda uygulayın. Bu örnekler anahtara ayrı bir harcama sınırı koymaz. |
| 401 / 403 / 402 | Pause future sentes. Bilgi, izin veya denge; orijinal olayla birlikte devam edin ve devleti kurtarın. |
| 429 | Retry-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
- Programcıyı gelecekteki davetleri durdurmak için kullanın.
- 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.
- 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.