# Pulihkan kembali agen integrasi

Kemulih kembali tugas CLI atau MCP yang terganggu menggunakan menjalankan, pekerjaan atau hasil ID.

Referensi boonical: https://flashdata.dev/ms/docs/guides/agent-recovery
Diulas: 2026-11-05 oleh FlashData

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

## Mulailah dengan ID yang kau simpan

Dia tidak pernah gagal dalam tugas atau jadwal. Pengecakan menemukan penerimaannya dalam folder tugas atau riwayat agen Anda, kemudian ikutilah jalan yang cocok. IDs ini tidak dapat diubah.

| Anda telah | Guna |
| --- | --- |
| CLI runId | ¡CLI langkah di bawah, dengan profil dan direktori keadaan asli. |
| Pekerjaan MCP ID · job_. | get_job pada sambungan MCP yang sudah ada. |
| Hasil MCP hasil ID · hasil_. | get_result ke finish membaca respon yang besar. |
| ID pelaksanaan OpenClaw | OpenClaw sejarah sejarah, kemudian FlashData ID Direkam oleh pelarian itu. |

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

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

## 1. Periksalah CLI

Open Bash (Git Bash Pada Windows) sebagai yang asli OS Pengguna, dalam folder keluaran tugas Anda. Gantikan semua tiga nilai di bawah ini dengan yang dari tugas asal. Tetap buka terminal ini untuk langkah 2 dan 3. Tak Beraturan FLASHDATA_API_KEY Biar saja CLI Menggunakan kunci yang disimpan di profil ini.

### Pilih semua tugas yang telah ada · terminal ini

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

### Pemeriksaan lokal · tidak ada panggilan 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>

### Memilih tindakan pemulihan

Í Read data.status, data.remoteId dan data.errorCode dalam rekor lari.

| Status recording recorded | Tindakan |
| --- | --- |
| succeeded | Periksa akses, kemudian ekspor hasil yang disimpan dalam langkah 3. |
| accepted | Periksa akses, kemudian mendapatkan kembali pekerjaan yang diterima dalam langkah 3. |
| uncertain / intent | Jangan sampai tugas ini dihentikan. Periksa remoteId, candidateRemoteIds dan History sebelum memutuskan apakah akan menyerahkan sesuatu lagi. |
| failed | Fix errorCode pertama. Catatan gagal dari IOZA tetap dipertahankan; pengganti adalah tugas baru dan dapat menggunakan kredit. |
| partial | Simpan output yang tersedia. Memulih kembali pekerjaan yang diketahui; untuk pekerjaan pukal, memeriksa setiap baris sebelum mengganti item yang gagal. |
| run_not_found | Periksa profil, pengguna dan direktori negara OS. Lihat penerimaan yang telah disimpan atau History jika jurnal ini hilang. |

