# Rétablir une intégration d’agent

Reprenez une tâche CLI ou MCP interrompue à partir de son identifiant d’exécution, de tâche ou de résultat enregistré.

Référence canonique : https://flashdata.dev/fr/docs/guides/agent-recovery
Vérifié le 2026-11-05 par FlashData

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

## Commencer par l’identifiant enregistré

Mettez la tâche ou la planification en échec en pause. Retrouvez son reçu dans le dossier de tâche ou l’historique de l’agent, puis suivez la procédure correspondante. Ces identifiants ne sont pas interchangeables.

| Identifiant disponible | Procédure |
| --- | --- |
| CLI runId | Les étapes CLI ci-dessous, avec le profil et le répertoire d’état d’origine. |
| Identifiant de tâche MCP · job_… | get_job sur la connexion MCP existante. |
| Identifiant de résultat MCP · result_… | get_result pour terminer la lecture d’une réponse volumineuse. |
| Identifiant d’exécution OpenClaw | L’historique des exécutions OpenClaw, puis l’identifiant FlashData enregistré par cette exécution. |

- [Reprise avec la CLI](https://flashdata.dev/fr/docs/guides/agent-recovery/reference.md#inspect)
- [Reprise avec MCP](https://flashdata.dev/fr/docs/guides/agent-recovery/reference.md#mcp)
- [Historique des exécutions OpenClaw](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Examiner l’exécution CLI

Ouvrez Bash (Git Bash sous Windows) avec l’utilisateur du système d’origine, dans le dossier de sortie de votre tâche. Remplacez les trois valeurs ci-dessous par celles de la tâche d’origine. Gardez ce terminal ouvert pour les étapes 2 et 3. Supprimer la variable FLASHDATA_API_KEY permet à la CLI d’utiliser la clé enregistrée dans ce profil.

### Sélectionner la tâche existante · dans ce 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
```

### Examen local · aucun appel 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>

### Choisir l’action de reprise

Lisez data.status, data.remoteId et data.errorCode dans l’enregistrement de l’exécution.

| État enregistré | Action |
| --- | --- |
| succeeded | Vérifiez l’accès, puis exportez le résultat enregistré à l’étape 3. |
| accepted | Vérifiez l’accès, puis reprenez la tâche acceptée à l’étape 3. |
| uncertain / intent | Gardez la tâche en pause. Vérifiez remoteId, candidateRemoteIds et History avant de décider de soumettre à nouveau quoi que ce soit. |
| failed | Corrigez d’abord l’erreur indiquée par errorCode. L’enregistrement en échec est conservé ; son remplacement constitue une nouvelle tâche et peut consommer des crédits. |
| partial | Conservez les sorties disponibles. Reprenez les tâches dont l’identifiant est connu ; pour un traitement bulk, examinez chaque ligne avant de remplacer les éléments en échec. |
| run_not_found | Vérifiez le profil, l’utilisateur du système et le répertoire d’état. Si le journal a été perdu, recherchez les reçus enregistrés ou consultez History. |

- [Ouvrir l’historique des requêtes](https://flashdata.dev/app/jobs)
- [Récupérer les résultats bulk](https://flashdata.dev/fr/docs/guides/bulk/reference.md)

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

## 2. Vérifier l’accès au compte avec la CLI

Ces vérifications gratuites nécessitent l’accès au compte et aux serveurs API d’origine. Résolvez toute erreur d’authentification avant de récupérer les résultats.

### Vérifier l’accès et consulter le solde

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

### Champs à vérifier

Un solde nul empêche de financer de nouvelles tâches. Il ne signifie pas à lui seul que la clé est invalide.

| Champ renvoyé par auth status | Valeur attendue |
| --- | --- |
| data.accessVerified | true ; sinon, rétablissez l’accès avant de lire les résultats. |
| data.identity.identity.accountId | Le compte qui a soumis la tâche. |
| data.identity.permittedSources | Contient la source utilisée par la tâche enregistrée. |
| data.identity.identity.recurringAllowed | true avant de reprendre une tâche récurrente. |


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

### Le compte a changé ou je viens de rattacher un essai

run_account_mismatch signifie que l’exécution enregistrée appartient à un autre compte ou serveur API. Réutiliser le nom du profil ne transfère pas cette exécution.

| Situation | Action |
| --- | --- |
| Mauvais compte | Vérifiez la priorité de la clé fournie par l’environnement, le profil sélectionné et les adresses des API de gestion et de données. Rétablissez le compte attendu avant la reprise. |
| Clé remplacée | Utilisez une clé de remplacement pour le même compte, avec la permission de source requise. Conservez le profil, le répertoire d’état et l’identifiant d’exécution d’origine. |
| Essai rattaché | Le compte propriétaire est distinct du compte temporaire. Lisez les résultats d’essai déjà exportés. Utilisez un nouvel identifiant d’exécution uniquement pour lancer volontairement une nouvelle tâche propriétaire ; elle utilise le solde du propriétaire. |

- [Remplacer une clé propriétaire](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Essai et rattachement](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md#owner-result)

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

### Reprendre un rattachement interrompu

Pour un rattachement approuvé, exécutez auth finish dans le profil d’origine pendant la fenêtre de transmission de 24 heures. La commande enregistre et vérifie la clé propriétaire, puis confirme son installation. La seconde commande vérifie l’accès enregistré dans un nouveau processus.

#### Terminer la transmission en cours

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

- [Rattachement expiré ou réponse d’inscription perdue](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md#help)
- [Protocole d’authentification](https://flashdata.dev/auth.md)

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

## 3. Récupérer le résultat avec la CLI

Choisissez l’état enregistré relevé à l’étape 1. Utilisez un nom de fichier de sortie qui n’existe pas encore. Les deux commandes vérifient l’accès et conservent l’exécution d’origine ; aucune ne soumet de requête de remplacement.

### Résultat réussi enregistré

#### Exporter le résultat enregistré

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


### Tâche asynchrone acceptée

Un dépassement du délai de consultation arrête l’attente locale. Relancez cette commande de reprise pour continuer à attendre la même tâche.

#### Attendre la tâche d’origine

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


- [Consulter une tâche distante par son identifiant connu](https://flashdata.dev/fr/docs/guides/async-batch/reference.md#job-status)

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

### Vérifier le résultat avant de reprendre les tâches

1. Vérifiez le code de sortie 0 et ok: true, puis ouvrez recovered.json. Les exports de résultats enregistrés indiquent cached: true ; la consommation correspond à l’exécution d’origine.
2. Conservez le même compte, le même profil, le même état et le même identifiant d’exécution lorsque vous réessayez cette occurrence. Ne supprimez pas son journal et ne renommez pas l’exécution pour forcer une nouvelle tentative.
3. Réactivez la planification après avoir vérifié l’accès et le résultat. Attribuez un identifiant d’exécution distinct à chaque nouvelle occurrence planifiée.

- [Script de tâches récurrentes](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md#slot)
- [Enregistrer les résultats pour les réutiliser](https://flashdata.dev/fr/docs/guides/save-results/reference.md)

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

## Reprendre une tâche MCP

Les appels MCP ne créent pas d’enregistrements d’exécution CLI. Utilisez la connexion MCP existante du compte qui a soumis la tâche. Remplacez l’identifiant de tâche dans cette consigne, puis envoyez-la à votre agent connecté.

### À coller dans votre agent connecté

```text
Reprenez ma tâche FlashData existante : job_REPLACE_WITH_SAVED_ID.
Utilisez la connexion MCP actuelle. Appelez get_balance avec {} pour vérifier l’accès,
puis get_job avec ce job_id.
Si la réponse contient result_id, lisez tous les fragments get_result
et assemblez-les avant d’analyser le JSON.
Pour job.status pending ou processing, vérifiez la même tâche toutes les 5 secondes
pendant au plus 2 minutes, puis indiquez le dernier état et arrêtez.
Pour completed, enregistrez le résultat, ses URL sources et sa consommation dans cette tâche.
En cas d’erreur d’accès, d’échec de la tâche ou de résultat indisponible, arrêtez et indiquez l’identifiant.
N’appelez aucun outil de source, ne soumettez aucun lot et ne créez pas de nouveaux identifiants.
```

- [Reconnecter un hôte MCP](https://flashdata.dev/fr/docs/guides/agent-access/reference.md)
- [Référence des outils MCP](https://flashdata.dev/fr/docs/mcp/reference.md)

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

### Consulter la tâche d’origine

Pour un client MCP personnalisé, transmettez cet objet à callTool après avoir remplacé job_id. Il s’agit d’un appel d’outil, pas d’une commande shell. get_job vérifie le compte associé à la tâche et la permission de source ; la réussite de get_balance ne prouve pas à elle seule l’accès à cette tâche.

#### get_job

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


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

### Vérifier l’état de la tâche MCP

| Réponse | Action suivante |
| --- | --- |
| job.status: pending / processing | Attendez, puis consultez la tâche avec le même identifiant. Un dépassement de délai local ne l’annule pas. |
| job.status: completed | Enregistrez le résultat. Sa consommation correspond à la requête d’origine ; get_job ne soumet ni ne facture de nouvelle requête. |
| job.status: failed / isError: true | Lisez l’erreur avant d’utiliser les résultats. Ne relancez pas automatiquement l’appel à la source. |
| code: result_unavailable | Réessayez la lecture en cas d’erreur temporaire de transmission. Si le résultat enregistré a expiré, utilisez vos exports précédents. Les résultats JSON asynchrones sont conservés pendant 24 heures. |


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

### La lecture d’une réponse MCP volumineuse a été interrompue

Utilisez le result_id enregistré avec la même clé API. Commencez à offset 0 pour reconstruire toute la réponse ; si vous avez conservé les fragments précédents, utilisez leur valeur exacte de next_offset. Remplacez la valeur d’exemple avant d’appeler cet outil.

1. Assemblez les fragments dans l’ordre, en utilisant next_offset jusqu’à ce qu’il vaille null. Analysez le JSON assemblé uniquement après le dernier fragment.
2. Le cache dure 10 minutes et conserve les quatre réponses volumineuses les plus récentes par clé. Si le résultat a expiré ou a été évincé et que vous avez un identifiant de tâche enregistré, rappelez get_job et lisez les nouveaux fragments.
3. Une réponse en temps réel ne garantit pas l’existence d’une tâche en arrière-plan récupérable. Sans identifiant de tâche enregistré ni export, consultez History et demandez l’accord avant de lancer une nouvelle requête payante.

#### get_result

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

- [Client MCP avec gestion des fragments](https://flashdata.dev/fr/docs/guides/mcp-custom-client/reference.md)

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

## Je n’ai pas d’identifiant d’exécution ou de tâche

Consultez les fichiers enregistrés de la tâche, l’historique des outils de l’agent et la page History du propriétaire. request_id est un identifiant de diagnostic, pas un job_id. Si vous ne pouvez pas confirmer l’acceptation de la soumission, gardez la tâche en pause. Répéter l’appel à la source peut entraîner une nouvelle facturation.

- [Ouvrir l’historique des requêtes](https://flashdata.dev/app/jobs)

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

## Trouver une solution par code d’erreur

| Signal | Solution |
| --- | --- |
| 400 / 422 | Vérifiez les arguments selon le schéma de l’outil ou de l’endpoint. Pour les requêtes CLI, utilisez query --dry-run avant toute nouvelle tâche. |
| 401 / 403 | Pour la CLI, vérifiez l’accès à l’étape 2. Pour MCP OAuth, laissez l’hôte renouveler le jeton ; une autorisation révoquée nécessite une reconnexion approuvée par le propriétaire. Avec une clé API, vérifiez le secret de l’hôte et les permissions de source. |
| 402 | Arrêtez toute nouvelle tâche jusqu’à ce que le propriétaire rétablisse un solde suffisant. |
| 406 | Utilisez Accept: application/json. Pour les endpoints de contenu compatibles, demandez Markdown avec X-Respond-With: markdown. |
| 429 | Respectez Retry-After et reprenez toute tâche connue avant de soumettre à nouveau. Attendre ne supprime pas l’enregistrement d’une exécution CLI en échec. |
| Délai dépassé / 5xx / réponse perdue | Reprenez les tâches acceptées dont l’identifiant est connu. Gardez les soumissions au résultat inconnu en pause et consultez History. |
| run_id_input_conflict | Rétablissez les paramètres d’origine. De nouveaux paramètres nécessitent une nouvelle tâche volontaire et un nouvel identifiant d’exécution. |
| run_account_mismatch | Suivez les vérifications de changement de compte à l’étape 2 ; un nouvel identifiant d’exécution ne remplace pas une reprise. |
| output_exists | Choisissez un nouveau nom de fichier de sortie. Conservez l’exécution enregistrée. |
| result_unavailable | Pour MCP, suivez les étapes de lecture de tâche ou de fragments ci-dessus. Pour la CLI, reprenez la tâche distante acceptée. Les résultats expirés nécessitent un export antérieur ou votre propre stockage. |

- [Référence des erreurs HTTP](https://flashdata.dev/fr/docs/errors/reference.md)
- [Reconnecter un hôte MCP](https://flashdata.dev/fr/docs/guides/agent-access/reference.md)

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

## Envoyer un diagnostic à l’assistance

Pour la CLI, appliquez ce filtre jq au fichier error.json enregistré par votre tâche. Pour MCP, copiez code, http_status et request_id depuis la réponse de l’outil, ainsi que le job_id ou result_id enregistré. Ajoutez la version du client, l’endpoint, l’heure UTC et précisez si l’acceptation est confirmée ou inconnue. Excluez les identifiants d’accès, les cookies et les URL signées.

### Sélectionner les champs de diagnostic · en local uniquement

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

- [Contacter l’assistance](https://flashdata.dev/fr/contact)
