सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

गाइड

रन रीकरिंग एजेंट कार्य

अनुमोदित पहुंच का पुन: उपयोग करें, प्रति निर्धारित घटना एक खोज चलाएं, और गलती से उसी काम को फिर से जमा किए बिना पुनर्प्राप्त करें।

इस पेज पर

कैसे कार्य चलाता है चुनें

आपका एजेंट होस्ट या OS शेड्यूलर समय की आपूर्ति करता है। FlashData डेटा की आपूर्ति करता है। एक निष्पादन पथ का चयन करें और उस वातावरण में इसका परीक्षण करें जो बिना किसी रुकावट के चली जाएगी।

उपयोगके लिएराज्य को संरक्षित रखने के लिए
CLIटर्मिनल एक्सेस, क्रोन या एक अनुसूचित स्क्रिप्ट के साथ एक एजेंट।CLI प्रोफाइल, राज्य निर्देशिका और मूल रन ID.
MCPएक एजेंट कनेक्टेड FlashData सर्वर के साथ होस्ट करता है।मेजबान क्रेडेंशियल, घटना रिकॉर्ड, नौकरी IDs और परिणाम।

निर्धारित वातावरण में पहुंच की जाँच करें

google_search अनुमति के साथ मौजूदा मालिक कनेक्शन का पुन: उपयोग करें। आवर्ती उपयोग से पहले अस्थायी पहुंच का दावा करें। एक ताजा निर्धारित प्रक्रिया या सत्र से टेस्ट न केवल एक इंटरैक्टिव।

Bash और jq (Git Bash) का उपयोग Windows पर किया जाता है, जो OS उपयोगकर्ता के तहत कुंजी को बचाता है। नीचे अपना मौजूदा प्रोफ़ाइल नाम और पूर्ण राज्य निर्देशिका सेट करें। दोनों ही ब्लॉकों को उसी टर्मिनल में चलाएं; धावक इन सेटिंग्स का पुन: उपयोग करता है।

एक्सेस चेक को true प्रिंट करना होगा। पहले खोज से पहले estimatedCredits के साथ availableCredits की तुलना करें। ये जाँच क्वेरी प्रस्तुत नहीं करते हैं।

अपने सहेजे गए कनेक्शन सेट करें
# 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
नि:शुल्क एक्सेस, बैलेंस और मूल्य चेक
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: प्रति घटना एक कार्य बचाओ

नीचे कार्य फ़ोल्डर बनाएं, फिर इसके अंदर request.json और run-research.sh को सेव करें। इस फ़ोल्डर को मौजूदा क्रेडेंशियल स्टेट डाइरेक्टरी से अलग रखें। एक तारीख एक Google क्वेरी का प्रतिनिधित्व करती है; संख्या परिणाम की संख्या निर्धारित करती है। अपने पहले निष्पादन से पहले एक अलग कार्यप्रवाह को अपना खुद का रन-ID उपसर्ग दें।

कार्य फ़ोल्डर बनाएँ
mkdir -p flashdata-research
cd flashdata-research
request.json
{
  "source": "google_search",
  "query": "battery recycling research",
  "params": {
    "num": 5
  }
}

बचाओ run-research.sh

कार्य फ़ोल्डर में request.json के बगल में run-research.sh बनाएं। नीचे दिए गए संपूर्ण स्क्रिप्ट को कॉपी करें और कार्य को चलाने या शेड्यूल करने से पहले इसे सेव करें।

स्क्रिप्ट प्रत्येक तारीख के लिए इनपुट को फ्रीज करती है और प्रत्येक प्रयास के लिए एक रसीद, परिणाम और त्रुटि फ़ाइल रखता है। केवल सफल प्रयास प्रकाशित result.json और receipt.json, दिनांकित फ़ोल्डर के शीर्ष स्तर पर। --recurring मालिक पहुँच की जाँच करता है; यह एक अनुसूची नहीं बनाता है।

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"

एक बार फिर चलाएं, फिर एक ताजा प्रक्रिया पुनः प्रयास करें

कार्य फ़ोल्डर से भागो। पहला आदेश एक खोज प्रस्तुत करता है। दूसरा उसी खाते, इनपुट, प्रोफ़ाइल और राज्य का उपयोग करता है ताकि उस पहुंच को अभी भी मान्य होने की जांच के बाद बचाया परिणाम पढ़ने के लिए।

