Sfoglia la documentazione
Guide
Recuperare un'attività interrotta CLI o MCP utilizzando la sua esecuzione salvata, il lavoro o il risultato ID.
In questa pagina
Inizia con la ID che hai salvato
Pausa l'attività o l'orario in cui manca. Trova il suo scontrino nella cartella di attività o nella cronologia dell'agente, quindi segui il percorso corrispondente. Questi IDs non sono intercambiabili.
| Tu hai | Uso |
|---|---|
| CLI runId | La CLI si muove di seguito, con il profilo originale e la directory di stato. |
| MCP job ID · job_. | get_job sulla connessione MCP esistente. |
| MCP risultato ID ·. | get_result a finish leggendo una grande risposta. |
| OpenClaw eseguire ID | OpenClaw esegue la storia, poi FlashData ID registrato da quell'esecuzione. |
1. Ispezionare l'esecuzione CLI
Aprire Bash (Git Bash su Windows) come utente originale OS, nella cartella di uscita del vostro compito. Sostituire tutti e tre i valori sottostanti con quelli dall'attività originale. Tenere aperto questo terminale per i passaggi 2 e 3. Sbloccante FLASHDATA_API_KEY consente a CLI di utilizzare la chiave salvata in questo profilo.
# 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: "${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-interactiveScegliere l'azione di recupero
Leggi data.status, data.remoteId e data.errorCode nel record di esecuzione.
| Stato registrato | Cosa fare |
|---|---|
| succeeded | Controllare l'accesso, quindi esportare il risultato salvato nel passaggio 3. |
| accepted | Controllare l'accesso, quindi recuperare il lavoro accettato nella fase 3. |
| uncertain / intent | Tenere il compito sospeso. Controllare remoteId, candidateRemoteIds e History prima di decidere se inviare di nuovo qualcosa. |
| failed | Fissa prima errorCode. Un record fallito viene mantenuto; un sostituto è un nuovo compito e può utilizzare crediti. |
| partial | Mantenere le uscite disponibili. Recuperare i lavori noti; per il lavoro di massa, ispezionare ogni riga prima di sostituire gli elementi falliti. |
| run_not_found | Controlla il profilo, utente OS e directory di stato. Cercare ricevute salvate o History se la rivista è persa. |
2. Controllare l'accesso dell'account CLI
Questi controlli gratuiti richiedono l'accesso al conto originale e alle origini API. Risolvere qualsiasi errore di autenticazione prima di recuperare i risultati.
: "${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-interactiveControlla questi campi
Un saldo zero è un problema di finanziamento per il nuovo lavoro. Non significa di per sé che la chiave è invalida.
| Campo auth status | Attesi |
|---|---|
| data.accessVerified | true; altrimenti fissare l'accesso prima dei risultati di lettura. |
| data.identity.identity.accountId | L'account che ha presentato l'attività. |
| data.identity.permittedSources | Include la fonte utilizzata dall'attività salvata. |
| data.identity.identity.recurringAllowed | true prima di riprendere un'attività ricorrente. |
Il conto è cambiato, o ho appena sostenuto una prova
run_account_mismatch significa che l'esecuzione salvata appartiene ad un account diverso o all'origine API. Riutilizzare il nome del profilo non trasferisce l'esecuzione.
| Situazione | Azione |
|---|---|
| Conto sbagliato | Controllare l'ambiente-chiave override, il profilo selezionato e le origini management/data. Ripristinare il conto previsto prima del recupero. |
| Chiave ruotata | Utilizzare una chiave di ricambio per lo stesso account con il permesso di origine richiesto. Mantenere il profilo originale, la directory di stato ed eseguire ID. |
| Prova prevista | L'account proprietario differisce dal conto temporaneo. Leggi le uscite di prova che hai già esportato. Utilizzare un nuovo run ID solo per un nuovo compito proprietario previsto; utilizza l'equilibrio del proprietario. |
Riprendi un reclamo interrotto
Per un reclamo approvato, eseguire auth finish nel suo profilo originale all'interno della finestra di consegna di 24-ora. Salva e verifica la chiave del proprietario, quindi riconosce l'installazione. Il secondo comando controlla l'accesso salvato in un nuovo processo.
: "${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-interactive3. Recuperare il risultato CLI
Scegliere lo stato salvato dal passaggio 1. Utilizzare un nome file di output che non esiste. Entrambi i comandi verificano l'accesso e mantengono l'esecuzione originale; né invia una query sostitutiva.
: "${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-interactiveUn timeout inquinante ferma l'attesa locale. Eseguire nuovamente questo comando di recupero per continuare ad aspettare lo stesso lavoro.
: "${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-interactiveConfermare il recupero prima di riprendere
- Controllare il codice di uscita 0 e ok: true, quindi aprire recovered.json. Le esportazioni di Risultato Risparmio hanno cacheto: true; l'utilizzo si riferisce all'esecuzione originale.
- Mantenere lo stesso account, profilo, stato e eseguire ID quando si riprova questo evento. Non eliminare la sua rivista o rinominare l'esecuzione per forzare una riprova.
- Riprendi la programmazione solo dopo l'accesso e il risultato viene verificato. Dare a ogni nuovo evento programmato il proprio eseguire ID.
Recuperare un'attività MCP
Le chiamate MCP non creano i record di esecuzione CLI. Utilizzare la connessione MCP esistente per l'account che ha presentato il lavoro. Sostituisci il lavoro ID in questo prompt e invialo al tuo agente connesso.
Recuperare il mio lavoro FlashData esistente: job_REPLACE_WITH_SAVED_ID.
Utilizzare la connessione MCP corrente. Chiama get_balance con {} per controllare l'accesso,
poi get_job con questo job_id.
Se la risposta contiene result_id, finish legge i suoi pezzi get_result
e combinarli prima di analizzare la JSON.
Per job.status in attesa o l'elaborazione, poll lo stesso lavoro ogni 5 secondi
per fino a 2 minuti, quindi segnalare lo stato più recente e arrestare.
Per completare, salvare l'output e la sua fonte URLs e l'utilizzo in questa attività.
Su un errore di accesso, lavoro fallito o risultato non disponibile, arrestare e segnalare il ID.
Non eseguire uno strumento sorgente, inviare un batch, o creare nuove credenziali.Leggi il lavoro originale
Per un client MCP personalizzato, passare questo oggetto a callTool dopo aver sostituito job_id. get_job controlla l'account di lavoro e il permesso di origine; un controllo di successo get_balance da solo non dimostra l'accesso a questo lavoro.
{
"name": "get_job",
"arguments": {
"job_id": "job_REPLACE_WITH_SAVED_ID"
}
}Controlla lo stato del lavoro MCP
| Risposta | Prossima azione |
|---|---|
| job.status: pending / processing | Aspetta, poi leggi lo stesso lavoro ID. Un timeout locale non lo cancella. |
| job.status: completed | Salvare l'output. Il suo utilizzo appartiene alla query originale; get_job non si presenta o addebita per una nuova query. |
| job.status: failed / isError: true | Leggere l'errore prima di utilizzare qualsiasi output. Non eseguire automaticamente la sorgente. |
| code: result_unavailable | Ripristinare la lettura per un guasto di consegna transitorio. Se il risultato salvato è scaduto, utilizzare le esportazioni precedenti. I risultati Async JSON vengono mantenuti per le ore 24. |
Una grande risposta MCP è stata interrotta
Utilizzare lo result_id salvato con la stessa chiave API. Iniziare a compensare 0 per ricostruire l'intera risposta; se hai mantenuto i pezzi precedenti, utilizzare il loro esatto next_offset invece. Sostituisci il segnaposto prima di chiamare questo strumento.
- Applicare ogni pezzo in ordine, utilizzando next_offset fino a quando non è null. Parsare il combinato JSON solo dopo l'ultimo pezzo.
- La cache dura i minuti 10 e mantiene le quattro più recenti risposte di grandi dimensioni per chiave. Se è scaduto o è stato sfrattato e hai salvato un lavoro ID, chiama get_job di nuovo e legge i suoi nuovi pezzi.
- Una risposta in tempo reale non ha un lavoro di sfondo recuperabile garantito. Senza un lavoro salvato ID o l'esportazione, controllare History e chiedere prima di eseguire una nuova query pagato.
{
"name": "get_result",
"arguments": {
"result_id": "REPLACE_WITH_RESULT_ID",
"offset": 0
}
}Non ho esecuzione o lavoro ID
Controllare i file salvati dell'attività, la cronologia degli strumenti dell'agente e la richiesta del proprietario History. A request_id è una ID diagnostica, non una job_id. Se non si può confermare se la presentazione è stata accettata, tenere il compito sospeso. Ripetire la chiamata di origine originale può creare un'altra carica.
Trovare una correzione per codice di errore
| Segnale | Risolto |
|---|---|
| 400 / 422 | Controllare gli argomenti contro lo strumento o lo schema endpoint. Per le richieste CLI, utilizzare query --dry-run prima di qualsiasi nuova attività. |
| 401 / 403 | Per CLI, controlla l'accesso al passaggio 2. Per MCP OAuth, lasciare che l'host rinfresca; una sovvenzione revocata ha bisogno di riconnessione approvata dal proprietario. Con una chiave API, controlla il segreto dell'host e le autorizzazioni di origine. |
| 402 | Smettere nuovi lavori fino a quando il proprietario non risolve i finanziamenti. |
| 406 | Utilizzare Accept: application/json. Per gli endpoint dei contenuti supportati, richiedere Markdown con X-Respond-With: markdown. |
| 429 | Honor Retry-After e recuperare qualsiasi lavoro conosciuto prima di inviare di nuovo. L'attesa non cancella un record di esecuzione CLI fallito. |
| Timeout / 5xx / risposta persa | Recuperare i lavori accettati noti. Tenere i risultati di presentazione sconosciuti interrotti e controllare History. |
| run_id_input_conflict | Ripristinare l'ingresso originale. Il nuovo input ha bisogno di un nuovo compito deliberato e di eseguire ID. |
| run_account_mismatch | Utilizzare la lista di controllo cambio account nel passo 2; una nuova esecuzione ID non è una scorciatoia di recupero. |
| output_exists | Scegli un nuovo nome file di output. Tenere la corrente salva. |
| result_unavailable | Per MCP, controlla il lavoro o i passaggi di chunk sopra. Per CLI, recuperare il lavoro remoto accettato. I risultati scarsi hanno bisogno di un'export precedente o di un proprio storage. |
Inviare una diagnostica per il supporto
Per CLI, eseguire questo filtro jq sul error.json salvato dal vostro compito. Per MCP, il codice di copia, http_status e request_id dalla risposta dello strumento, più il job_id salvato o result_id. Includere la versione client, endpoint, UTC tempo e se l'accettazione è confermata o sconosciuta. Escludere le credenziali, i cookie e firmato URLs.
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json