İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Kılavuzlar

Bir ajan entegrasyonunu yeniden keşfedin

CLI veya MCP görevini kurtarmayı, işini veya ID'yu sonlandırmayı yeniden keşfedin.

Bu sayfada

ID ile başlayın

Başarısız görevi veya programı kullanın. Görev klasörü veya acente geçmişinizde makbunu bulun, sonra eşleştirme yolunu takip edin. Bu IDs, değiştirilemez değildir.

Sen sahipsinKullanım
CLI runIdCLI aşağıdaki adımları, orijinal profil ve eyalet rehberi ile.
MCP işi ID · iş_.get_job Mevcut mevcut MCP bağlantı.
MCP sonucu ID · sonuç_.get_result to finish büyük bir yanıt okuyor.
OpenClaw çalışır IDOpenClaw tarih koşar, sonra FlashData ID bu çalıştırın.

1. CLI koşmak

Açık Açık Açık Bash (Git Bash Onda Windows) Orijinal olarak OS Kullanıcı, görevinizin çıktı klasöründe. Orijinal görevden gelenlerle birlikte tüm üç değeri değiştirin. Bu terminali adımlar için açık tutun 2 Ve ve 3. Unset FLASHDATA_API_KEY İzin verin, CLI Bu profilde kaydedilen anahtarı kullanın.

Mevcut görevi seçin · bu terminal
# 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
Yerel denetim · API arama
: "${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

Kurtarma eylemi seçin

data.status, data.remoteId ve data.errorCode'u çalıştırın kaydında okuyun.

Kayıt Edilen DurumlarYapılacak işlem
succeededCheck access, sonra kaydedilen sonucu 3'ya ihraç edin.
acceptedCheck access, sonra kabul edilen işi 3'nun adımında kurtarın.
uncertain / intentGörevi durakladın. remoteId, candidateRemoteIds ve History'u tekrar bir şey göndermeye karar vermeden önce kontrol edin.
failederrorCode ilk önce. Başarısız bir kayıt tutulur; bir yedek yeni bir görevdir ve kredi kullanabilir.
partialMevcut çıktıları tut. Bilinen işleri yeniden keşfedin; toplu iş için, başarısız eşyaları değiştirmeden önce her satırı inceleyin.
run_not_foundProfili kontrol edin, OS kullanıcı ve eyalet rehberi. Eğer dergi kaybolursa satın alınan makbul veya History'ye bakın.

2. Check CLI account access

Bu ücretsiz çekler orijinal hesaba ve API kökenlerine erişim gerektirir. Sonuçlar kurtarmadan önce herhangi bir doğrulama hatası çözün.

Erişimi onaylayın ve dengeyi okuyun
: "${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

Bu alanları kontrol edin

Sıfır bir denge, yeni iş için bir finansman sorunudur. Bu kendi başına değildir, anahtarın geçersiz olduğu anlamına gelir.

auth status alanıBeklendi
data.accessVerifiedtrue; aksi takdirde okuma sonuçları başlamadan önce erişim.
data.identity.identity.accountIdGörevi gönderen hesap.
data.identity.permittedSourcesKurtarılan görev tarafından kullanılan kaynağı içerir.
data.identity.identity.recurringAllowedtrue, tekrarlanan bir görevi yeniden başlatmadan önce.

Hesap değişti, ya da sadece bir deneme iddia ettim

run_account_mismatch, kayıtlı çalıştırmanın farklı bir hesaba veya API origin değerine ait olduğunu belirtir. Profil adını yeniden kullanmak çalıştırmayı diğer hesaba taşımaz.

Durum durumuAction Action Action
Yanlış hesapÇevre anahtarını kontrol edin, seçilmiş profil ve management/data kökenleri. Kurtarmadan önce amaçlanan hesabı geri yükleyin.
Anahtar döndürüldüGerekli kaynak izni ile aynı hesap için bir yedek anahtar kullanın. Orijinal profili tut, eyalet rehberi ve ID çalıştırın.
Davalı DavalıSahibi hesabı geçici hesaptan farklıdır. Daha önce ihraç ettiğiniz deneme çıktılarını okuyun. Yeni bir run ID'u sadece amaçlanan yeni bir mal sahibi görevi için kullanın; sahibin dengesini kullanır.

