Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Handleidingen

Herstellen van een agent integratie

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

Op deze pagina

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 jeGebruik
CLI runIdDe 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 IDOpenClaw draait geschiedenis, dan de FlashData ID die door die run is opgenomen.

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
# 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
: "${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

Kies de herstelactie

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

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

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
: "${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

Controleer deze velden

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

auth status-veldVerwacht
data.accessVerifiedtrue; anders fix toegang voor het lezen van resultaten.
data.identity.identity.accountIdDe rekening die de taak heeft ingediend.
data.identity.permittedSourcesBevat de bron die gebruikt wordt door de opgeslagen taak.
data.identity.identity.recurringAllowedtrue alvorens een terugkerende taak te hervatten.

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.

SituatieActie
Verkeerde accountControleer de omgevingstoets override, geselecteerd profiel en management/data oorsprongen. Herstel de voorgenomen rekening voordat de terugvordering.
Sleutel geroteerdGebruik een vervangende sleutel voor hetzelfde account met de vereiste brontoestemming. Houd het oorspronkelijke profiel, de status directory en voer ID uit.
Geclaimde rechtszaakDe 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.

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
: "${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

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.

Het opgeslagen resultaat exporteren
: "${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

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.

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

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
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}

Controleer de functiestatus van MCP

AntwoordVolgende actie
job.status: pending / processingWacht, lees dan dezelfde taak ID. Een lokale timeout annuleert het niet.
job.status: completedBespaar 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: trueLees de fout voordat u een uitvoer gebruikt. De bron niet automatisch opnieuw uitvoeren.
code: result_unavailableProbeer de read opnieuw voor een voorbijgaande leveringsfout. Als het opgeslagen resultaat verlopen is, gebruik eerdere export. Async JSON resultaten worden bewaard voor 24 uren.

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
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}

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.

Vind een fix door foutcode

SignaalRepareren
400 / 422Controleer de argumenten tegen de tool of eindpunt schema. Voor CLI-verzoeken, gebruik query --dry-run voordat een nieuwe taak.
401 / 403Controleer 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.
402Stop met nieuw werk totdat de eigenaar de financiering heeft opgelost.
406Accept gebruiken: application/json. Vraag voor ondersteunde inhoudseindpunten Markdown met X-Respond-With: markdown.
429Eer Retry-After en herstel een bekende taak voordat opnieuw te verzenden. Wachten ontruimt een mislukt CLI-runrecord niet.
Timeout / 5xx / verloren responsHerstellen bekende geaccepteerde banen. Houd onbekende indieningsresultaten gepauzeerd en controleer History.
run_id_input_conflictHerstellen van de oorspronkelijke invoer. Nieuwe invoer heeft een bewuste nieuwe taak nodig en start ID.
run_account_mismatchGebruik de account-change checklist in stap 2; een nieuwe run ID is geen herstel snelkoppeling.
output_existsKies een nieuwe uitvoerbestandsnaam. Hou de geredde run.
result_unavailableVoor 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.

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
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json