एक घटना · दो प्रक्रिया शुरू होती है
# 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

परिणाम की पुष्टि करने के लिए पुन: उपयोग किया गया था

दूसरी रसीद cached: true दिखानी चाहिए। इसका उपयोग मूल खोज से संबंधित है। एक खाली कार्बनिक सरणी अभी भी एक सफल परिणाम हो सकता है।

सहेजे गए परिणाम और रसीद का निरीक्षण करें
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
}

रनों के बीच फ़ाइलों को रखें

फ़ाइलउपयोग
runs/DATE/request.jsonउस घटना के लिए सटीक इनपुट; इसे बदलने से धावक रुक जाता है।
runs/DATE/result.json + receipt.jsonअंतिम सफल प्रयास केवल वर्तमान कमांड सफलतापूर्वक बाहर निकलने के बाद उनका उपभोग करते हैं।
runs/DATE/attempt.*/प्रत्येक प्रयास के लिए परिणाम, रसीद और त्रुटि, जिसमें असफलता शामिल है।
FLASHDATA_STATE_DIRसंरक्षित क्रेडेंशियल और CLI रन रिकॉर्ड। उसी प्रोफ़ाइल और OS उपयोगकर्ता को रखें।

MCP: घटना और नौकरी को जारी रखता है ID

इस कार्य का प्रयोग एक मेजबान के साथ करें जो टिकाऊ कार्य राज्य रखता है और प्रति घटना एक सक्रिय निष्पादन की अनुमति देता है। तुरंत वापसी की नौकरी ID बचाओ; एक पुनरारंभ के बाद, फिर से खोज करने के बजाय स्वीकृत नौकरी पढ़ें।

MCP पुनरावृत्ति कार्य · recurring-task.txt के रूप में सहेजें
शेड्यूलर की मूल घटना ID और निर्धारित समय का उपयोग करें।
मौजूदा FlashData MCP कनेक्शन का पुन: उपयोग करें और घटना रिकॉर्ड को बचाया।
1. यदि यह घटना पूरी हो जाती है, तो खोज के बिना अपने बचाया परिणाम वापस लौटें।
2. अगर यह नौकरी है ID, कॉल get_job उसके साथ job_id मौजूदा कार्य को पढ़ने के लिए।
3. अगर कोई जमा करना शुरू हो गया है लेकिन इसका कोई परिणाम या नौकरी नहीं है ID, समीक्षा के लिए बंद करो।
4. एक नई घटना के लिए, एक google_search के लिए get_balance और get_pricing की जाँच करें।
   केवल अनुमोदित प्रति-कार्य बजट और उपलब्ध शेष राशि के भीतर जारी रखें।
5. एक बार google_search को कॉल करने से पहले Persist 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 कॉल्स को CLI रन-ID सुरक्षा को विरासत में नहीं मिला। आपके मेजबान को मूल घटना, प्रस्तुतीकरण राज्य और नौकरी ID को बनाए रखना चाहिए। यदि यह नहीं कर सकता है, तो डेटा चरण के लिए CLI धावक का उपयोग करें। यह उदाहरण रिकॉर्ड आपके होस्ट से संबंधित है; यह एक MCP अनुरोध नहीं है।

होस्ट रिकॉर्ड · चित्रकार
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}

परीक्षण कार्य अनुसूची

नीचे दिए गए उदाहरण OpenClaw को 09:00 Asia/Shanghai. पर उपयोग करता है नौकरी को अक्षम करें, उस नौकरी को मैन्युअल रूप से बचाए रखें, इसके उत्पादन का निरीक्षण करें, फिर इसे सक्षम करें। एक अन्य शेड्यूलर के लिए, इसके परीक्षण रन नियंत्रण के साथ एक ही अनुक्रम का पालन करें।