Resume bir kesinti iddia

Onaylanmış bir iddia için, koşmak auth finish Orijinal profili içinde 24- saatlik eloff penceresi. Sahibi anahtarı kurtarır ve tutar, sonra yüklemeyi kabul eder. İkinci komut, kurtarılan erişimi yeni bir süreçte kontrol eder.

Mevcut eloff'u bitirin
: "${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. CLI sonucunu yeniden keşfedin

Adım 1 içinde kaydedilen durumu seçin. Henüz bulunmayan bir çıktı dosyası adı kullanın. İki komut da erişimi doğrular ve asıl çalıştırmayı korur; hiçbiri yeni bir sorgu göndermez.

Kurtarılan sonuç
: "${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

Resuming yapmadan önce kurtarmayı Onaylayın

  1. Check exit code 0 ve ok: true, sonra recovered.json'u açın. Kaydeten-result ihracat cached: true'ya sahiptir; kullanım orijinal yürütmeye atıfta bulunur.
  2. Aynı hesabı tut, profil, eyalet ve ID'u bu olayı yeniden denemede çalıştırın. Dergisini silmeyin ya da bir yeniden denemeyi zorlamak için adımı isimlendirmeyin.
  3. Yalnızca erişimden sonra ve sonuç doğrulanır. Her yeni planlanan olayı kendi ID'u kendi çalıştırın.

Bir MCP görevini yeniden keşfedin

MCP aramaları CLI koşu kayıtlarını yaratmaz. İşi gönderen hesap için mevcut MCP bağlantısını kullanın. İş ID'u bu şekilde değiştirin ve bağlantılı acentenize gönderin.

Bağlantılı ajanınıza yapıştırın
Mevcut FlashData işini yeniden keşfedin: job_REPLACE_WITH_SAVED_ID.
Mevcut MCP bağlantısını kullanın. get_balance ile {}'u kontrol etmek için arayın,
Sonra get_job ile bu job_id ile.
Cevap result_id içeriyorsa, finish get_result chunks
Onları JSON'u terk etmeden birleştirin.
job.status bekleme veya işleme için, her 5 saniyede aynı işi anket yapın.
2 dakikalarına kadar, o zaman en son durumu ve dur.
Tamamlanan için, çıktı ve kaynağı URLs ve bu görevde kullanım.
Bir erişim hatasında, başarısız bir iş ya da sonuç elde edemedi ve ID'u rapor etti.
Bir kaynak aracı çalıştırmayın, bir toplu gönderin veya yeni kimlikler yaratın.

Orijinal işi okuyun

Bir özel için MCP müşteri, bu nesneyi bu nesneyi geçmek callTool Sonra değiştirildikten sonra job_id. Bu bir araç çağrısı değil, bir kabuk komutu değil. get_job iş hesabını ve kaynak iznini kontrol eder; başarılı bir get_balance check tek başına bu işe erişimi kanıtlamıyor.

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

MCP iş durumunu kontrol edin

YanıtSonraki eylem
job.status: pending / processingBekle, sonra aynı işi ID'yu okuyun. Yerel bir süre iptal edilmez.
job.status: completedKaydet çıktı. Onun kullanımı orijinal sorguya aittir; get_job yeni bir sorgu için gönderme veya sorumlu değildir.
job.status: failed / isError: trueHerhangi bir çıktı kullanmadan önce hatayı okuyun. Kaynağı otomatik olarak yeniden kullanmayın.
code: result_unavailableGeçici bir teslimat başarısızlığı için okumayı yeniden deneyin. Kurtarılan sonuç sona erseydi, daha önce ihracat kullanın. Async JSON sonuçları 24 saatleri için muhafaza edilmiştir.

