# Bir ajan entegrasyonunu yeniden keşfedin

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

Canonical referans: https://flashdata.dev/tr/docs/guides/agent-recovery
İnceleme: 2026-11-05 Tarafından FlashData

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

## 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 sahipsin | Kullanım |
| --- | --- |
| CLI runId | CLI 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 ID | OpenClaw tarih koşar, sonra FlashData ID bu çalıştırın. |

- [CLI kurtarma](https://flashdata.dev/tr/docs/guides/agent-recovery/reference.md#inspect)
- [MCP kurtarma](https://flashdata.dev/tr/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw tarihi yönetiyor](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md#inspect-test)

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

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

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

### Yerel denetim · API arama

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

### Kurtarma eylemi seçin

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

| Kayıt Edilen Durumlar | Yapılacak işlem |
| --- | --- |
| succeeded | Check access, sonra kaydedilen sonucu 3'ya ihraç edin. |
| accepted | Check access, sonra kabul edilen işi 3'nun adımında kurtarın. |
| uncertain / intent | Görevi durakladın. remoteId, candidateRemoteIds ve History'u tekrar bir şey göndermeye karar vermeden önce kontrol edin. |
| failed | errorCode ilk önce. Başarısız bir kayıt tutulur; bir yedek yeni bir görevdir ve kredi kullanabilir. |
| partial | Mevcut çı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_found | Profili kontrol edin, OS kullanıcı ve eyalet rehberi. Eğer dergi kaybolursa satın alınan makbul veya History'ye bakın. |

- [Open request date](https://flashdata.dev/app/jobs)
- [Recover toplu sonuçları](https://flashdata.dev/tr/docs/guides/bulk/reference.md)

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

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

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

### 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.accessVerified | true; aksi takdirde okuma sonuçları başlamadan önce erişim. |
| data.identity.identity.accountId | Görevi gönderen hesap. |
| data.identity.permittedSources | Kurtarılan görev tarafından kullanılan kaynağı içerir. |
| data.identity.identity.recurringAllowed | true, tekrarlanan bir görevi yeniden başlatmadan önce. |


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

### 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 durumu | Action 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. |

- [Bir sahibinin anahtar anahtarını değiştirin](https://flashdata.dev/tr/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Deneme ve hesap bağlama](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#owner-result)

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

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

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

- [Açıklama iddia edildi veya kayıt yanıtını kaybetti](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#help)
- [Kimlik Doğrulama protokolü](https://flashdata.dev/auth.md)

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

## 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 Başarıyı Kurtardı

#### Kurtarılan sonuç

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


### Async işini kabul etti

Bir anket süresi yerel beklemeyi durdurur. Bu kurtarma komutunu tekrar aynı işi beklemeye devam edin.

#### Orijinal iş için bekleyin

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


- [Bilinen bir uzaktan işi okuyun ID](https://flashdata.dev/tr/docs/guides/async-batch/reference.md#job-status)

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

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

- [Recurring-task koşucu](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md#slot)
- [Daha sonra kullanım için sonuçlar Kaydet results for later use](https://flashdata.dev/tr/docs/guides/save-results/reference.md)

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

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

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

- [Bir MCP ev sahibi](https://flashdata.dev/tr/docs/guides/agent-access/reference.md)
- [MCP aracı referans](https://flashdata.dev/tr/docs/mcp/reference.md)

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

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

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


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

### MCP iş durumunu kontrol edin

| Yanıt | Sonraki eylem |
| --- | --- |
| job.status: pending / processing | Bekle, sonra aynı işi ID'yu okuyun. Yerel bir süre iptal edilmez. |
| job.status: completed | Kaydet çıktı. Onun kullanımı orijinal sorguya aittir; get_job yeni bir sorgu için gönderme veya sorumlu değildir. |
| job.status: failed / isError: true | Herhangi bir çıktı kullanmadan önce hatayı okuyun. Kaynağı otomatik olarak yeniden kullanmayın. |
| code: result_unavailable | Geç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. |


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

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

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

- [MCP müşteri ile chunk ile](https://flashdata.dev/tr/docs/guides/mcp-custom-client/reference.md)

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

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

- [Open request date](https://flashdata.dev/app/jobs)

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

## Hata kodu ile bir düzeltme bul

| Signal Signal Signal | Fix Fix |
| --- | --- |
| 400 / 422 | Aracı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 / 403 | CLI 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. |
| 402 | Sahibi finanse edene kadar yeni çalışmayı durdurun. |
| 406 | Use Use Use Accept: application/json. Desteklenen içerik uç noktaları için, istek Markdown with with with ile X-Respond-With: izdown. |
| 429 | Honor 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ıt | Tanınmış işleri yeniden keşfedin. Bilinmeyen teslim sonuçları durakladı ve History'u kontrol edin. |
| run_id_input_conflict | Orijinal girdiyi geri yükleyin. Yeni girişin kasıtlı yeni bir göreve ihtiyacı var ve ID'u çalıştırın. |
| run_account_mismatch | 2'un adımdaki hesap değiştirme kontrol listesini kullanın; yeni bir run ID bir kurtarma kısayolu değildir. |
| output_exists | Yeni bir çıkış dosyası adını seçin. Kurtarılan koşmayı tut. |
| result_unavailable | MCP 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. |

- [HTTP hata referansı](https://flashdata.dev/tr/docs/errors/reference.md)
- [Bir MCP ev sahibi](https://flashdata.dev/tr/docs/guides/agent-access/reference.md)

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

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

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

- [Destek ile iletişim](https://flashdata.dev/tr/contact)