सेटिंगउपयोग
अभिगमनइस कार्यप्रवाह के लिए एक सक्रिय निष्पादन, टिकाऊ राज्य के साथ।
रनटाइमउसी OS उपयोगकर्ता और CLI, कार्य फ़ोल्डर और क्रेडेंशियल स्टेट के लिए पूर्ण पथ का उपयोग करें। टर्मिनल निर्यात स्वचालित रूप से एक चल गेटवे द्वारा विरासत में नहीं मिलते हैं।
रिट्रीममूल घटना और निर्धारित तिथि को मध्य रात के बाद भी रखें। एक मैनुअल टेस्ट Asia/Shanghai. में अपनी चालान तिथि का उपयोग करता है
मिस्ड घटनाचुनें कि क्या छोड़ना है या पकड़ना है। एक खोज रन आज वर्तमान डेटा को लौटाता है, भले ही कल की तारीख के साथ लेबल किया गया हो।
डिलिवरीपहले स्थानीय रूप से सेव करें। रिपोर्ट भेजने से पहले गंतव्य और अधिसूचना नीति को कॉन्फ़िगर करें।

एक एजेंट होस्ट के लिए CLI टास्क बॉडी

प्रोफ़ाइल और पथ स्थानधारकों को बदलें, फिर कार्य फ़ोल्डर में recurring-task.txt को बचाएं। CLI निष्पादन के लिए इस शरीर का प्रयोग करें, या MCP शरीर MCP निष्पादन के लिए ऊपर है। एक प्रत्यक्ष OS शेड्यूलर एक मॉडल के बिना इन पर्यावरण चर के साथ Bash स्क्रिप्ट चला सकता है।

recurring-task.txt
OS उपयोगकर्ता के तहत अनुमोदित FlashData अनुसंधान कार्य को चलाएं जो कुंजी को बचाता है।
धावक: run-research.sh> के लिए <absolute पथ
रनर प्रक्रिया के लिए इन पर्यावरण चरों को सेट करें:
FLASHDATA_BIN: <absolute path to flashdata>
FLASHDATA_PROFILE: <existing Profile name>
FLASHDATA_STATE_DIR: <existing निरपेक्ष राज्य निर्देशिका>
बचाई गई क्रेडेंशियल का पुन: उपयोग करने के लिए FLASHDATA_API_KEY को अनसेट रखें।
YYYYY-MM-DD के रूप में Asia/Shanghai में मूल निर्धारित तिथि का उपयोग करें।
एक मैनुअल रन के लिए, निष्पादन से पहले अपनी घोषणा की तारीख को बचाओ।
भागो: bash "<absolute path to run-research.sh>" YYYYYY-MM-DD
उस तिथि को रात के मध्य भी वापस आने के बाद रखें। एक सक्रिय निष्पादन की अनुमति दें।
उसी प्रोफाइल को रखें, request.json और राज्य निर्देशिका।
केवल कमांड के सफल होने के बाद ही दिनांकित result.json को पढ़ा गया।
स्रोत लिंक की रिपोर्ट करें, ID और उपयोग को चलाएं। स्थानीय आउटपुट रखें।
त्रुटि पर, सहेजी गई त्रुटि को रोकें और रिपोर्ट करें। प्रतिस्थापन कार्य शुरू न करें या नई पहुंच बनाएँ।

1. एक अक्षम OpenClaw नौकरी बनाएँ

एक चल गेटवे और एक मौजूदा एजेंट का उपयोग करें जो एक्सेस चेक पास करता है। नीचे दिए गए आदेश OpenClaw 2026.10.10 का उपयोग करते हैं; पुराने ग्राहकों को अद्यतन करें यदि --wait अनुपलब्ध है। recurring-task.txt युक्त फ़ोल्डर में, उस एजेंट के ID को OPENCLAW_AGENT_ID सेट किया गया।

कमांड एक मौजूदा फाइल को ओवरराइट किए बिना openclaw-job.json को बचाता है। इसे पढ़ें और लौटाने वाली नौकरी के लिए OPENCLAW_JOB_ID सेट करें ID. यदि निर्माण अपनी प्रतिक्रिया खो देता है, तो स्वचालन सूची का निरीक्षण करें --all --json एक और नौकरी बनाने से पहले। --no-deliver स्वचालित घोषणा को अक्षम करता है; कार्य निकाय स्थानीय रिपोर्ट भी रखता है।

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
)

2. इसे सक्षम करने से पहले बचाया नौकरी का परीक्षण करें

एक बार जब इसके शेड्यूल में अक्षम रहता है तो बचाया नौकरी चलाएं। एक परीक्षण खोज और मॉडल लागत के लिए बजट; एक मिलान पूरा हुआ CLI घटना इसके परिणाम का पुन: उपयोग कर सकती है। यह आदेश 10 मिनट तक प्रतीक्षा करता है।

