# Herstellen van een agent integratie

Herstel een onderbroken CLI of MCP taak met behulp van de opgeslagen run, taak of resultaat ID.

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

<a id="start"></a>

## Begin met de ID die je hebt opgeslagen

Pauzeer de mislukte taak of schema. Zoek de ontvangst ervan in uw taakmap of agentgeschiedenis en volg dan het bijbehorende pad. Deze IDs zijn niet uitwisselbaar.

| Dat heb je | Gebruik |
| --- | --- |
| CLI runId | De CLI stappen hieronder, met het oorspronkelijke profiel en de status directory. |
| MCP job ID · job_. | get_job op de bestaande MCP verbinding. |
| MCP resultaat ID · resultaat_. | get_result aan finish met een grote respons. |
| OpenClaw draait ID | OpenClaw draait geschiedenis, dan de FlashData ID die door die run is opgenomen. |

- [CLI herstel](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md#inspect)
- [MCP herstel](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw run geschiedenis](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Controleer de CLI-run

Open Bash (Git Bash op Windows) als de originele OS-gebruiker, in de uitvoermap van uw taak. Vervang alle drie onderstaande waarden door die van de oorspronkelijke taak. Houd deze terminal open voor stappen 2 en 3. Het uitschakelen van FLASHDATA_API_KEY laat de CLI de sleutel gebruiken die in dit profiel is opgeslagen.

### Selecteer de bestaande taak · deze terminal

```bash
# Replace these with the values used by the original task.
export FLASHDATA_PROFILE='research'
export FLASHDATA_STATE_DIR='/absolute/path/to/existing/flashdata-state'
export RUN_ID='scheduled-research:2026-11-04:Asia-Shanghai'
unset FLASHDATA_API_KEY
```

### Lokale inspectie · geen API oproepen

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata doctor --offline --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata runs show "$RUN_ID" --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


<a id="run-status"></a>

### Kies de herstelactie

Lees data.status, data.remoteId en data.errorCode in de run record.

| Opgenomen status | Wat je moet doen |
| --- | --- |
| succeeded | Controleer de toegang en exporteer het opgeslagen resultaat in stap 3. |
| accepted | Controleer de toegang en herstel vervolgens de geaccepteerde taak in stap 3. |
| uncertain / intent | Hou de taak gepauzeerd. Controleer remoteId, candidateRemoteIds en History voordat u beslist of u iets opnieuw wilt indienen. |
| failed | Fix errorCode eerst. Een mislukt record wordt behouden; een vervanging is een nieuwe taak en kan credits gebruiken. |
| partial | Houd beschikbare uitgangen. Herstellen bekende banen; voor bulk werk, inspecteren elke rij voor het vervangen van mislukte items. |
| run_not_found | Controleer het profiel, OS gebruiker en de status directory. Zoek naar opgeslagen ontvangstbewijzen of History als het journaal verloren is gegaan. |

- [Geschiedenis van een verzoek openen](https://flashdata.dev/app/jobs)
- [Herstellen bulkresultaten](https://flashdata.dev/nl/docs/guides/bulk/reference.md)

<a id="decide"></a>

## 2. Toegang tot CLI-account controleren

Deze gratis controles vereisen toegang tot de oorspronkelijke account en API oorsprongen. Los een authenticatiefout op voordat u resultaten herstelt.

### Toegang verifiëren en de balans lezen

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
flashdata account balance --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


<a id="access-result"></a>

### Controleer deze velden

Een nulbalans is een financieringskwestie voor nieuw werk. Het betekent op zichzelf niet dat de sleutel ongeldig is.

| auth status-veld | Verwacht |
| --- | --- |
| data.accessVerified | true; anders fix toegang voor het lezen van resultaten. |
| data.identity.identity.accountId | De rekening die de taak heeft ingediend. |
| data.identity.permittedSources | Bevat de bron die gebruikt wordt door de opgeslagen taak. |
| data.identity.identity.recurringAllowed | true alvorens een terugkerende taak te hervatten. |


<a id="account-change"></a>

### De rekening is veranderd, of ik heb net een proces aangevraagd.

run_account_mismatch betekent dat de opgeslagen run behoort tot een andere account of API origin. Het hergebruiken van de profielnaam brengt die run niet over.

| Situatie | Actie |
| --- | --- |
| Verkeerde account | Controleer de omgevingstoets override, geselecteerd profiel en management/data oorsprongen. Herstel de voorgenomen rekening voordat de terugvordering. |
| Sleutel geroteerd | Gebruik een vervangende sleutel voor hetzelfde account met de vereiste brontoestemming. Houd het oorspronkelijke profiel, de status directory en voer ID uit. |
| Geclaimde rechtszaak | De eigenaar account verschilt van de tijdelijke account. Lees trial-uitvoert die u al hebt geëxporteerd. Gebruik een nieuwe run ID alleen voor een geplande nieuwe eigenaar taak; het maakt gebruik van het saldo van de eigenaar. |

- [Een eigenaarsleutel vervangen](https://flashdata.dev/nl/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Proefgebruik en accountkoppeling](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md#owner-result)

<a id="handoff"></a>

### Hervat een onderbroken claim

Voor een goedgekeurde claim, draai auth finish in zijn oorspronkelijke profiel binnen het 24-uur handoff venster. Het bespaart en controleert de sleutel van de eigenaar, dan erkent installatie. Het tweede commando controleert de opgeslagen toegang in een nieuw proces.

#### Voltooi de bestaande overdracht

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
# Resume an already approved claim in its original profile.
flashdata auth finish --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive

# A second process checks the saved owner access.
flashdata auth status --profile "${FLASHDATA_PROFILE:-research}" \
  --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```

- [Verlopen claim of verloren registratiereactie](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md#help)
- [Authenticatieprotocol](https://flashdata.dev/auth.md)

<a id="recover"></a>

## 3. Het CLI-resultaat herstellen

Kies de opgeslagen status uit stap 1. Gebruik een uitvoerbestandsnaam die niet bestaat. Beide commando's controleren de toegang en houden de oorspronkelijke run; geen van beide dient een vervangende query.

### Opgeslagen succes

#### Het opgeslagen resultaat exporteren

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs show "$RUN_ID" --result --output recovered.json \
  --profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


### Geaccepteerde async-taak

Een stemronde stopt het lokale wachten. Voer dit herstel commando opnieuw uit om te blijven wachten op dezelfde baan.

#### Wacht op de oorspronkelijke taak

```bash
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
: "${RUN_ID:?Set the run ID from the original receipt}"
flashdata runs recover "$RUN_ID" --output recovered.json --timeout 10m \
  --profile "${FLASHDATA_PROFILE:-research}" --state-dir "$FLASHDATA_STATE_DIR" --json --non-interactive
```


- [Lees een bekende externe taak ID](https://flashdata.dev/nl/docs/guides/async-batch/reference.md#job-status)

<a id="verify"></a>

### Bevestiging van de terugvordering voordat de procedure wordt hervat

1. Controleer exit code 0 en ok: true, open dan recovered.json. Gesaved-result exports hebben cached: true; gebruik verwijst naar de oorspronkelijke uitvoering.
2. Houd hetzelfde account, profiel, status en voer ID uit bij het opnieuw proberen van dit voorval. Verwijder het journaal niet of hernoem de run om een nieuwe poging te forceren.
3. Hervatten planning alleen na toegang en het resultaat worden geverifieerd. Geef elke nieuwe geplande gebeurtenis zijn eigen run ID.

- [Terugkerende-taakrunner](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md#slot)
- [Resultaten opslaan voor later gebruik](https://flashdata.dev/nl/docs/guides/save-results/reference.md)

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

## Herstellen van een MCP taak

MCP-gesprekken maken geen CLI-run records. Gebruik de bestaande MCP-verbinding voor het account dat de opdracht heeft ingediend. Vervang de taak ID in deze prompt en stuur deze naar je verbonden agent.

### Plakken in je verbonden agent

```text
Herstel mijn bestaande FlashData job: job_REPLACE_WITH_SAVED_ID.
Gebruik de huidige MCP verbinding. Bel get_balance met {} om toegang te controleren,
dan get_job met deze job_id.
Als het antwoord result_id bevat, finish die zijn get_result-chunks leest
en te combineren voordat je de JSON ontleedt.
Voor job.status in behandeling of verwerking, poll dezelfde taak elke 5 seconden
voor maximaal 2 minuten, rapporteer dan de nieuwste status en stop.
Voor voltooide, opslaan uitvoer en de bron URLs en gebruik in deze taak.
Bij een toegangsfout, mislukte taak of niet beschikbaar resultaat, stop en rapporteer de ID.
Voer geen bronprogramma uit, stuur een batch in of maak nieuwe referenties aan.
```

- [Een MCP-host opnieuw verbinden](https://flashdata.dev/nl/docs/guides/agent-access/reference.md)
- [MCP gereedschapsreferentie](https://flashdata.dev/nl/docs/mcp/reference.md)

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

### Lees de originele taak

Voor een aangepaste MCP client, geef dit object door aan callTool na het vervangen van job_id. Dit is een tool call, geen shell commando. get_job controleert de job account en bronmachtiging; een succesvolle get_balance check alleen bewijst geen toegang tot deze job.

#### get_job

```json
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}
```


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

### Controleer de functiestatus van MCP

| Antwoord | Volgende actie |
| --- | --- |
| job.status: pending / processing | Wacht, lees dan dezelfde taak ID. Een lokale timeout annuleert het niet. |
| job.status: completed | Bespaar output. Het gebruik ervan behoort tot de oorspronkelijke query; get_job hoeft niet in te dienen of te rekenen voor een nieuwe query. |
| job.status: failed / isError: true | Lees de fout voordat u een uitvoer gebruikt. De bron niet automatisch opnieuw uitvoeren. |
| code: result_unavailable | Probeer de read opnieuw voor een voorbijgaande leveringsfout. Als het opgeslagen resultaat verlopen is, gebruik eerdere export. Async JSON resultaten worden bewaard voor 24 uren. |


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

### Een grote MCP respons werd onderbroken

Gebruik de opgeslagen result_id met dezelfde API sleutel. Start bij offset 0 om het hele antwoord weer op te bouwen; als je de eerdere brokken bewaarde, gebruik dan in plaats daarvan de exacte next_offset. Plaatshouder vervangen voordat u deze tool aanroept.

1. Voeg elke brok toe in volgorde, met behulp van next_offset totdat het null is. Pas na de laatste brok de gecombineerde JSON ontleden.
2. De cache duurt 10 minuten en houdt de vier nieuwste grote reacties per toets. Als het verlopen is of is uitgezet en u een taak ID hebt opgeslagen, bel dan opnieuw get_job en lees de nieuwe brokken ervan.
3. Een real-time respons heeft geen gegarandeerd herstelbare achtergrond baan. Zonder een opgeslagen taak ID of exporteren, controleer History en vraag het voordat u een nieuwe betaalde query uitvoert.

#### get_result

```json
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}
```

- [MCP-client met chunk handling](https://flashdata.dev/nl/docs/guides/mcp-custom-client/reference.md)

<a id="missing-id"></a>

## Ik heb geen run of job ID

Controleer de opgeslagen bestanden van de taak, de geschiedenis van het hulpmiddel en het verzoek van de eigenaar History. Een request_id is een kenmerkende ID, geen job_id. Als u niet kunt bevestigen of de inzending is geaccepteerd, houd dan de taak gepauzeerd. Het herhalen van de oorspronkelijke bronoproep kan een andere lading aanmaken.

- [Geschiedenis van een verzoek openen](https://flashdata.dev/app/jobs)

<a id="errors"></a>

## Vind een fix door foutcode

| Signaal | Repareren |
| --- | --- |
| 400 / 422 | Controleer de argumenten tegen de tool of eindpunt schema. Voor CLI-verzoeken, gebruik query --dry-run voordat een nieuwe taak. |
| 401 / 403 | Controleer voor CLI de toegang in stap 2. Voor MCP OAuth, laat de host vernieuwen; een ingetrokken subsidie heeft een door de eigenaar goedgekeurde herverbinding nodig. Controleer met een API-sleutel de geheime en bronrechten van de host. |
| 402 | Stop met nieuw werk totdat de eigenaar de financiering heeft opgelost. |
| 406 | Accept gebruiken: application/json. Vraag voor ondersteunde inhoudseindpunten Markdown met X-Respond-With: markdown. |
| 429 | Eer Retry-After en herstel een bekende taak voordat opnieuw te verzenden. Wachten ontruimt een mislukt CLI-runrecord niet. |
| Timeout / 5xx / verloren respons | Herstellen bekende geaccepteerde banen. Houd onbekende indieningsresultaten gepauzeerd en controleer History. |
| run_id_input_conflict | Herstellen van de oorspronkelijke invoer. Nieuwe invoer heeft een bewuste nieuwe taak nodig en start ID. |
| run_account_mismatch | Gebruik de account-change checklist in stap 2; een nieuwe run ID is geen herstel snelkoppeling. |
| output_exists | Kies een nieuwe uitvoerbestandsnaam. Hou de geredde run. |
| result_unavailable | Voor MCP, controleer de taak of brokstappen hierboven. Voor CLI, herstel de geaccepteerde externe taak. Verlopen resultaten hebben een eerdere export of uw eigen opslag nodig. |

- [HTTP-foutreferentie](https://flashdata.dev/nl/docs/errors/reference.md)
- [Een MCP-host opnieuw verbinden](https://flashdata.dev/nl/docs/guides/agent-access/reference.md)

<a id="support"></a>

## Stuur een diagnose om te ondersteunen

Voer voor CLI dit jq filter uit op de error.json die door uw taak is opgeslagen. Voor MCP, kopieer code, http_status en request_id van de toolrespons, plus de opgeslagen job_id of result_id. Inclusief de clientversie, eindpunt, UTC-tijd en of acceptatie wordt bevestigd of niet. Exclusief referenties, cookies en ondertekende URLs.

### Selecteer kenmerkende velden · alleen lokaal

```bash
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json
```

- [Contact met support](https://flashdata.dev/nl/contact)
