# Merekrut integrasi agen

Menginterupsi kembali tugas CLI atau MCP menggunakan aksi penyelamatan, tugas, atau hasil ID.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/agent-recovery
Diulang: 2026-11-05 oleh FlashData

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

## Mulai dengan ID yang kau simpan

Jeda tugas yang gagal atau jadwal. Temukan tanda terima di folder tugas atau riwayat agen Anda, kemudian ikuti jalur yang cocok. IDs ini tidak bisa ditukar.

| Anda telah | Gunakan |
| --- | --- |
| CLI runId | CLI langkah-langkah di bawah ini, dengan profil asli dan direktori negara. |
| MCP job ID | get_job pada yang ada MCP koneksi. |
| Hasil MCP ID | get_result ke finish membaca respon besar. |
| OpenClaw jalankan ID | OpenClaw menjalankan sejarah, kemudian FlashData ID direkam oleh yang dijalankan. |

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

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

## 1. Inspeksi run CLI

Buka Bash (Git Bash pada Windows) sebagai pengguna asli OS, dalam folder keluaran tugas Anda. Ganti semua tiga nilai di bawah ini dengan mereka dari tugas asli. Tetap buka terminal ini untuk langkah 2 dan 3. Menonaktifkan FLASHDATA_API_KEY memungkinkan CLI menggunakan kunci disimpan dalam profil ini.

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

### Inspeksi lokal API panggilan

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

### Pilih aksi pemulihan

Baca data.status, data.remoteId dan data.errorCode dalam run record.

| Status rekaman | Yang perlu dilakukan |
| --- | --- |
| succeeded | Periksa akses, lalu ekspor hasil disimpan dalam langkah 3. |
| accepted | Periksa akses, kemudian pulihkan pekerjaan yang diterima di langkah 3. |
| uncertain / intent | Tetap jalankan tugas ini. Periksa remoteId, candidateRemoteIds dan History sebelum memutuskan apakah akan mengirimkan sesuatu lagi. |
| failed | Perbaiki errorCode dulu. Sebuah catatan gagal dipertahankan; pengganti adalah tugas baru dan dapat menggunakan kredit. |
| partial | Jauhkan outputs yang tersedia. Recover dikenal pekerjaan; untuk pekerjaan massal, memeriksa setiap baris sebelum mengganti item yang gagal. |
| run_not_found | Periksa profil, pengguna OS dan direktori negara. Cari tanda terima atau History jika jurnal hilang. |

