Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Guide

Recuperare un'integrazione agente

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 haiUso
CLI runIdLa 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 IDOpenClaw 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.

Selezionare l'attività esistente · questo terminale
# 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
ispezione locale · no chiamate API
: "${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

Scegliere l'azione di recupero

Leggi data.status, data.remoteId e data.errorCode nel record di esecuzione.

Stato registratoCosa fare
succeededControllare l'accesso, quindi esportare il risultato salvato nel passaggio 3.
acceptedControllare l'accesso, quindi recuperare il lavoro accettato nella fase 3.
uncertain / intentTenere il compito sospeso. Controllare remoteId, candidateRemoteIds e History prima di decidere se inviare di nuovo qualcosa.
failedFissa prima errorCode. Un record fallito viene mantenuto; un sostituto è un nuovo compito e può utilizzare crediti.
partialMantenere le uscite disponibili. Recuperare i lavori noti; per il lavoro di massa, ispezionare ogni riga prima di sostituire gli elementi falliti.
run_not_foundControlla 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.

Verificare l'accesso e leggere l'equilibrio
: "${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

Controlla questi campi

Un saldo zero è un problema di finanziamento per il nuovo lavoro. Non significa di per sé che la chiave è invalida.

Campo auth statusAttesi
data.accessVerifiedtrue; altrimenti fissare l'accesso prima dei risultati di lettura.
data.identity.identity.accountIdL'account che ha presentato l'attività.
data.identity.permittedSourcesInclude la fonte utilizzata dall'attività salvata.
data.identity.identity.recurringAllowedtrue 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.

SituazioneAzione
Conto sbagliatoControllare l'ambiente-chiave override, il profilo selezionato e le origini management/data. Ripristinare il conto previsto prima del recupero.
Chiave ruotataUtilizzare 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 previstaL'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.

Terminare la consegna esistente
: "${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. 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.

Esportare il risultato salvato
: "${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

Confermare il recupero prima di riprendere

  1. 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.
  2. 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.
  3. 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.

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

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

Controlla lo stato del lavoro MCP

RispostaProssima azione
job.status: pending / processingAspetta, poi leggi lo stesso lavoro ID. Un timeout locale non lo cancella.
job.status: completedSalvare l'output. Il suo utilizzo appartiene alla query originale; get_job non si presenta o addebita per una nuova query.
job.status: failed / isError: trueLeggere l'errore prima di utilizzare qualsiasi output. Non eseguire automaticamente la sorgente.
code: result_unavailableRipristinare 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.

  1. Applicare ogni pezzo in ordine, utilizzando next_offset fino a quando non è null. Parsare il combinato JSON solo dopo l'ultimo pezzo.
  2. 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.
  3. 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.
get_result
{
  "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

SegnaleRisolto
400 / 422Controllare gli argomenti contro lo strumento o lo schema endpoint. Per le richieste CLI, utilizzare query --dry-run prima di qualsiasi nuova attività.
401 / 403Per 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.
402Smettere nuovi lavori fino a quando il proprietario non risolve i finanziamenti.
406Utilizzare Accept: application/json. Per gli endpoint dei contenuti supportati, richiedere Markdown con X-Respond-With: markdown.
429Honor 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 persaRecuperare i lavori accettati noti. Tenere i risultati di presentazione sconosciuti interrotti e controllare History.
run_id_input_conflictRipristinare l'ingresso originale. Il nuovo input ha bisogno di un nuovo compito deliberato e di eseguire ID.
run_account_mismatchUtilizzare la lista di controllo cambio account nel passo 2; una nuova esecuzione ID non è una scorciatoia di recupero.
output_existsScegli un nuovo nome file di output. Tenere la corrente salva.
result_unavailablePer 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.

Seleziona campi diagnostici · solo locali
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json