# Recuperare un'integrazione agente

Recuperare un'attività interrotta CLI o MCP utilizzando la sua esecuzione salvata, il lavoro o il risultato ID.

Riferimento canonico: https://flashdata.dev/it/docs/guides/agent-recovery
Recensito: 2026-11-05 da FlashData

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

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

- [Recupero CLI](https://flashdata.dev/it/docs/guides/agent-recovery/reference.md#inspect)
- [Recupero MCP](https://flashdata.dev/it/docs/guides/agent-recovery/reference.md#mcp)
- [Storia dell'esecuzione OpenClaw](https://flashdata.dev/it/docs/guides/recurring-tasks/reference.md#inspect-test)

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

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

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

### ispezione locale · no chiamate API

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

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

- [cronologia delle richieste aperte](https://flashdata.dev/app/jobs)
- [Recuperare i risultati di massa](https://flashdata.dev/it/docs/guides/bulk/reference.md)

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

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

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

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


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

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

- [Sostituire una chiave del proprietario](https://flashdata.dev/it/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Prova e collegamento all’account](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#owner-result)

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

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

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

- [Domanda scaduta o risposta di registrazione persa](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#help)
- [Protocollo di autenticazione](https://flashdata.dev/auth.md)

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

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

### Risparmio di successo

#### Esportare il risultato salvato

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


### Accettato lavoro asincastro

Un timeout inquinante ferma l'attesa locale. Eseguire nuovamente questo comando di recupero per continuare ad aspettare lo stesso lavoro.

#### Attendere il lavoro originale

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


- [Leggi un lavoro remoto noto ID](https://flashdata.dev/it/docs/guides/async-batch/reference.md#job-status)

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

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

- [Corrente di rischio](https://flashdata.dev/it/docs/guides/recurring-tasks/reference.md#slot)
- [Salvare i risultati per un uso successivo](https://flashdata.dev/it/docs/guides/save-results/reference.md)

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

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

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

- [Ricollegare un host MCP](https://flashdata.dev/it/docs/guides/agent-access/reference.md)
- [Riferimento dello strumento MCP](https://flashdata.dev/it/docs/mcp/reference.md)

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

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

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


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

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


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

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

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

- [client MCP con gestione a blocchi](https://flashdata.dev/it/docs/guides/mcp-custom-client/reference.md)

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

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

- [cronologia delle richieste aperte](https://flashdata.dev/app/jobs)

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

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

- [Riferimento errore HTTP](https://flashdata.dev/it/docs/errors/reference.md)
- [Ricollegare un host MCP](https://flashdata.dev/it/docs/guides/agent-access/reference.md)

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

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

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

- [Contatta il supporto](https://flashdata.dev/it/contact)