- [Sejarah permintaan terbuka](https://flashdata.dev/app/jobs)
- [Pulihkan hasil pukal](https://flashdata.dev/ms/docs/guides/bulk/reference.md)

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

## 2. Periksa akses akun CLI

Cek gratis ini memerlukan akses ke akun asli dan asal API. Selesaikan semua kesalahan otentikasi sebelum hasil pemulihan.

### Oversi akses dan baca keseimbangan

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

### Periksa bidang ini

Keseimbangan nol adalah masalah pendanaan untuk pekerjaan baru. Ini tidak dengan sendirinya berarti bahwa kunci tidak sah.

| lapangan auth status | Diharapkan |
| --- | --- |
| data.accessVerified | true; jika tidak perbaiki akses sebelum hasil pembacaan. |
| data.identity.identity.accountId | Akun yang menyerahkan tugas itu. |
| data.identity.permittedSources | Termasuk sumber yang digunakan oleh tugas yang disimpan. |
| data.identity.identity.recurringAllowed | true sebelum melanjutkan tugas yang berulang. |


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

### Catatan itu berubah, atau aku hanya mengklaim pengadilan

run_account_mismatch berarti yang disimpan adalah milik akun yang berbeda atau asal API. Melucuti nama profil tidak mentransfer yang berjalan.

| Situasi Orang Asing | Aksi |
| --- | --- |
| Akun yang salah | Anda harus memeriksa kunci lingkungan, profil terpilih dan management/data asal-usul. Pulihkan rekening yang dituju sebelum pemulihan. |
| Kualapan Kunci | Gunakan kunci gantian untuk akaun yang sama dengan kebenaran sumber yang diperlukan. Kekalkan profil asal, direktori keadaan dan ID pelaksanaan. |
| Tuntutan pengadilan | Akun pemilik berbeda dengan akun sementara. Uji coba Baca uji coba Anda sudah dieksport. Unakel menggunakan lari baru ID hanya untuk tugas pemilik baru yang dimaksudkan; ia menggunakan saldo pemilik. |

- [Gantikan kunci pemilik](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Percubaan dan pemautan akaun](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#owner-result)

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

### Melanjutkan klaim terganggu

Untuk klaim yang disetujui, jalankan auth finish dalam profil aslinya di dalam 24-hour handoff window. Ia menyimpan dan mengesahkan kunci pemilik, kemudian mengakui pemasangan. Perintah kedua memeriksa akses tersimpan dalam proses baru.

#### Finish yang sudah ada 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
```

- [Kedaluwarsa klaim atau kehilangan respon pendaftaran](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#help)
- [Protokol pengesahan](https://flashdata.dev/auth.md)

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

## 3. Memulihkan hasil CLI

Tak ada yang memilih status tersimpan dari langkah 1. Unado menggunakan nama berkas keluaran yang tidak ada. Kedua-duanya memerintahkan untuk memverifikasi akses dan tetap menjalankan yang asli; juga tidak mengajukan pertanyaan penggantian.

### Kejayaan yang disimpan

#### Ekspor hasil yang disimpan

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


### Pekerjaan async yang telah diterima

TUBUH TPS menghentikan penantian lokal. Lakukan lagi perintah pemulihan ini untuk terus menunggu pekerjaan yang sama.

#### Tunggu untuk pekerjaan asli

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


- [¡ Bacalah pekerjaan jauh yang diketahui ID](https://flashdata.dev/ms/docs/guides/async-batch/reference.md#job-status)

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

### Konfirmasi pemulihan sebelum melanjutkan kembali

1. Periksa kode keluar 0 dan ok: true, kemudian buka recovered.json. Ekspor tersimpan-result memiliki cached: true; penggunaan mengacu pada eksekusi asli.
2. Dia juga menyimpan akun, profil, keadaan dan menjalankan ID ketika mencoba kembali kejadian ini. Jangan hapus jurnalnya atau ubah nama lari untuk memaksa coba lagi.
3. Penjadwalan kembali dilakukan hanya setelah akses dan hasilnya diverifikasi. Berikan setiap kejadian baru yang dijadwalkan sendiri ID.

- [(Meski)](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md#slot)
- [Simpan hasil untuk digunakan nanti](https://flashdata.dev/ms/docs/guides/save-results/reference.md)

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

## Memulihkan tugas MCP

Panggilan MCP tidak membuat catatan lari CLI. Guna koneksi MCP yang sudah ada untuk akun yang menyerahkan pekerjaan. Menyampaikan pekerjaan ID dalam prompt ini dan mengirimkannya ke agen terhubung Anda.

### Ditempelkan ke agenmu yang terhubung

```text
Pulihkan kembali pekerjaan FlashDataku yang sudah ada: job_REPLACE_WITH_SAVED_ID.
Use the now MCP koneksi. Panggilan get_balance dengan {} untuk memeriksa akses,
Kemudian get_job dengan job_id ini.
Jika balasan berisi result_id, finish membaca potongan get_result
Dan menggabungkan mereka sebelum meng-hurai JSON.
* Untuk * job.status Bertangguh atau diproses, polling pekerjaan yang sama setiap 5 detik
Untuk sampai ke 2 menit, kemudian melaporkan status terbaru dan berhenti.
Untuk selesai, simpan keluaran dan sumbernya URLs dan penggunaan dalam tugas ini.
Pada kesalahan akses, pekerjaan gagal atau hasil tidak tersedia, berhenti dan melaporkan ID.
Jangan jalankan sebuah alat sumber, kirim sebuah kelompok, atau buat kredensial baru.
```

- [S_ambungkan kembali sebuah hos MCP](https://flashdata.dev/ms/docs/guides/agent-access/reference.md)
- [Referensi alat MCP](https://flashdata.dev/ms/docs/mcp/reference.md)

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

### Bacalah pekerjaan aslinya

Untuk klien ustom MCP, luluskan objek ini ke callTool setelah menggantikan job_id. Ini adalah panggilan alat, bukan perintah shell. get_job memeriksa akun pekerjaan dan izin sumber; pemeriksaan get_balance yang sukses saja tidak membuktikan akses ke pekerjaan ini.

#### get_job

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


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

### Periksa status pekerjaan MCP

| Respons | Tindakan berikutnya |
| --- | --- |
| job.status: pending / processing | Tunggu, kemudian membaca pekerjaan yang sama ID. Sebuah tenggat waktu lokal tidak membatalkannya. |
| job.status: completed | Simpan keluaran. Penggunaannya dimiliki oleh pertanyaan asli; get_job tidak mengajukan atau mengisi untuk pertanyaan baru. |
| job.status: failed / isError: true | Í Baca kesalahan sebelum menggunakan output apapun. Jangan jalankan ulang sumber secara otomatis. |
| code: result_unavailable | Anda coba baca ulang untuk kegagalan pengiriman sementara. Jika hasil yang disimpan habis, gunakan ekspor lebih awal. Hasil Async JSON dipelihara untuk jam 24. |


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

### Respon MCP yang besar disampuk

Gunakan result_id yang disimpan dengan kunci API yang sama. Mulai di offset 0 untuk membangun kembali seluruh respon; jika Anda menyimpan potongan sebelumnya, gunakan next_offset yang tepat mereka sebagai gantinya. Gantikan pemegang tempat sebelum memanggil alat ini.

1. Tambahkan setiap potongan secara berurutan, menggunakan next_offset sampai null. Dia akan memparse gabungan JSON hanya setelah potongan terakhir.
2. cache berlangsung 10 menit dan menyimpan empat respon besar terbaru per kunci. Jika sudah kadaluarsa atau diusir dan kau menyimpan pekerjaan ID, hubungi get_job lagi dan baca bagian barunya.
3. Respon realtime tidak memiliki pekerjaan latar belakang yang dapat dipulihkan. Tanpa pekerjaan yang disimpan ID atau ekspor, periksa History dan tanyakan sebelum menjalankan pertanyaan berbayar baru.

#### get_result

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

- [MCP Klien dengan penanganan potongan](https://flashdata.dev/ms/docs/guides/mcp-custom-client/reference.md)

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

## Aku tidak punya pekerjaan atau pekerjaan ID

Periksa berkas tersimpannya tugas, sejarah alat agen dan permintaan pemilik History. A request_id adalah diagnostik ID, bukan job_id. Jika Anda tidak dapat mengkonfirmasi apakah penyerahan diterima, tetap hentikan tugas. Mengulangi panggilan sumber yang asli dapat membuat muatan lain.

- [Sejarah permintaan terbuka](https://flashdata.dev/app/jobs)

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

## Cari sebuah perbaikan dengan kode kesalahan

| Petunjuk | Fix |
| --- | --- |
| 400 / 422 | Periksa argumen terhadap alat atau skema titik akhir. Untuk permintaan CLI, gunakan pertanyaan --dry-run sebelum tugas baru apapun. |
| 401 / 403 | Untuk CLI, periksa akses di langkah 2. * Untuk * MCP OAuth, Biarkan tuan rumah segar kembali; hibah yang dicabut perlu rekoneksi yang disetujui oleh pemilik. Dengan kunci API, periksa rahasia dan hak sumber tuan rumah. |
| 402 | Hentikan pekerjaan baru sampai pemilik menyelesaikan pendanaan. |
| 406 | Guna Accept: application/json. Untuk titik akhir konten yang didukung, permintaan Markdown dengan X-Respond-With: markdown. |
| 429 | Kehormati Retry-After dan pulihkan pekerjaan apapun yang diketahui sebelum menyerahkan lagi. Penantian zinif tidak membersihkan rekor lari CLI yang gagal. |
| Masa Kehabisan Masa Tamat / 5xx / respon hilang | Pemulihan diketahui pekerjaan diterima. Pastikan hasil pengiriman tidak diketahui dijedakan dan periksa History. |
| run_id_input_conflict | Pulihkan input asli. Input baru membutuhkan tugas baru yang disengaja dan menjalankan ID. |
| run_account_mismatch | Use the account-change checklist in step 2; a new run ID bukanlah jalan pintas pemulihan. |
| output_exists | Pilih nama berkas keluaran baru. Tetap selamatkan dia. |
| result_unavailable | Untuk MCP, periksa pekerjaan atau potongan langkah di atas. Untuk CLI, dapatkan kembali pekerjaan yang diterima. Hasil kadaluwarsa membutuhkan ekspor atau penyimpanan Anda sendiri sebelumnya. |

- [Referensi kesalahan HTTP](https://flashdata.dev/ms/docs/errors/reference.md)
- [S_ambungkan kembali sebuah hos MCP](https://flashdata.dev/ms/docs/guides/agent-access/reference.md)

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

## Diagnostik untuk mendukung

Untuk CLI, jalankan filter jq ini pada error.json yang disimpan oleh tugas anda. Untuk MCP, kode salin, http_status dan request_id dari respon alat, ditambah job_id yang disimpan atau result_id. Jalur ini termasuk versi klien, titik akhir, waktu UTC dan apakah penerimaan dikonfirmasi atau tidak. Kekecualian kelayakan, cookies dan ditandatangani URLs.

### Mediagnosis Diagnostik diagnostik hanya dipilih oleh orang lokal

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

- [Hubungi sokongan](https://flashdata.dev/ms/contact)