Büyük bir MCP cevabı kesildi

result_id'u aynı API anahtarı ile kullanın. 0'u tüm cevabı yeniden inşa etmeye başlayın; daha önceki kıvrımları tuttuysanız, tam next_offset'larını kullanın. Bu aracı aramadan önce yer sahibini değiştirin.

  1. Her chunk'ı sırayla, kullanarak next_offset olana kadar null. Sadece son chunk'tan sonra birlikte JSON'u yeniden yapılandırın.
  2. Önbellek 10 dakika sürer ve anahtar başına dört yeni büyük yanıt tutar. Eğer sona ermiş ya da tahliye edilmiş olsaydı ve bir iş ID'u kurtardıysanız, get_job'u tekrar çağırın ve yeni chunkslarını okuyun.
  3. Gerçek zamanlı bir yanıtın garanti edilebilir bir arka plan işi yoktur. ID veya ihracat olmadan, History'u kontrol edin ve yeni ücretli bir sorgu çalıştırmadan önce sorun.
get_result
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}

Ben koşmam ya da iş ID

Görevin kurtarılmış dosyaları, ajan aracı tarihini ve sahibinin History'u talep etmesini kontrol edin. A A A a A AA A A request_id Bir tanıtır IDAma değil job_id. Gönderinin kabul edilip edilmediğini onaylayamazsanız, görevi durdurur. Orijinal kaynak çağrısını tekrarlamak başka bir şarj yaratabilir.

Hata kodu ile bir düzeltme bul

Signal Signal SignalFix Fix
400 / 422Aracın veya uç noktası şemalarına karşı argümanları kontrol edin. CLI talepleri için, herhangi bir yeni görevden önce sorgu --dry-run kullanın.
401 / 403CLI için, 2 adıma erişim kontrol edin. MCP OAuth için, ev sahibi yenilemeye izin verin; iptal edilen bir hibenin sahibine onaylı yeniden bağlantıya ihtiyacı vardır. Bir API anahtarı ile, ev sahibinin gizli ve kaynak izinlerini kontrol edin.
402Sahibi finanse edene kadar yeni çalışmayı durdurun.
406Use Use Use Accept: application/json. Desteklenen içerik uç noktaları için, istek Markdown with with with ile X-Respond-With: izdown.
429Honor Retry-After ve tekrar göndermeden önce bilinen herhangi bir işi geri döndürür. Beklemek başarısız bir CLI iş rekorunu açıklamıyor.
Timeout / 5xx / kayıp yanıtTanınmış işleri yeniden keşfedin. Bilinmeyen teslim sonuçları durakladı ve History'u kontrol edin.
run_id_input_conflictOrijinal girdiyi geri yükleyin. Yeni girişin kasıtlı yeni bir göreve ihtiyacı var ve ID'u çalıştırın.
run_account_mismatch2'un adımdaki hesap değiştirme kontrol listesini kullanın; yeni bir run ID bir kurtarma kısayolu değildir.
output_existsYeni bir çıkış dosyası adını seçin. Kurtarılan koşmayı tut.
result_unavailableMCP için, yukarıdaki işi veya chunk adımlarını kontrol edin. CLI için, kabul edilen uzaktan işi kurtar. Açıklama sonuçları daha önceki bir ihracata veya kendi depolamanıza ihtiyaç duyar.

Desteklemek için bir tanı gönder

CLI için bu jq filtresini görevin kaydettiği error.json üzerinde çalıştırın. MCP için araç yanıtından code, http_status ve request_id değerlerini; kayıtlı job_id veya result_id ile birlikte alın. İstemci sürümünü, endpoint adresini, UTC saatini ve kabul durumunun doğrulanmış mı bilinmiyor mu olduğunu ekleyin. Kimlik bilgilerini, çerezleri ve imzalı URL değerlerini paylaşmayın.

Tanık alanları seçin · sadece yerel sadece
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json