# Wiederherstellen einer Agentenintegration

Wiederherstellen einer unterbrochenen CLI- oder MCP-Aufgabe mit dem gespeicherten Ablauf, Auftrag oder Ergebnis ID.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/agent-recovery
Test: 2026-11-05 von FlashData

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

## Beginnen Sie mit dem ID, den Sie gespeichert haben

Unterbrechen Sie die fehlgeschlagene Aufgabe oder den Zeitplan. Finden Sie die Quittung in Ihrem Aufgabenordner oder der Agentenhistorie und folgen Sie dann dem passenden Pfad. Diese IDs sind nicht austauschbar.

| Sie haben | Verwendung |
| --- | --- |
| CLI runId | Die CLI Schritte unten, mit dem ursprünglichen Profil und Zustand Verzeichnis. |
| MCP job ID · job_. | get_job auf der bestehenden MCP-Verbindung. |
| MCP Ergebnis ID · result_. | get_result zu finish Lesen einer großen Antwort. |
| OpenClaw run ID | OpenClaw-Laufverlauf, dann der von diesem Lauf aufgezeichnete FlashData ID. |

- [CLI](https://flashdata.dev/de/docs/guides/agent-recovery/reference.md#inspect)
- [MCP](https://flashdata.dev/de/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw Laufgeschichte](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Überprüfen Sie den CLI-Lauf

Öffnen Sie Bash (Git Bash auf Windows) als ursprünglichen OS-Benutzer im Ausgabeordner Ihrer Aufgabe. Ersetzen Sie alle drei Werte unten durch die Werte aus der ursprünglichen Aufgabe. Halten Sie dieses Terminal für die Schritte 2 und 3 offen. Das Deaktivieren von FLASHDATA_API_KEY ermöglicht es dem CLI, den in diesem Profil gespeicherten Schlüssel zu verwenden.

### Wählen Sie die bestehende Aufgabe · dieses 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
```

### Lokale Inspektion · keine API Anrufe

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

### Wählen Sie die Recovery-Aktion

Lesen Sie data.status, data.remoteId und data.errorCode im Run Record.

| Aufgezeichneter Status | Lösung |
| --- | --- |
| succeeded | Überprüfen Sie den Zugriff und exportieren Sie das gespeicherte Ergebnis in Schritt 3. |
| accepted | Überprüfen Sie den Zugriff und stellen Sie dann den akzeptierten Job in Schritt 3 wieder her. |
| uncertain / intent | Halten Sie die Aufgabe angehalten. Überprüfen Sie remoteId, candidateRemoteIds und History, bevor Sie entscheiden, ob Sie etwas erneut einreichen möchten. |
| failed | Beheben Sie errorCode zuerst. Ein fehlgeschlagener Datensatz wird beibehalten; ein Ersatz ist eine neue Aufgabe und kann Credits verwenden. |
| partial | Halten Sie verfügbare Outputs. Bekannte Jobs wiederherstellen; für Massenarbeit, überprüfen Sie jede Zeile, bevor Sie ausgefallene Gegenstände ersetzen. |
| run_not_found | Überprüfen Sie das Profil, den OS-Benutzer und das Zustandsverzeichnis. Suchen Sie nach gespeicherten Quittungen oder History, wenn das Journal verloren geht. |

- [Open Request History](https://flashdata.dev/app/jobs)
- [Wiederherstellung von Massenergebnissen](https://flashdata.dev/de/docs/guides/bulk/reference.md)

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

## 2. CLI-Kontozugang prüfen

Diese kostenlosen Schecks erfordern Zugriff auf das ursprüngliche Konto und die API-Ursprünge. Beheben Sie einen Authentifizierungsfehler, bevor Sie die Ergebnisse wiederherstellen.

### Überprüfen Sie den Zugang und lesen Sie den 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>

### Überprüfen Sie diese Felder

Ein Nullsaldo ist ein Finanzierungsproblem für neue Arbeiten. Es bedeutet nicht an sich, dass der Schlüssel ungültig ist.

| auth status-Feld | Erwartet |
| --- | --- |
| data.accessVerified | true; andernfalls den Zugriff vor dem Lesen der Ergebnisse beheben. |
| data.identity.identity.accountId | Das Konto, das die Aufgabe eingereicht hat. |
| data.identity.permittedSources | Enthält die Quelle, die von der gespeicherten Aufgabe verwendet wird. |
| data.identity.identity.recurringAllowed | true vor Wiederaufnahme einer wiederkehrenden Aufgabe. |


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

### Das Konto hat sich geändert, oder ich habe gerade einen Prozess beantragt

run_account_mismatch bedeutet, dass der gespeicherte Lauf zu einem anderen Konto oder API-Ursprung gehört. Die Wiederverwendung des Profilnamens überträgt diesen Lauf nicht.

| Lage | Aktion |
| --- | --- |
| Falsches Konto | Überprüfen Sie die Umgebungsschlüssel-Override, das ausgewählte Profil und die management/data-Ursprünge. Stellen Sie das beabsichtigte Konto vor der Wiederherstellung wieder her. |
| Schlüssel gedreht | Verwenden Sie einen Ersatzschlüssel für dasselbe Konto mit der erforderlichen Quellberechtigung. Behalten Sie das ursprüngliche Profil, das Zustandsverzeichnis und führen Sie ID aus. |
| Beantragte Verhandlung | Das Besitzerkonto unterscheidet sich vom temporären Konto. Lesen Sie die Testergebnisse, die Sie bereits exportiert haben. Verwenden Sie eine neue Ausführung ID nur für eine beabsichtigte neue Besitzeraufgabe; es verwendet die Balance des Besitzers. |

- [Ersetzen Sie einen Owner Key](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Testzugang und Kontoverknüpfung](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#owner-result)

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

### Wiederaufnahme eines unterbrochenen Anspruchs

Führen Sie auth finish im Originalprofil innerhalb des 24-Stunden-Handoff-Fensters aus. Es speichert und überprüft den Besitzerschlüssel und bestätigt dann die Installation. Der zweite Befehl überprüft den gespeicherten Zugriff in einem neuen Prozess.

#### Beenden Sie das bestehende Handoff

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

- [Antwort auf den Antrag oder die verlorene Registrierung](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#help)
- [Authentifizierungsprotokoll](https://flashdata.dev/auth.md)

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

## 3. Wiederherstellen des CLI Ergebnisses

Wählen Sie den gespeicherten Status aus Schritt 1. Verwenden Sie einen Ausgabedateinamen, der nicht vorhanden ist. Beide Befehle überprüfen den Zugriff und behalten den ursprünglichen Ablauf bei; keiner von beiden sendet eine Ersatzabfrage.

### Gesparter Erfolg

#### Exportieren des gespeicherten Ergebnisses

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


### Akzeptiert async job

Ein Polling-Timeout stoppt das lokale Warten. Führen Sie diesen Wiederherstellungsbefehl erneut aus, um weiterhin auf den gleichen Job zu warten.

#### Warten Sie auf den ursprünglichen Job

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


- [Lesen Sie einen bekannten Remotejob ID](https://flashdata.dev/de/docs/guides/async-batch/reference.md#job-status)

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

### Bestätigen Sie die Erholung vor Wiederaufnahme

1. Überprüfen Sie den Ausstiegscode 0 und ok: true, und öffnen Sie dann recovered.json. Die Exporte von gespeicherten Ergebnissen haben cached: true; die Verwendung bezieht sich auf die ursprüngliche Ausführung.
2. Behalten Sie das gleiche Konto, Profil, Status und führen Sie ID aus, wenn Sie dieses Ereignis wiederholen. Löschen Sie nicht das Journal oder benennen Sie den Lauf um, um einen Wiederholungsversuch zu erzwingen.
3. Resume Scheduling erst nach dem Zugriff und das Ergebnis wird überprüft. Geben Sie jedem neuen geplanten Ereignis seinen eigenen Lauf ID.

- [Wiederkehrende Aufgabenläufer](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md#slot)
- [Speichern Sie Ergebnisse für die spätere Verwendung](https://flashdata.dev/de/docs/guides/save-results/reference.md)

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

## Wiederherstellen einer MCP-Aufgabe

MCP-Aufrufe erstellen keine CLI-Laufdatensätze. Verwenden Sie die bestehende MCP-Verbindung für das Konto, das den Auftrag eingereicht hat. Ersetzen Sie den Job ID in dieser Aufforderung und senden Sie ihn an Ihren verbundenen Agenten.

### Einfügen in Ihren Connected Agent

```text
Stellen Sie meinen bestehenden FlashData-Job wieder her: job_REPLACE_WITH_SAVED_ID.
Verwenden Sie die aktuelle MCP-Verbindung. Rufen Sie get_balance mit {} an, um den Zugriff zu überprüfen,
dann get_job mit diesem job_id.
Wenn die Antwort result_id enthält, liest finish seine get_result-Stücke
und kombinieren Sie sie, bevor Sie den JSON analysieren.
Für job.status ausstehend oder Verarbeitung, wählen Sie den gleichen Job alle 5 Sekunden
für bis zu 2-Minuten, melden Sie dann den neuesten Status und stoppen Sie.
Speichern Sie für abgeschlossene Ausgabe und ihre Quelle URLs und die Verwendung in dieser Aufgabe.
Bei einem Zugriffsfehler, einem fehlgeschlagenen Job oder einem nicht verfügbaren Ergebnis stoppen und melden Sie das ID.
Führen Sie kein Quelltool aus, reichen Sie keinen Batch ein oder erstellen Sie neue Anmeldeinformationen.
```

- [Verbinden Sie einen MCP Host](https://flashdata.dev/de/docs/guides/agent-access/reference.md)
- [MCP Tool Referenz](https://flashdata.dev/de/docs/mcp/reference.md)

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

### Lesen Sie den ursprünglichen Job

Für einen benutzerdefinierten MCP-Client übergeben Sie dieses Objekt an callTool, nachdem Sie job_id ersetzt haben. Dies ist ein Werkzeugaufruf, kein Shell-Befehl. get_job überprüft das Jobkonto und die Quellberechtigung; eine erfolgreiche get_balance-Prüfung allein beweist keinen Zugriff auf diesen Job.

#### get_job

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


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

### Überprüfen Sie den MCP-Jobstatus

| Antwort | Nächste Maßnahme |
| --- | --- |
| job.status: pending / processing | Warten Sie, dann lesen Sie den gleichen Job ID. Ein lokales Timeout storniert es nicht. |
| job.status: completed | Output sparen. Seine Verwendung gehört zur ursprünglichen Abfrage; get_job sendet oder berechnet keine neue Abfrage. |
| job.status: failed / isError: true | Lesen Sie den Fehler, bevor Sie eine Ausgabe verwenden. Führen Sie die Quelle nicht automatisch erneut aus. |
| code: result_unavailable | Wiederholen Sie das Lesen für einen vorübergehenden Lieferfehler. Wenn das gespeicherte Ergebnis abgelaufen ist, verwenden Sie frühere Exporte. Async JSON Ergebnisse werden für 24 Stunden beibehalten. |


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

### Eine große MCP Antwort wurde unterbrochen

Verwenden Sie den gespeicherten result_id mit dem gleichen API-Schlüssel. Beginnen Sie bei Offset 0, um die gesamte Antwort neu zu erstellen; Wenn Sie die früheren Blöcke beibehalten haben, verwenden Sie stattdessen deren genaues next_offset. Ersetzen Sie den Platzhalter, bevor Sie dieses Tool aufrufen.

1. Fügen Sie jedes Stück in der Reihenfolge mit next_offset an, bis es null ist. Parse die kombinierte JSON erst nach dem letzten Stück.
2. Der Cache dauert 10 Minuten und behält die vier neuesten großen Antworten pro Schlüssel. Wenn es abgelaufen ist oder geräumt wurde und Sie einen Job ID gespeichert haben, rufen Sie get_job erneut an und lesen Sie die neuen Teile.
3. Eine Echtzeit-Antwort hat keinen garantierten wiederherstellbaren Hintergrundjob. Ohne einen gespeicherten Job ID oder Export, überprüfen Sie History und fragen Sie, bevor Sie eine neue bezahlte Abfrage ausführen.

#### get_result

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

- [MCP Client mit Chunk-Handling](https://flashdata.dev/de/docs/guides/mcp-custom-client/reference.md)

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

## Ich habe keinen Lauf oder Job ID

Überprüfen Sie die gespeicherten Dateien der Aufgabe, den Agent-Toolverlauf und die Anforderung des Besitzers History. Ein request_id ist ein diagnostisches ID, kein job_id. Wenn Sie nicht bestätigen können, ob die Eingabe akzeptiert wurde, halten Sie die Aufgabe angehalten. Das Wiederholen des ursprünglichen Quellaufrufs kann eine weitere Gebühr verursachen.

- [Open Request History](https://flashdata.dev/app/jobs)

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

## Finden Sie einen Fix durch Fehlercode

| Signal | Fixpunkt |
| --- | --- |
| 400 / 422 | Überprüfen Sie die Argumente gegen das Tool oder Endpunktschema. Verwenden Sie für CLI-Anfragen die Abfrage --dry-run vor einer neuen Aufgabe. |
| 401 / 403 | Prüfen Sie für CLI den Zugriff in Schritt 2. Für MCP OAuth, lassen Sie den Host aktualisieren; ein widerrufener Zuschuss erfordert eine vom Eigentümer genehmigte Wiederverbindung. Überprüfen Sie mit einem API-Schlüssel die Geheim- und Quellberechtigungen des Hosts. |
| 402 | Stoppen Sie neue Arbeiten, bis der Eigentümer die Finanzierung beschließt. |
| 406 | Verwenden Sie Accept: application/json. Für unterstützte Inhaltsendpunkte fordern Sie Markdown mit X-Respond-With: Markdown an. |
| 429 | Ehren Sie Retry-After und erholen Sie jeden bekannten Job, bevor Sie ihn erneut einreichen. Warten löscht keinen fehlgeschlagenen CLI-Laufrekord. |
| Timeout / 5xx / verlorene Antwort | Bekannte akzeptierte Arbeitsplätze wiederherstellen. Halten Sie unbekannte Einreichungsergebnisse pausiert und überprüfen Sie History. |
| run_id_input_conflict | Stellen Sie die ursprüngliche Eingabe wieder her. Neue Eingaben erfordern eine bewusst neue Aufgabe und führen ID aus. |
| run_account_mismatch | Verwenden Sie die Checkliste zum Kontowechsel in Schritt 2; ein neuer Lauf ID ist keine Wiederherstellungskombination. |
| output_exists | Wählen Sie einen neuen Ausgabedateinamen. Halten Sie den gespeicherten Lauf. |
| result_unavailable | Für MCP, überprüfen Sie den Job oder Chunk Schritte oben. Für CLI stellen Sie den akzeptierten Remote-Job wieder her. Abgelaufene Ergebnisse benötigen einen früheren Export oder eine eigene Speicherung. |

- [HTTP Fehlerreferenz](https://flashdata.dev/de/docs/errors/reference.md)
- [Verbinden Sie einen MCP Host](https://flashdata.dev/de/docs/guides/agent-access/reference.md)

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

## Senden Sie eine Diagnose an den Support

Führen Sie für CLI diesen jq-Filter auf dem von Ihrer Aufgabe gespeicherten error.json aus. Kopieren Sie für MCP den Code, http_status und request_id aus der Tool-Antwort sowie den gespeicherten job_id oder result_id. Fügen Sie die Clientversion, den Endpunkt, die UTC-Zeit und ob die Akzeptanz bestätigt oder unbekannt ist, hinzu. Ausschließen von Anmeldeinformationen, Cookies und signiertem URLs.

### Diagnosefelder auswählen · nur lokal

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

- [Support kontaktieren](https://flashdata.dev/de/contact)
