# Recupera una integración de agente

Recupera una tarea de CLI o MCP interrumpida con el ID guardado de su ejecución, trabajo o resultado.

Referencia canónica: https://flashdata.dev/es/docs/guides/agent-recovery
Revisado: 2026-11-05 por FlashData

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

## Empieza con el ID que guardaste

Pausa la tarea o el horario fallido. Encuentra su recibo en la carpeta de tarea o la historia del agente, luego sigue el camino de coincidencia. Estos IDs no son intercambiables.

| Tienes | Uso |
| --- | --- |
| CLI runId | El CLI se encuentra a continuación, con el perfil original y el directorio estatal. |
| MCP trabajo ID · trabajo_... | get_job en la conexión MCP existente. |
| Resultado MCP ID · resultado_... | get_result para terminar de leer una gran respuesta. |
| OpenClaw ejecutar ID | OpenClaw ejecuta historia, luego el FlashData ID grabado por esa carrera. |

- [Recuperación de CLI](https://flashdata.dev/es/docs/guides/agent-recovery/reference.md#inspect)
- [Recuperación de MCP](https://flashdata.dev/es/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw corre historia](https://flashdata.dev/es/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Inspeccione la carrera CLI

Abierto Bash (Git Bash on Windows) como el original OS usuario, en la carpeta de salida de su tarea. Reemplazar los tres valores abajo con los de la tarea original. Mantenga esta terminal abierta para pasos 2 y 3. Desarrollamiento FLASHDATA_API_KEY deja que el CLI use la llave guardada en este perfil.

### Seleccione la tarea existente · este 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
```

### Inspección local · no llamadas 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>

### Elija la acción de recuperación

Lea data.status, data.remoteId y data.errorCode en el registro de ejecución.

| Situación grabada | Qué hacer |
| --- | --- |
| succeeded | Compruebe el acceso, luego exportar el resultado guardado en el paso 3. |
| accepted | Compruebe el acceso, luego recuperar el trabajo aceptado en el paso 3. |
| uncertain / intent | Mantén la tarea pausada. Chequee remoteId, candidateRemoteIds e Historia antes de decidir si enviar algo de nuevo. |
| failed | Arreglar errorCode primero. Se mantiene un registro fallido; un reemplazo es una nueva tarea y puede utilizar créditos. |
| partial | Mantener los productos disponibles. Recuperar trabajos conocidos; para el trabajo a granel, inspeccionar cada fila antes de reemplazar los elementos fallidos. |
| run_not_found | Compruebe el perfil, el usuario y el directorio estatal de OS. Busque recibos guardados o Historia si la revista está perdida. |

- [Historial de solicitud abierta](https://flashdata.dev/app/jobs)
- [Recuperar resultados a granel](https://flashdata.dev/es/docs/guides/bulk/reference.md)

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

## 2. Compruebe el acceso de la cuenta CLI

Estos cheques gratuitos requieren acceso a la cuenta original y los orígenes de API. Resolver cualquier error de autenticación antes de recuperar los resultados.

### Verificar el acceso y leer el saldo

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

### Compruebe estos campos

Un saldo cero es una cuestión de financiación para el nuevo trabajo. No significa por sí mismo que la clave es inválida.

| auth status field | Se prevé |
| --- | --- |
| data.accessVerified | verdadero; de lo contrario fijar acceso antes de leer resultados. |
| data.identity.identity.accountId | La cuenta que presentó la tarea. |
| data.identity.permittedSources | Incluye la fuente utilizada por la tarea guardada. |
| data.identity.identity.recurringAllowed | es verdad antes de reanudar una tarea recurrente. |


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

### La cuenta cambió o acabo de vincular una prueba

run_account_mismatch significa que la ejecución guardada pertenece a una cuenta diferente o el origen API. Reutilizar el nombre del perfil no transfiere esa carrera.

| Situación | Medida |
| --- | --- |
| Cuenta incorrecta | Revise el entorno-key override, perfil seleccionado y los orígenes de gestión/data. Restaurar la cuenta prevista antes de la recuperación. |
| Rotación de la llave | Utilice una clave de reemplazo para la misma cuenta con el permiso de origen requerido. Mantenga el perfil original, directorio estatal y ejecute ID. |
| Sentencia reclamada | La cuenta de propietario difiere de la cuenta temporal. Lea las salidas de prueba que ya exportó. Utilice un nuevo ID solo para una nueva tarea de propietario prevista; utiliza el saldo del propietario. |

- [Reemplazar una llave de propietario](https://flashdata.dev/es/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Prueba y vinculación](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#owner-result)

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

### Reanudar una reclamación interrumpida

Para una reclamación aprobada, ejecute el acabado de auth en su perfil original dentro de la ventana de entrega 24-hour. Ahorra y verifica la llave del propietario, luego reconoce la instalación. El segundo comando comprueba el acceso guardado en un nuevo proceso.

#### Terminar el desvío existente

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

- [Reclamación o pérdida de la respuesta al registro](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#help)
- [Protocolo de autenticación](https://flashdata.dev/auth.md)

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

## 3. Recuperar el resultado de CLI

Elija el estado guardado desde el paso 1. Utilice un nombre de archivo de salida que no existe. Ambos comandos verifican el acceso y mantienen el funcionamiento original; ni presenta una consulta de reemplazo.

### Logros ahorrados

#### Exportar el resultado salvado

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


### Aceptado trabajo asinc

Un tiempo de votación detiene la espera local. Ejecute este comando de recuperación de nuevo para seguir esperando el mismo trabajo.

#### Esperar el trabajo original

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


- [Leer un trabajo remoto conocido ID](https://flashdata.dev/es/docs/guides/async-batch/reference.md#job-status)

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

### Confirme la recuperación antes de reanudar

1. Código de salida 0 y ok: verdadero, luego abierto recovered.json. Las exportaciones de resultados guardados han caché: verdadero; el uso se refiere a la ejecución original.
2. Mantenga la misma cuenta, perfil, estado y ejecute ID al reiniciar esta ocurrencia. No borre su revista ni renombre la carrera para forzar una retry.
3. Reanuda la programación sólo después del acceso y el resultado son verificados. Dar cada nueva ocurrencia programada su propia ejecución ID.

- [Recurriendo-tarea](https://flashdata.dev/es/docs/guides/recurring-tasks/reference.md#slot)
- [Guardar resultados para uso posterior](https://flashdata.dev/es/docs/guides/save-results/reference.md)

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

## Recuperar una tarea MCP

Las llamadas MCP no crean registros de ejecución CLI. Utilice la conexión MCP existente para la cuenta que presentó el trabajo. Reemplace el trabajo ID en este aviso y envíelo a su agente conectado.

### Pruebe en su agente conectado

```text
Recuperar mi trabajo FlashData existente: job_REPLACE_WITH_SAVED_ID.
Utilice la conexión MCP actual. Llame a get_balance con {} para comprobar el acceso,
entonces get_job con este job_id.
Si la respuesta contiene result_id, termine de leer sus pedazos get_result
y combinarlos antes de analizar el JSON.
Para job.status pendiente o procesado, encuesta el mismo trabajo cada segundo 5
para hasta los minutos de 2, luego reporte el estado más reciente y parada.
Para completar, guardar la salida y su fuente URLs y el uso en esta tarea.
En un error de acceso, trabajo fallido o resultado no disponible, detenga e informe el ID.
No ejecute una herramienta fuente, envíe un lote o cree nuevas credenciales.
```

- [Reconecte un host MCP](https://flashdata.dev/es/docs/guides/agent-access/reference.md)
- [Referencia de la herramienta MCP](https://flashdata.dev/es/docs/mcp/reference.md)

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

### Leer el trabajo original

Para un cliente MCP personalizado, pasa este objeto a callTool después de reemplazar job_id. Esta es una llamada de herramienta, no un comando shell. get_job verifica la cuenta de trabajo y el permiso de fuente; un cheque get_balance exitoso por sí solo no demuestra acceso a este trabajo.

#### get_job

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


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

### Compruebe el estado de trabajo de MCP

| Respuesta | Siguiente acción |
| --- | --- |
| job.status: pending / processing | Espera, luego lee el mismo trabajo ID. Un tiempo local no lo cancela. |
| job.status: completed | Guardar la salida. Su uso pertenece a la consulta original; get_job no se presenta ni cobra por una nueva consulta. |
| job.status: failed / isError: true | Lea el error antes de usar cualquier salida. No vuelva a ejecutar la fuente automáticamente. |
| code: result_unavailable | Retrocede la lectura para una falla de entrega transitoria. Si el resultado ahorrado venció, utilice exportaciones anteriores. Los resultados de Async JSON se mantienen durante las horas 24. |


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

### Se interrumpió una respuesta MCP grande

Utilice el result_id guardado con la misma tecla API. Comience en offset 0 para reconstruir toda la respuesta; si usted mantuvo los primeros pedazos, utilice su next_offset exacto en lugar. Reemplazar el marcador de lugar antes de llamar a esta herramienta.

1. Apéndice cada pedazo en orden, utilizando next_offset hasta que esté nulo. Parse el JSON combinado sólo después del último trozo.
2. El caché dura minutos 10 y mantiene las cuatro respuestas más grandes nuevas por llave. Si caducó o fue desalojado y usted salvó un trabajo ID, llame a get_job de nuevo y lea sus nuevos trozos.
3. Una respuesta en tiempo real no tiene un trabajo de fondo recuperable garantizado. Sin un trabajo ahorrado ID o exportar, comprobar Historia y preguntar antes de ejecutar una nueva consulta pagada.

#### get_result

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

- [cliente MCP con manipulación de trozos](https://flashdata.dev/es/docs/guides/mcp-custom-client/reference.md)

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

## No tengo trabajo ni trabajo ID

Compruebe los archivos guardados de la tarea, historial de herramientas de agente y la petición del propietario Historia. request_id es un diagnóstico ID, no un job_id. Si no puede confirmar si la presentación fue aceptada, mantenga la tarea pausada. Repetir la llamada original puede crear otra carga.

- [Historial de solicitud abierta](https://flashdata.dev/app/jobs)

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

## Encontrar una solución por código de error

| Signal | Arreglos |
| --- | --- |
| 400 / 422 | Comprueba los argumentos contra el esquema de herramientas o endpoints. Para las solicitudes CLI, utilice la consulta --dry-run antes de cualquier nueva tarea. |
| 401 / 403 | Para CLI, consulte el acceso en el paso 2. Para MCP OAuth, deje que el host refresque; una subvención revocada necesita una reconexión aprobada por el propietario. Con una llave API, compruebe los permisos secretos y fuente del host. |
| 402 | Detenga el nuevo trabajo hasta que el propietario resuelva la financiación. |
| 406 | Use Accept: application/json. Para los puntos finales de contenido soportados, solicite Markdown con X-Respond-With: marcador. |
| 429 | Honor Retry-After y recuperar cualquier trabajo conocido antes de enviar de nuevo. Esperar no aclara un registro de ejecución CLI fallido. |
| Timeout / 5xx / respuesta perdida | Recuperar trabajos aceptados conocidos. Mantenga los resultados desconocidos de la presentación pausados y verifique Historia. |
| run_id_input_conflict | Restaurar la entrada original. Nueva entrada necesita una nueva tarea deliberada y ejecutar ID. |
| run_account_mismatch | Utilice la lista de verificación de cambio de cuenta en el paso 2; un nuevo ID no es un atajo de recuperación. |
| output_exists | Elija un nuevo nombre de archivo de salida. Mantenga la carrera guardada. |
| result_unavailable | Para MCP, compruebe el trabajo o los escalones anteriores. Para CLI, recupere el trabajo remoto aceptado. Los resultados obtenidos necesitan una exportación anterior o su propio almacenamiento. |

- [Referencia de error de HTTP](https://flashdata.dev/es/docs/errors/reference.md)
- [Reconecte un host MCP](https://flashdata.dev/es/docs/guides/agent-access/reference.md)

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

## Enviar un diagnóstico para apoyar

Para CLI, ejecute esto jq filtro en el error.json salvo por tu tarea. MCP, código de copia, http_status y request_id de la respuesta de la herramienta, más el salvado job_id o result_id. Incluir la versión cliente, el punto final, el tiempo UTC y si la aceptación es confirmada o desconocida. Excluir credenciales, cookies y firma URLs.

### Seleccionar campos de diagnóstico · local solamente

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

- [Contactar con soporte](https://flashdata.dev/es/contact)
