# Herhaalde taken uitvoeren

Hergebruik goedgekeurde toegang, voer een zoekopdracht per geplande gebeurtenis, en herstellen zonder per ongeluk hetzelfde werk opnieuw indienen.

Canonische referentie: https://flashdata.dev/nl/docs/guides/recurring-tasks
Beoordeeld: 2026-11-05 door FlashData

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

## Kies hoe de taak loopt

Uw agent host of OS scheduler levert de timing. FlashData levert de gegevens. Kies één uitvoeringspad en test het in de omgeving die onbeheerd zal draaien.

| Gebruik | Voor | Staat te behouden |
| --- | --- | --- |
| CLI | Een agent met terminal toegang, cron, of een gepland script. | Het CLI-profiel, de status directory en de originele draaien ID. |
| MCP | Een agent host met een verbonden FlashData server. | De referenties van de host, optreden record, baan IDs en resultaten. |

- [CLI-taak](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md#input)
- [MCP-taak](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md#mcp)
- [Bouw een dagelijkse briefing](https://flashdata.dev/nl/docs/guides/daily-research-briefing/reference.md)

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

## Toegang controleren in de geplande omgeving

Hergebruik een bestaande eigenaar verbinding met google_search toestemming. Verzoek om tijdelijke toegang voor herhaald gebruik. Test van een nieuw gepland proces of sessie, niet alleen een interactieve.

### CLI

Gebruik Bash en jq (Git Bash op Windows), onder de OS gebruiker die de sleutel heeft opgeslagen. Stel hieronder uw bestaande profielnaam en absolute statusmap in. Start beide blokken in dezelfde terminal; de loper gebruikt deze instellingen.

De toegangscontrole moet true afdrukken. Vergelijk availableCredits met estimatedCredits voor de eerste zoekopdracht. Bij deze controles wordt geen vraag gesteld.

#### Uw opgeslagen verbinding instellen

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

#### Vrije toegang, evenwicht en prijscontroles

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

Voer dit uit in een nieuwe geplande sessie. Laat de host zijn goedgekeurde OAuth-gegevens hergebruiken en vernieuwen. Het moet in staat zijn om FlashData te bereiken zonder een interactieve login bij elke run.

#### Gratis host check

```text
Gebruik de bestaande FlashData MCP verbinding in deze geplande omgeving.
Bel get_balance met {}.
Bel get_pricing met {"source":"google_search","request_count":1}.
Rapporteer het saldo en de geraamde prijs. Niet zoeken of nieuwe toegang creëren.
```


- [Installeer de CLI](https://flashdata.dev/nl/docs/guides/flashdata-cli/reference.md#install)
- [MCP verbinden](https://flashdata.dev/nl/docs/integrations/mcp-clients/reference.md)
- [Toegang tot een proces voor vorderingen](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md#claim)

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

## CLI: sla één taak op per voorkomen

Maak de onderstaande taakmap aan en sla dan request.json en run-research.sh erin op. Deze map gescheiden houden van de bestaande credential state directory. Eén datum staat voor één Google query; num stelt het aantal resultaten in. Geef een andere workflow een eigen run-ID prefix voor de eerste uitvoering.

### De taakmap aanmaken

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

### run-research.sh opslaan

Maak run-research.sh naast request.json in de taakmap. Kopieer het volledige script hieronder in het en sla het op voordat de taak wordt uitgevoerd of gepland.

Het script bevriest de invoer voor elke datum en houdt een ontvangst-, resultaat- en foutbestand voor elke poging. Alleen succesvolle pogingen publiceren result.json en receipt.json op het hoogste niveau van de gedateerde map. --recurring controleert de toegang van de eigenaar; het maakt geen schema.

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

### Eenmaal uitvoeren, dan een nieuw proces opnieuw proberen

Uitvoeren vanuit de taakmap. Het eerste commando dient een zoekopdracht in. De tweede gebruikt hetzelfde account, invoer, profiel en status om het opgeslagen resultaat te lezen na te controleren of de toegang nog geldig is.

#### Eén voorval · twee processen starten

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

### Bevestigen dat het resultaat hergebruikt is

Het tweede ontvangstbewijs moet cached: true tonen. Het gebruik ervan behoort tot de oorspronkelijke zoekopdracht. Een lege organische array kan nog steeds een succesvol resultaat zijn.

#### Controleer het opgeslagen resultaat en ontvangst

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

#### Tweede ontvangstbewijs · uittreksel

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


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

### Bewaar de bestanden tussen runs

| Bestand | Gebruik |
| --- | --- |
| runs/DATE/request.json | Exacte invoer voor dat optreden; het veranderen ervan zorgt ervoor dat de runner stopt. |
| runs/DATE/result.json + receipt.json | De laatste succesvolle poging. Gebruik ze alleen nadat het huidige commando met succes wordt afgesloten. |
| runs/DATE/attempt.*/ | Resultaat, ontvangst en fout voor elke poging, inclusief fouten. |
| FLASHDATA_STATE_DIR | Beschermde referenties en CLI draaien records. Houd hetzelfde profiel en OS gebruiker. |

- [Herstellen van een onderbroken run](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md)

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

## MCP: het voorkomen aanhouden en ID uitvoeren

Gebruik deze taakgroep met een host die duurzame taakstatus behoudt en één actieve uitvoering per optreden toestaat. Bewaar de geretourneerde taak ID onmiddellijk; na een herstart, lees de geaccepteerde taak in plaats van opnieuw te zoeken.

### MCP terugkerende taak · opslaan als recurring-task.txt

```text
Gebruik het oorspronkelijke voorval ID van de scheduler en de geplande tijd.
Hergebruik de bestaande FlashData MCP-verbinding en bewaar de voorvalrecords.
1. Als dit optreden voltooid is, geef dan het opgeslagen resultaat terug zonder te zoeken.
2. Als het een taak heeft ID, bel get_job met die job_id om het bestaande werk te lezen.
3. Als een inzending is gestart maar geen resultaat of taak heeft ID, stop dan voor beoordeling.
4. Voor een nieuwe gebeurtenis, controleer get_balance en get_pricing voor één google_search.
   Uitsluitend binnen de goedgekeurde begroting per taak en het beschikbare saldo voortzetten.
5. Persist submission_started voordat u google_search aanroept met:
   {"query":"battery recycling pilot plant announcements","num":5,"gl":"us","hl":"en","tbs":"qdr:w","mode":"async"}
6. Bewaar de teruggekeerde baan ID onmiddellijk. Lees het met get_job tot terminal; stop bij falen.
   Houd de ID gedurende de timeouts en stop met wachten op de deadline van de host.
7. Sla het resultaat, bron URLs en het gebruik op, markeer dan dit voorval voltooid.
Op 401, 403, 402, 429 of een onbekend resultaat, stop en rapporteer de opgeslagen record.
Eer Retry-After. Maak geen vervangende toegang of een andere betaalde query.
Houd het rapport lokaal; gebruik een leveringsbestemming alleen indien afzonderlijk geconfigureerd.
```

- [MCP-gereedschappen](https://flashdata.dev/nl/docs/mcp/reference.md)
- [Lees een geaccepteerde baan](https://flashdata.dev/nl/docs/mcp/reference.md#jobs)

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

### Wat de gastheer moet volhouden

Een prompt alleen kan duplicaten niet voorkomen. MCP-aanroepen erven CLI-run-ID-bescherming niet. Uw host moet het oorspronkelijke voorkomen, de inzendingstoestand en de functie ID aanhouden. Als het niet lukt, gebruik dan de CLI runner voor de data step. Dit voorbeeldrecord behoort toe aan uw host; het is geen MCP verzoek.

#### Host record · illustratief

```json
{
  "occurrence": "research:2026-11-04:Asia-Shanghai",
  "state": "accepted",
  "job_id": "<returned job ID>",
  "output": null
}
```


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

## Plan de geteste taak

Het voorbeeld hieronder gebruikt OpenClaw op 09:00 Asia/Shanghai. Maak de taak uitgeschakeld, voer die taak handmatig opgeslagen, controleer de uitvoer en schakel het vervolgens in. Voor een andere scheduler, volg dezelfde volgorde met zijn test-run controles.

| Instellingen | Gebruik |
| --- | --- |
| Concurrency | Een actieve uitvoering voor deze workflow, met duurzame staat. |
| Starttijd | Gebruik dezelfde OS-gebruiker en absolute paden voor de CLI, taakmap en credential status. Terminal export wordt niet automatisch geërfd door een draaiende Gateway. |
| Herhalingen | Houd de oorspronkelijke gebeurtenis en geplande datum, inclusief na middernacht. Een handmatige test gebruikt zijn aanroepdatum in Asia/Shanghai. |
| Gemiste voorvallen | Kies of je moet overslaan of bijpraten. Een zoekopdracht vandaag geeft actuele gegevens terug, zelfs als gelabeld met de datum van gisteren. |
| Levering | Eerst lokaal opslaan. Een bestemmings- en meldingsbeleid configureren voordat u rapporten verzendt. |

- [Maak een server of container klaar](https://flashdata.dev/nl/docs/guides/production-deployment/reference.md)

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

### CLI taakgroep voor een agent-host

Vervang het profiel en de padplaatshouders en sla dan recurring-task.txt op in de taakmap. Gebruik deze body voor CLI uitvoering, of de MCP body hierboven voor MCP uitvoering. Een directe OS scheduler kan het Bash script uitvoeren met deze omgevingsvariabelen zonder model.

#### recurring-task.txt

```text
Voer de goedgekeurde FlashData onderzoekstaak uit onder de OS-gebruiker die de sleutel heeft opgeslagen.
Uitvoerder: <absoluut pad naar run-research.sh>
Stel deze omgevingsvariabelen in voor het loopproces:
FLASHDATA_BIN: <absoluut pad naar flashdata>
FLASHDATA_PROFILE: <bestaande profielnaam>
FLASHDATA_STATE_DIR: <bestaande absolute statusmap>
Houd FLASHDATA_API_KEY unset om de opgeslagen credential te hergebruiken.
Gebruik de oorspronkelijke geplande datum in Asia/Shanghai, als JJJJ-MM-DD.
Voor een handmatige run, bewaar de aanroepingsdatum voor de uitvoering.
Uitvoeren: bash "<absolute path to run-research.sh>"JJJJ-MM-DD
Hou die date op retrieves, zelfs na middernacht. Laat één actieve executie toe.
Houd hetzelfde profiel, request.json en state directory.
Lees alleen de gedateerde result.json nadat het commando met succes wordt afgesloten.
Rapporteer bronlinks, start ID en gebruik. Hou de uitgangen lokaal.
Bij fout, stop en meld de opgeslagen fout. Begin niet met vervangingswerk of creëer geen nieuwe toegang.
```


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

### 1. Een uitgeschakelde OpenClaw-taak aanmaken

Gebruik een draaiende Gateway en een bestaande agent die de toegangscontrole heeft doorstaan. De onderstaande commando's gebruiken OpenClaw 2026.10.10; oudere clients bijwerken als --wait niet beschikbaar is. In de map met recurring-task.txt, zet OPENCLAW_AGENT_ID op ID van dat middel.

Het commando slaat openclaw-job.json op zonder een bestaand bestand te overschrijven. Lees het en stel OPENCLAW_JOB_ID in op de teruggekeerde job ID. Als creatie verliest zijn reactie, inspecteren automatiseringslijst --all --json voordat het creëren van een andere taak. --no-deliver schakelt automatische aankondiging; de taakgroep houdt ook rapporten lokaal.

#### Bash · creëert een functie met een handicap

```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/nl/docs/integrations/openclaw/reference.md)
- [OpenClaw-schemareferentie](https://docs.openclaw.ai/cli/cron)

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

### 2. Test de bewaarde taak voordat deze wordt ingeschakeld

Voer de bewaarde job één keer uit terwijl het schema uitgeschakeld blijft. Budget voor één testzoek- en modelkosten; een bijpassende CLI-voorval kan het resultaat hergebruiken. Dit commando wacht tot 10 minuten.

Verwacht completionStatus: geslaagd, controleer dan het opgeslagen resultaat, bronlinks en gebruik. Lees voor CLI runs/DATE/result.json en receipt.json; lees voor MCP het opgeslagen voorkomen en het resultaat van de taak van de host. enqueued: true alleen betekent geaccepteerd, niet voltooid.

#### Eenmaal uitvoeren · Bewaar het testbewijs

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

#### Lees het testbewijs

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


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

### Controleer een timed-out of mislukte test

Een time-out stopt met wachten, niet de Gateway taak. Lees de recente geschiedenis als het ontvangstbewijs leeg is. Stel OPENCLAW_RUN_ID in op de OpenClaw runId uit het ontvangstbewijs of de geschiedenis, controleer dan die uitvoering. Herhaal het commando om de voortgang te controleren.

Dit is de planningsuitvoering ID, niet de FlashData recurrente run ID of een MCP datataak ID. Als de agent niet kon inloggen of uitvoeren van de gegevenstaak, houd het schema uitgeschakeld en repareer die stap eerst.

#### Dezelfde uitvoering controleren

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

- [Herstellen van de FlashData-datastap](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md)

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

### 3. Inschakelen na het controleren van de uitvoer

Bekijk de opgeslagen agent, schema, tijdzone en afgeronde test. Pas inschakelen nadat de output correct is en de terugkerende kosten worden goedgekeurd. Later uitschakelen stopt toekomstige aanroepingen; het annuleert een reeds ingediende query niet.

#### Bekijk de bewaarde taak en testgeschiedenis

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

#### Het dagelijkse schema inschakelen

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

#### Toekomst draait pauzeren indien nodig

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


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

## Regels voor kosten en fouten instellen

| Situatie | Actie |
| --- | --- |
| Kostenplanning | Prijs per query × geplande gebeurtenissen. Voeg model en host kosten afzonderlijk; het aantal resultaten is niet query tellen. |
| Gedeelde rekening | Dwing uw budget in de scheduler of host. Deze voorbeelden leggen geen afzonderlijke uitgavenplafonds op. |
| 401 / 403 / 402 | Pauzeer toekomstige berichten. Repareer de referenties, toestemming of balans; hervat met de oorspronkelijke gebeurtenis en opgeslagen status. |
| 429 | Respecteer Retry-After. Controleer de CLI-run of MCP-voorval alvorens te beslissen of een nieuwe indiening veilig is. |
| Onbekend resultaat van indiening | Hou de geredde staat en stop. Herstel een bekende taak ID; maak geen frisse run ID om de onzekerheid te omzeilen. |

- [Huidige prijzen](https://flashdata.dev/nl/pricing)
- [Terugvorderingsbeschikkingen](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md)

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

## Stop het schema en trek de toegang apart in

1. Pauzeer de scheduler om toekomstige aanroepingen te stoppen.
2. Herroep de agentverbinding, OAuth-app of API-sleutel in de console. Herroeping blokkeert nieuw geauthentiseerd gebruik; het verwijdert geëxporteerde bestanden niet.
3. Herhaal de vrije toegangscontrole van een nieuw proces. Het moet mislukken na intrekking. CLI auth logout verwijdert alleen lokale referenties; het trekt geen toegang op afstand in.

- [Connected apps en agentia](https://flashdata.dev/app/settings/connections)
- [API-sleutels](https://flashdata.dev/app/api-keys)
- [Toegang tot de levenscyclus](https://flashdata.dev/nl/docs/guides/agent-access/reference.md)
