Przeglądaj dokumentację
Poradniki
Ponowne użycie zatwierdzonego dostępu, uruchomienie jednego wyszukiwania na zaplanowane zdarzenie i odzyskanie bez przypadkowego złożenia tej samej pracy ponownie.
Na tej stronie
Wybierz sposób działania zadania
Twój agent host lub OS terminarz dostarcza czas. FlashData dostarcza dane. Wybierz jedną ścieżkę wykonania i przetestuj ją w środowisku, które będzie działać bez nadzoru.
| Stosowanie | Dla | Państwo do zachowania |
|---|---|---|
| CLI | Agent z dostępem do terminala, cron, lub zaplanowany skrypt. | Profil CLI, katalog stanu i oryginalny przebieg ID. |
| MCP | Agent host z podłączonym serwerem FlashData. | Kwalifikacje gospodarza, zapis zdarzeń, praca IDs i wyniki. |
Sprawdź dostęp w planowanym środowisku
Ponownie użyj istniejącego połączenia właściciela za zgodą google_search. Uzyskanie tymczasowego dostępu przed ponownym użyciem. Test z nowego zaplanowanego procesu lub sesji, nie tylko interaktywnego.
Używaj Bash i jq (Git Bash na Windows) pod użytkownikiem OS, który zapisał klucz. Ustaw swoją istniejącą nazwę profilu i katalog stanu absolutnego poniżej. Uruchom oba bloki w tym samym terminalu; biegacz ponownie używa tych ustawień.
Kontrola dostępu musi wydrukować true. Porównaj availableCredits z estimatedCredits przed pierwszym wyszukiwaniem. Kontrole te nie składają zapytania.
# 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-interactiveUruchom to na nowo zaplanowanej sesji. Niech host ponownie i odświeżyć swoje zatwierdzone referencje OAuth. Musi być w stanie dotrzeć do FlashData bez interaktywnego logowania przy każdym uruchomieniu.
Ponownie użyj istniejącego połączenia FlashData MCP w tym zaplanowanym środowisku.
Zadzwoń do get_balance z {}.
Zadzwoń do get_pricing z {"source":"google_search","request_count":1}.
Proszę podać bilans i szacunkową cenę. Nie wyszukuj ani nie twórz nowego dostępu.CLI: zapisać jedno zadanie na zdarzenie
Utwórz folder zadań poniżej, a następnie zapisać request.json i run-research.sh wewnątrz niego. Przechowywać ten folder oddzielnie od istniejącego katalogu stanu kredytowego. Jedna data reprezentuje jedno zapytanie Google; num ustawia liczbę wyników. Dać inny przepływ pracy swój własny run- ID prefiks przed jego pierwszym wykonaniem.
mkdir -p flashdata-research
cd flashdata-research{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}Zapisz run-research.sh
Utwórz run-research.sh obok request.json w folderze zadań. Skopiuj do niego cały skrypt poniżej i zapisz go przed uruchomieniem lub zaplanowaniem zadania.
Skrypt zamraża dane wejściowe dla każdej daty i zachowuje paragon, wynik i błąd dla każdej próby. Tylko udane próby publikują result.json i receipt.json na najwyższym poziomie datowanego folderu. --recurring sprawdza dostęp właściciela; nie tworzy harmonogramu.
#!/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"Uruchom raz, a następnie przetestować świeży proces ponownie
Uruchom z folderu zadań. Pierwsze polecenie przedstawia poszukiwania. Drugi używa tego samego konta, wejścia, profilu i stanu, aby odczytać zapisany wynik po sprawdzeniu, czy dostęp jest nadal ważny.
# 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-04Potwierdzenie ponownego wykorzystania wyniku
Drugi paragon powinien pokazywać cached: true. Jego użycie należy do oryginalnego wyszukiwania. Pusta tablica organiczna może nadal być sukcesem.
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
}Zachowaj pliki pomiędzy uruchomieniami
| Plik | Stosowanie |
|---|---|
| runs/DATE/request.json | Dokładne dane wejściowe dla tego zdarzenia; zmiana powoduje zatrzymanie biegacza. |
| runs/DATE/result.json + receipt.json | Ostatnia udana próba. Pożera je tylko po tym, jak bieżące komendy wyjdą pomyślnie. |
| runs/DATE/attempt.*/ | Wynik, odbiór i błąd dla każdej próby, w tym niepowodzenia. |
| FLASHDATA_STATE_DIR | Chronione referencje i CLI uruchamiają rekordy. Zachowaj ten sam profil i użytkownika OS. |
MCP: kontynuuj wystąpienie i zadanie ID
Użyj tego organu zadaniowego z hostem, który utrzymuje trwały stan zadania i pozwala na jedną aktywną egzekucję na każde zdarzenie. Zapisz zwrócone zadanie ID natychmiast; po ponownym uruchomieniu, przeczytaj przyjęte zadanie zamiast ponownie szukać.
Użyj oryginalnego wystąpienia grafika ID i zaplanowanego czasu.
Ponownie użyj istniejącego połączenia FlashData MCP i zapisanego rekordu zdarzeń.
1. Jeśli to zdarzenie jest zakończone, zwróć jego zapisany wynik bez wyszukiwania.
2. Jeśli ma zadanie ID, zadzwoń do get_job z tym job_id, aby przeczytać istniejące prace.
3. Jeśli zgłoszenie rozpoczęło się, ale nie ma rezultatu lub zadania ID, zatrzymaj się do przeglądu.
4. Aby uzyskać nowe wystąpienie, sprawdź get_balance i get_pricing dla jednego google_search.
Kontynuuj tylko w zatwierdzonym budżecie na przełożenie zadań i dostępnej równowadze.
5. Persist submission_started przed wywołaniem google_search jeden raz z:
{"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Zapisz zwróconą pracę ID natychmiast. Przeczytaj go za pomocą get_job aż do terminala; zatrzymać się na awarii.
Utrzymuj ID w czasie i przestań czekać na czas oczekiwania gospodarza.
7. Zapisz wynik, źródło URLs i wykorzystanie, a następnie oznacz to zdarzenie kompletne.
Na 401, 403, 402, 429 lub nieznany wynik, zatrzymać i zgłosić zapisany rekord.
Honor Retry-After. Nie tworzyć zastępczego dostępu ani innego płatnego zapytania.
Zachowaj raport na miejscu; użyj celu dostawy tylko wtedy, gdy jest skonfigurowany oddzielnie.Co gospodarz musi przetrwać
Sam sygnał nie może zapobiec powielaniu. Rozmowy MCP nie dziedziczą ochrony CLI run- ID. Twój gospodarz musi utrzymywać pierwotne wystąpienie, stan składania i zadanie ID. Jeśli nie może, do etapu danych należy użyć biegacza CLI. Ten przykład rekordu należy do hosta; nie jest to żądanie MCP.
{
"occurrence": "research:2026-11-04:Asia-Shanghai",
"state": "accepted",
"job_id": "<returned job ID>",
"output": null
}Harmonogram testowanego zadania
Poniższy przykład wykorzystuje OpenClaw w 09:00 Asia/Shanghai. Utwórz zadanie wyłączone, uruchom to zapisane zadanie ręcznie, sprawdź jego wyjście, a następnie włączyć go. Dla innego terminarza, postępuj zgodnie z tą samą sekwencją z jego testem-run kontroli.
| Ustawienie | Stosowanie |
|---|---|
| Konkursowe | Jedna aktywna realizacja dla tego przepływu pracy, z trwałym stanem. |
| Czas działania | Użyj tego samego użytkownika OS i ścieżek bezwzględnych dla CLI, folderu zadań i stanu zaufania. Eksport terminali nie jest automatycznie dziedziczony przez uruchomioną bramę. |
| Retries | Zachować pierwotne zdarzenie i planowaną datę, w tym po północy. Ręczny test używa daty infokacji w Asia/Shanghai. |
| Nieuwzględnione zdarzenia | Wybierz, czy pominąć lub nadrobić zaległości. Przebieg wyszukiwania dzisiaj zwraca aktualne dane, nawet jeśli oznaczono je datą wczorajszą. |
| Dostawa | Zapisz lokalnie najpierw. Przed wysłaniem raportów należy skonfigurować politykę dotyczącą miejsca przeznaczenia i powiadamiania. |
Organ zadaniowy CLI dla agenta hosta
Zamień profil i miejsce ścieżki, a następnie zapisz recurring-task.txt w folderze zadań. Użyj tego ciała do wykonania CLI, lub ciała MCP powyżej do wykonania MCP. Bezpośredni terminarz OS może uruchomić skrypt Bash z tymi zmiennymi środowiskowymi bez modelu.
Uruchom zatwierdzone zadanie badawcze FlashData pod użytkownikiem OS, który zapisał klucz.
Runner: < ścieżka bezwzględna do run-research.sh >
Ustaw te zmienne środowiskowe dla procesu runner:
FLASHDATA_BIN: < bezwzględna ścieżka do flashdata >
FLASHDATA_PROFILE: < istniejąca nazwa profilu >
FLASHDATA_STATE_DIR: < istniejący katalog stanu absolutnego >
Utrzymuj nieustawiony FLASHDATA_API_KEY, aby ponownie wykorzystać zapisany element kredytowy.
Użyj oryginalnej planowanej daty w Asia/Shanghai, jako RRRR- MM- DD.
Dla ręcznego uruchomienia, zapisać datę jego wywołania przed wykonaniem.
Uruchom: bash "<absolute path to run-research.sh>" RRRR-MM- DD
Utrzymuj tę datę na powtórkach, nawet po północy. Pozwól na jedną aktywną egzekucję.
Zachowaj ten sam profil, request.json i katalog stanu.
Tylko przeczytaj datowany result.json po pomyślnym zakończeniu komendy.
Zgłoś linki źródłowe, uruchom ID i wykorzystanie. Utrzymuj wyjścia lokalne.
Po błędzie zatrzymaj i zgłoś zapisany błąd. Nie należy rozpoczynać prac zastępczych ani tworzyć nowego dostępu.1. Utwórz nieaktywne zadanie OpenClaw
Użyj uruchomionej bramy i istniejącego agenta, który przeszedł kontrolę dostępu. Poniższe komendy używają OpenClaw 2026.10.10; aktualizują starszych klientów, jeśli --wait jest niedostępny. W folderze zawierającym recurring-task.txt, ustaw OPENCLAW_AGENT_ID na ID tego agenta.
Polecenie zapisuje openclaw-job.json bez nadpisywania istniejącego pliku. Przeczytaj go i ustaw OPENCLAW_JOB_ID do zadania zwracanego ID. Jeśli tworzenie traci swoją odpowiedź, sprawdź listę automatyzacji --all --json przed utworzeniem innego zadania. --no-deliver wyłącza automatyczne ogłoszenie; jednostka zadaniowa również przechowuje raporty lokalne.
: "${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. Sprawdzanie zapisanego zadania przed jego uruchomieniem
Uruchom zapisane zadanie raz, gdy jego harmonogram pozostaje wyłączony. Budżet na jedną wyszukiwanie testowe i koszty modelu; dopasowanie ukończone zdarzenie CLI może ponownie wykorzystać swój wynik. Polecenie to czeka do 10 minut.
Oczekuj completionStatus: udało się, a następnie sprawdzić zapisany wynik, linki źródłowe i wykorzystanie. Dla CLI, przeczytaj runs/DATE/result.json i receipt.json; dla MCP, przeczytaj zapisany przez hosta przypadek i wynik zadania. enqueued: true sam oznacza akceptowane, nie zakończone.
: "${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.jsonSprawdzić, czy test jest wygięty, czy nie
Przerwa przestaje czekać, a nie zadanie Gateway. Przeczytaj najnowszą historię, jeśli paragon jest pusty. Ustaw OPENCLAW_RUN_ID na OpenClaw runId z paragonu lub historii, a następnie sprawdź to wykonanie. Nie powtarzaj komendy run, aby sprawdzić postęp.
To jest wykonanie terminarza ID- FlashData powtarzalny bieg ID lub MCP zadanie danych ID. Jeśli agent nie mógł zalogować się lub wykonać zadania z danymi, należy wyłączyć harmonogram i najpierw naprawić ten krok.
: "${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. Włącz po sprawdzeniu wyjścia
Przegląd zapisanego agenta, harmonogram, strefa czasowa i zakończone badanie. Włącz tylko wtedy, gdy wynik jest poprawny i koszt powtarzający się jest zatwierdzany. Wyłączenie późniejszego zatrzymania przyszłych zaproszeń; nie anuluje już przesłanego zapytania.
: "${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"Ustawienie zasad dotyczących kosztów i błędów
| Sytuacja | Działanie |
|---|---|
| Planowanie kosztów | Cena za zapytanie × planowane zdarzenia. Dodawanie modelu i kosztów hosta osobno; liczba wyników nie jest liczbą zapytań. |
| Saldo wspólnego rachunku | Wymuszanie budżetu w scheduler lub host. Przykłady te nie nakładają odrębnego kluczowego limitu wydatków. |
| 401 / 403 / 402 | Wstrzymać przyszłe wysyłki. Poprawiaj referencje, pozwolenie lub równowagę; wznawiaj z pierwotnym wystąpieniem i zapisanym stanem. |
| 429 | Szacunek dla Retry-After. Przed podjęciem decyzji, czy nowe zgłoszenie jest bezpieczne, należy sprawdzić przebieg CLI lub wystąpienie MCP. |
| Nieznany wynik składania | Zachowaj stan zapisany i przestań. Odzyskiwanie znanego zadania ID; nie tworzyć świeżej wersji ID, aby obejść niepewność. |
Zatrzymać harmonogram i cofnąć dostęp oddzielnie
- Wstrzymaj terminarz, aby zatrzymać przyszłe inwokacje.
- Przywróć połączenie agenta, aplikację OAuth lub klucz API w konsoli. Odwołanie blokuje nowe uwierzytelnione użycie; nie usuwa eksportowanych plików.
- Powtórzyć kontrolę dostępu ze świeżego procesu. Powinno się nie udać po odwołaniu. CLI auth logout usuwa tylko lokalne referencje; nie cofa zdalnego dostępu.