Expect completionStatus: सफल हुआ, फिर सहेजे गए परिणाम, स्रोत लिंक और उपयोग की जांच करें। CLI के लिए, runs/DATE/result.json और receipt.json को पढ़ा; MCP के लिए, मेजबान की बची हुई घटना और नौकरी के परिणाम को पढ़ें। enqueued: true का मतलब केवल स्वीकार किया जाता है, पूरा नहीं हुआ।

एक बार चलाओ · परीक्षण रसीद बचाओ
: "${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.json

एक समयबद्ध या असफल परीक्षण का निरीक्षण करें

एक टाइमआउट रुक जाता है, गेटवे कार्य नहीं। हाल ही में इतिहास पढ़ें अगर रसीद खाली है। OPENCLAW_RUN_ID को OpenClaw runId को रसीद या इतिहास से सेट करें, फिर उस निष्पादन का निरीक्षण करें। प्रगति की जांच करने के लिए रन कमांड को दोहराना नहीं है।

यह शेड्यूलर निष्पादन ID है, नहीं FlashData recurring run ID या एक MCP डेटा जॉब ID. यदि एजेंट डेटा कार्य को लॉग इन या निष्पादित नहीं कर सकता है, तो अनुसूची को अक्षम रखें और उस कदम को पहले मरम्मत करें।

उसी निष्पादन का निरीक्षण करें
: "${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. आउटपुट की जांच के बाद सक्षम करें

सेव्ड एजेंट, शेड्यूल, टाइमज़ोन की समीक्षा करें और परीक्षण पूरा करें। आउटपुट सही होने के बाद ही सक्षम करें और आवर्ती लागत को मंजूरी दे दी गई है। बाद में अक्षम भविष्य के चालान को बंद कर देता है; यह पहले से ही प्रस्तुत क्वेरी को रद्द नहीं करता है।

बचाया नौकरी और परीक्षण इतिहास की समीक्षा करें
: "${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
दैनिक कार्यक्रम को सक्षम करें
openclaw automations enable "$OPENCLAW_JOB_ID"
जब आवश्यक हो तो भविष्य में रनों को रोकें
openclaw automations disable "$OPENCLAW_JOB_ID"

लागत और विफलता नियमों को निर्धारित करना

स्थितिकार्रवाई
लागत योजनाप्रति क्वेरी मूल्य × योजनाबद्ध घटनाएँ। अलग से मॉडल और होस्ट लागत जोड़ें; परिणाम गणना नहीं है।
साझा खाता शेषअपने बजट को शेड्यूलर या होस्ट में लागू करें। इन उदाहरणों में एक अलग कुंजी खर्च कैप नहीं लगाया जाता है।
401 / 403 / 402भविष्य में प्रेषण रोकें। क्रेडेंशियल्स, अनुमति या संतुलन को ठीक करें; मूल घटना और बचाया राज्य के साथ फिर से शुरू करें।
429Respect Retry-After. CLI रन या MCP घटना का निरीक्षण करने से पहले यह तय करने के लिए कि क्या एक नया जमा सुरक्षित है।
अज्ञात प्रस्तुतीकरण परिणामबचाया राज्य रखें और रुकें। एक ज्ञात नौकरी को पुनर्प्राप्त करें ID; अनिश्चितता को बायपास करने के लिए एक ताजा रन ID नहीं बनाते हैं।

अनुसूची बंद करो और अलग से पहुंच वापस

  1. भविष्य के चालानों को रोकने के लिए शेड्यूलर को रोकें।
  2. कंसोल में एजेंट कनेक्शन, OAuth ऐप या API कुंजी को रद्द करें। Revocation नए प्रामाणिक उपयोग को अवरुद्ध करता है; यह निर्यात की गई फ़ाइलों को मिटा नहीं देता है।
  3. एक नई प्रक्रिया से मुफ्त एक्सेस चेक दोहराएं। यह घोषणा के बाद विफल होना चाहिए। CLI auth Logout केवल स्थानीय क्रेडेंशियल को हटा देता है; यह दूरस्थ पहुंच को रद्द नहीं करता है।
Markdown