Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Panduan

Merekrut integrasi agen

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

Di halaman ini

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 telahGunakan
CLI runIdCLI langkah-langkah di bawah ini, dengan profil asli dan direktori negara.
MCP job IDget_job pada yang ada MCP koneksi.
Hasil MCP IDget_result ke finish membaca respon besar.
OpenClaw jalankan IDOpenClaw menjalankan sejarah, kemudian FlashData ID direkam oleh yang dijalankan.

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
# 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
: "${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

Pilih aksi pemulihan

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

Status rekamanYang perlu dilakukan
succeededPeriksa akses, lalu ekspor hasil disimpan dalam langkah 3.
acceptedPeriksa akses, kemudian pulihkan pekerjaan yang diterima di langkah 3.
uncertain / intentTetap jalankan tugas ini. Periksa remoteId, candidateRemoteIds dan History sebelum memutuskan apakah akan mengirimkan sesuatu lagi.
failedPerbaiki errorCode dulu. Sebuah catatan gagal dipertahankan; pengganti adalah tugas baru dan dapat menggunakan kredit.
partialJauhkan outputs yang tersedia. Recover dikenal pekerjaan; untuk pekerjaan massal, memeriksa setiap baris sebelum mengganti item yang gagal.
run_not_foundPeriksa profil, pengguna OS dan direktori negara. Cari tanda terima atau History jika jurnal hilang.

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
: "${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

Periksa bidang ini

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

Field auth statusDiharapkan
data.accessVerifiedtrue; sebaliknya memperbaiki akses sebelum hasil pembacaan.
data.identity.identity.accountIdRekening yang mengajukan tugas.
data.identity.permittedSourcesTermasuk sumber yang dipakai oleh tugas yang disimpan.
data.identity.identity.recurringAllowedtrue sebelum melanjutkan tugas yang berulang.

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.

SituasiAksi
Rekening salahPeriksa penimpaan lingkungan, profil yang dipilih dan asal management/data. Kembalikan akun yang dimaksud sebelum pemulihan.
Tombol diputarGunakan kunci pengganti untuk akun yang sama dengan izin sumber yang diperlukan. Pertahankan profil aslinya, direktori negara dan jalankan ID.
Diklaim percobaanRekening 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.

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
: "${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

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.

Ekspor hasil yang disimpan
: "${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

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.

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

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
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}

Periksa MCP status tugas

ResponsAksi berikutnya
job.status: pending / processingTunggu, kemudian membaca pekerjaan yang sama ID. Tenggat waktu lokal tidak membatalkannya.
job.status: completedSimpan keluaran. Pemakaian milik kueri asli; get_job tidak mengirimkan atau mengisi untuk kueri baru.
job.status: failed / isError: trueBaca kesalahan sebelum menggunakan keluaran apapun. Jangan putar ulang sumbernya secara otomatis.
code: result_unavailableCoba lagi pembacaan untuk kegagalan pengiriman sementara. Bila hasil yang disimpan kadaluarsa, gunakan ekspor sebelumnya. Async JSON hasil tetap untuk jam 24.

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
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}

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.

Cari sebuah fix dengan kode error

SinyalPerbaiki
400 / 422Periksa argumen terhadap skema tool atau endpoint. Untuk CLI permintaan, gunakan query --dry-run sebelum setiap tugas baru.
401 / 403Untuk 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.
402Hentikan pekerjaan baru sampai pemiliknya menyelesaikan pendanaan.
406Gunakan Accept: application/json. Untuk endpoints yang didukung, permintaan Markdown dengan X-Respond-With: markdown.
429Kehormatan Retry-After dan memulihkan setiap pekerjaan yang diketahui sebelum mengirimkan lagi. Menunggu tidak membersihkan rekor gagal CLI.
Waktu habis / 5xx / kehilangan responRecover dikenal menerima pekerjaan. Jauhkan hasil pengiriman yang tidak diketahui jeda dan periksa History.
run_id_input_conflictKembalikan input asli. Masukan baru membutuhkan tugas baru yang disengaja dan menjalankan ID.
run_account_mismatchGunakan akun-perubahan daftar cek dalam langkah 2; run baru ID bukan jalan pintas pemulihan.
output_existsPilih nama berkas keluaran baru. Jaga agar bisa selamat.
result_unavailableUntuk MCP, periksa pekerjaan atau langkah-langkah potongan di atas. Untuk CLI, pulihkan remote yang diterima. Hasil kadaluarsa membutuhkan ekspor awal atau penyimpanan sendiri.

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
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json