Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Panduan

Pulihkan kembali agen integrasi

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

Pada halaman ini

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 telahGuna
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 OpenClawOpenClaw sejarah sejarah, kemudian FlashData ID Direkam oleh pelarian itu.

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

Memilih tindakan pemulihan

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

Status recording recordedTindakan
succeededPeriksa akses, kemudian ekspor hasil yang disimpan dalam langkah 3.
acceptedPeriksa akses, kemudian mendapatkan kembali pekerjaan yang diterima dalam langkah 3.
uncertain / intentJangan sampai tugas ini dihentikan. Periksa remoteId, candidateRemoteIds dan History sebelum memutuskan apakah akan menyerahkan sesuatu lagi.
failedFix errorCode pertama. Catatan gagal dari IOZA tetap dipertahankan; pengganti adalah tugas baru dan dapat menggunakan kredit.
partialSimpan output yang tersedia. Memulih kembali pekerjaan yang diketahui; untuk pekerjaan pukal, memeriksa setiap baris sebelum mengganti item yang gagal.
run_not_foundPeriksa profil, pengguna dan direktori negara OS. Lihat penerimaan yang telah disimpan atau History jika jurnal ini hilang.

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
: "${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 masalah pendanaan untuk pekerjaan baru. Ini tidak dengan sendirinya berarti bahwa kunci tidak sah.

lapangan auth statusDiharapkan
data.accessVerifiedtrue; jika tidak perbaiki akses sebelum hasil pembacaan.
data.identity.identity.accountIdAkun yang menyerahkan tugas itu.
data.identity.permittedSourcesTermasuk sumber yang digunakan oleh tugas yang disimpan.
data.identity.identity.recurringAllowedtrue sebelum melanjutkan tugas yang berulang.

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 AsingAksi
Akun yang salahAnda harus memeriksa kunci lingkungan, profil terpilih dan management/data asal-usul. Pulihkan rekening yang dituju sebelum pemulihan.
Kualapan KunciGunakan kunci gantian untuk akaun yang sama dengan kebenaran sumber yang diperlukan. Kekalkan profil asal, direktori keadaan dan ID pelaksanaan.
Tuntutan pengadilanAkun 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.

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

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

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

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

Periksa status pekerjaan MCP

ResponsTindakan berikutnya
job.status: pending / processingTunggu, kemudian membaca pekerjaan yang sama ID. Sebuah tenggat waktu lokal tidak membatalkannya.
job.status: completedSimpan 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_unavailableAnda coba baca ulang untuk kegagalan pengiriman sementara. Jika hasil yang disimpan habis, gunakan ekspor lebih awal. Hasil Async JSON dipelihara untuk jam 24.

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

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.

Cari sebuah perbaikan dengan kode kesalahan

PetunjukFix
400 / 422Periksa argumen terhadap alat atau skema titik akhir. Untuk permintaan CLI, gunakan pertanyaan --dry-run sebelum tugas baru apapun.
401 / 403Untuk 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.
402Hentikan pekerjaan baru sampai pemilik menyelesaikan pendanaan.
406Guna Accept: application/json. Untuk titik akhir konten yang didukung, permintaan Markdown dengan X-Respond-With: markdown.
429Kehormati 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 hilangPemulihan diketahui pekerjaan diterima. Pastikan hasil pengiriman tidak diketahui dijedakan dan periksa History.
run_id_input_conflictPulihkan input asli. Input baru membutuhkan tugas baru yang disengaja dan menjalankan ID.
run_account_mismatchUse the account-change checklist in step 2; a new run ID bukanlah jalan pintas pemulihan.
output_existsPilih nama berkas keluaran baru. Tetap selamatkan dia.
result_unavailableUntuk MCP, periksa pekerjaan atau potongan langkah di atas. Untuk CLI, dapatkan kembali pekerjaan yang diterima. Hasil kadaluwarsa membutuhkan ekspor atau penyimpanan Anda sendiri sebelumnya.

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