- [Sejarah permintaan terbuka](https://flashdata.dev/app/jobs)
- [Pengulangan hasil massal](https://flashdata.dev/id/docs/guides/bulk/reference.md)

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

## 2. Periksa CLI akses akun

Cek gratis ini membutuhkan akses ke akun asli dan asal API. Resolve sebarang otentikasi error sebelum memperoleh hasil.

### Verifikasi akses dan baca 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>

### Periksa bidang ini

Keseimbangan nol adalah isu pendanaan untuk pekerjaan baru. Ini tidak dengan sendirinya berarti bahwa kunci tidak valid.

| Field auth status | Diharapkan |
| --- | --- |
| data.accessVerified | true; sebaliknya memperbaiki akses sebelum hasil pembacaan. |
| data.identity.identity.accountId | Rekening yang mengajukan tugas. |
| data.identity.permittedSources | Termasuk sumber yang dipakai oleh tugas yang disimpan. |
| data.identity.identity.recurringAllowed | true sebelum melanjutkan tugas yang berulang. |


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

### Rekening berubah, atau saya hanya mengklaim sidang

run_account_mismatch berarti run disimpan milik akun yang berbeda atau asal API. Menggunakan kembali nama profil tidak mentransfer yang dijalankan.

| Situasi | Aksi |
| --- | --- |
| Rekening salah | Periksa penimpaan lingkungan, profil yang dipilih dan asal management/data. Kembalikan akun yang dimaksud sebelum pemulihan. |
| Tombol diputar | Gunakan kunci pengganti untuk akun yang sama dengan izin sumber yang diperlukan. Pertahankan profil aslinya, direktori negara dan jalankan ID. |
| Diklaim percobaan | Rekening pemilik berbeda dari rekening sementara. Membaca hasil uji coba Anda sudah diekspor. Gunakan run baru ID hanya untuk tujuan pemilik baru; ia menggunakan keseimbangan pemilik. |

- [Ganti kunci pemilik](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Uji coba dan penautan akun](https://flashdata.dev/id/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 dalam jendela handoff 24-hour. Ini menyimpan dan memverifikasi kunci pemilik, kemudian mengakui instalasi. Perintah kedua memeriksa akses yang tersimpan dalam proses baru.

#### Selesaikan handoff yang sudah ada

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

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

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

## 3. Mengembalikan hasil CLI

Pilih status yang disimpan dari langkah 1. Gunakan sebuah nama berkas keluaran yang tidak ada. Kedua perintah memverifikasi akses dan menjaga jalankan asli; baik menyerahkan permintaan pengganti.

### Berhasil diselamatkan

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


### Menerima tugas async

Waktu pemungutan suara berhenti menunggu lokal. Jalankan perintah pemulihan ini lagi untuk tetap menunggu pekerjaan yang sama.

#### Tunggu pekerjaan aslinya

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


- [Baca remote job yang dikenal ID](https://flashdata.dev/id/docs/guides/async-batch/reference.md#job-status)

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

### Konfirmasi pemulihan sebelum melanjutkan

1. Periksa kode keluar 0 dan ok: true, kemudian buka recovered.json. Pemasok hasil telah memiliki cached: true; penggunaan mengacu pada eksekusi awal.
2. Pertahankan akun, profil, negara bagian dan jalankan ID saat mengulang kejadian ini. Jangan hapus jurnalnya atau ganti nama jalankan untuk memaksa coba lagi.
3. Lanjutkan penjadwalan hanya setelah akses dan hasilnya diverifikasi. Berikan setiap kejadian baru yang dijadwalkan ID sendiri.

- [Rekursi-tugas pelari](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md#slot)
- [Simpan hasil untuk nanti gunakan](https://flashdata.dev/id/docs/guides/save-results/reference.md)

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

## Kembalikan tugas MCP

MCP panggilan tidak membuat CLI catatan lari. Gunakan koneksi MCP yang ada untuk akun yang menyerahkan tugas. Ganti tugas ID dalam prompt ini dan kirim ke agen terhubung Anda.

### Tempel ke dalam agen terhubung Anda

```text
Kembalikan pekerjaan FlashData saya: job_REPLACE_WITH_SAVED_ID.
Gunakan sambungan MCP saat ini. Call get_balance dengan {} untuk memeriksa akses,
maka get_job dengan ini job_id.
Jika jawabannya berisi result_id, finish nya membaca potongan get_result
dan menggabungkan mereka sebelum parsing JSON.
Untuk job.status tertunda atau diproses, jajak pendapat pekerjaan yang sama setiap 5 detik
untuk sampai dengan 2 menit, kemudian melaporkan status terbaru dan berhenti.
Untuk selesai, menyimpan keluaran dan sumber URLs dan penggunaan dalam tugas ini.
Pada galat akses, gagal pekerjaan atau hasil yang tak tersedia, berhenti dan laporkan ID.
Jangan jalankan suatu alat sumber, kirim suatu batch, atau buat kredensial baru.
```

- [Atur ulang host MCP](https://flashdata.dev/id/docs/guides/agent-access/reference.md)
- [MCP referensi alat](https://flashdata.dev/id/docs/mcp/reference.md)

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

### Baca pekerjaan asli

Untuk klien MCP kustom, berikan objek ini ke callTool setelah mengganti job_id. Ini adalah panggilan alat, bukan perintah shell. get_job memeriksa akun kerja dan izin sumber; pemeriksaan get_balance sukses sendiri 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 MCP status tugas

| Respons | Aksi berikutnya |
| --- | --- |
| job.status: pending / processing | Tunggu, kemudian membaca pekerjaan yang sama ID. Tenggat waktu lokal tidak membatalkannya. |
| job.status: completed | Simpan keluaran. Pemakaian milik kueri asli; get_job tidak mengirimkan atau mengisi untuk kueri baru. |
| job.status: failed / isError: true | Baca kesalahan sebelum menggunakan keluaran apapun. Jangan putar ulang sumbernya secara otomatis. |
| code: result_unavailable | Coba lagi pembacaan untuk kegagalan pengiriman sementara. Bila hasil yang disimpan kadaluarsa, gunakan ekspor sebelumnya. Async JSON hasil tetap untuk jam 24. |


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

### Sebuah respon MCP besar terganggu

Gunakan yang disimpan result_id dengan sama API kunci. Mulai dari offset 0 untuk membangun kembali seluruh respon; jika Anda menyimpan potongan sebelumnya, gunakan next_offset tepat mereka. Ganti placeholder sebelum memanggil alat ini.

1. Tambahkan setiap potongan dalam rangka, menggunakan next_offset sampai null. Parse gabungan JSON hanya setelah potongan terakhir.
2. Cache berlangsung 10 menit dan menjaga empat respon besar terbaru setiap kunci. Jika kadaluarsa atau diusir dan Anda menyimpan pekerjaan ID, hubungi get_job lagi dan baca potongan-potongan barunya.
3. Respon real time tak dijamin bisa dipulihkan. Tanpa pekerjaan yang disimpan ID atau ekspor, periksa History dan tanyakan sebelum menjalankan kuiri dibayar baru.

#### get_result

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

- [MCP klien dengan penanganan chunk](https://flashdata.dev/id/docs/guides/mcp-custom-client/reference.md)

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

## Aku tidak punya lari atau pekerjaan ID

Periksa berkas yang disimpan, riwayat alat agen dan permintaan pemilik History. request_id adalah diagnostik ID, bukan job_id. Jika Anda tidak dapat mengkonfirmasi apakah penyerahan diterima, menjaga tugas jeda. Mengulang panggilan sumber asli dapat menciptakan muatan lain.

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

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

## Cari sebuah fix dengan kode error

| Sinyal | Perbaiki |
| --- | --- |
| 400 / 422 | Periksa argumen terhadap skema tool atau endpoint. Untuk CLI permintaan, gunakan query --dry-run sebelum setiap tugas baru. |
| 401 / 403 | Untuk CLI, periksa akses dalam langkah 2. Untuk MCP OAuth, biarkan host menyegarkan; hibah yang dicabut membutuhkan pemilik-disetujui rekoneksi. Dengan kunci API, periksa izin rahasia dan sumber host. |
| 402 | Hentikan pekerjaan baru sampai pemiliknya menyelesaikan pendanaan. |
| 406 | Gunakan Accept: application/json. Untuk endpoints yang didukung, permintaan Markdown dengan X-Respond-With: markdown. |
| 429 | Kehormatan Retry-After dan memulihkan setiap pekerjaan yang diketahui sebelum mengirimkan lagi. Menunggu tidak membersihkan rekor gagal CLI. |
| Waktu habis / 5xx / kehilangan respon | Recover dikenal menerima pekerjaan. Jauhkan hasil pengiriman yang tidak diketahui jeda dan periksa History. |
| run_id_input_conflict | Kembalikan input asli. Masukan baru membutuhkan tugas baru yang disengaja dan menjalankan ID. |
| run_account_mismatch | Gunakan akun-perubahan daftar cek dalam langkah 2; run baru ID bukan jalan pintas pemulihan. |
| output_exists | Pilih nama berkas keluaran baru. Jaga agar bisa selamat. |
| result_unavailable | Untuk MCP, periksa pekerjaan atau langkah-langkah potongan di atas. Untuk CLI, pulihkan remote yang diterima. Hasil kadaluarsa membutuhkan ekspor awal atau penyimpanan sendiri. |

- [HTTP referensi kesalahan](https://flashdata.dev/id/docs/errors/reference.md)
- [Atur ulang host MCP](https://flashdata.dev/id/docs/guides/agent-access/reference.md)

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

## Kirim diagnostik untuk mendukung

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

### Pilih bidang diagnosis saja

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

- [Hubungi dukungan](https://flashdata.dev/id/contact)
