# Recover an agent integration

Recover an interrupted CLI or MCP task using its save run, job or result ID.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/agent-recovery
Reviewed: 2026-11-05 by FlashData

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

## ابدأوا ID لقد أنقذتك

اوقف المهمة أو الجدول الزمني الفاشلين اعثر على إيصاله في ملفك أو تاريخ العميل، ثم اتبع مسار المطابقة. هذه هي IDs ليس قابلاً للتغيير

| لديك | الاستخدام |
| --- | --- |
| CLI runId | خطوات CLI أدناه، مع الملف الشخصي ودليل الحالة الأصليين. |
| MCP العمل ID عمل | get_job on the existing MCP connection. |
| نتيجة MCP ID ; نتيجة. | get_result to finish reading a large response. |
| OpenClaw run ID | سجل تشغيل OpenClaw، ثم معرّف FlashData الذي سجّله ذلك التشغيل. |

- [استرداد CLI](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md#inspect)
- [استرداد MCP](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw تشغيل التاريخ](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Inspect the CLI run

افتح الباب Bash (Git Bash on Windowsكالأصلية OS مستعمل، في ملفك الخاص بالمهمة. يستعاض عن القيم الثلاثة الواردة أدناه بالقيم الواردة في المهمة الأصلية. أبقوا هذه المحطة مفتوحة لخطوات 2 و 3. غير مبال FLASHDATA_API_KEY لندع CLI استخدم المفتاح الذي تم توفيره في هذا الملف

### اختيار المهمة القائمة؛ هذه المحطة النهائية

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

### التفتيش المحلي: لا توجد مكالمات من طراز API

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

### اختيار إجراءات الاسترداد

اقرأ data.status, data.remoteId and data.errorCode in the run record.

| الحالة المسجلة | الإجراء المطلوب |
| --- | --- |
| succeeded | تحقق من الوصول ثم تصدير النتيجة المنقذة في الخطوة 3. |
| accepted | تحقق من الدخول، ثم استعادة الوظيفة المقبولة في الخطوة 3. |
| uncertain / intent | حافظي على المهمة متوقفة تحقق من remoteId, candidateRemoteIds and History قبل أن تقرر ما إذا كان ينبغي تقديم أي شيء مرة أخرى. |
| failed | Fix errorCode أولاً ويُحتفظ بسجل فاشل؛ والاستبدال هو مهمة جديدة ويمكن أن يستخدم الائتمانات. |
| partial | الحفاظ على النواتج المتاحة. استرداد الوظائف المعروفة؛ وبالنسبة للعمل بالجملة، يفتش كل صف قبل استبدال البنود الفاشلة. |
| run_not_found | تحقق من الملف OS مستعمل ودليل الولاية ابحث عن إيصالات منقذة أو History إذا فقدت المذكرة. |

- [تاريخ الطلب المفتوح](https://flashdata.dev/app/jobs)
- [استرداد النتائج السائبة](https://flashdata.dev/ar/docs/guides/bulk/reference.md)

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

## 2. تحقق من وصول حساب CLI

وتحتاج هذه الضوابط المجانية إلى الوصول إلى الحساب الأصلي ومصدر API. حل أي خطأ في التوثيق قبل استرداد النتائج.

### التحقق من الوصول وقراءة الرصيد

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

### تحقق من هذه الحقول

والتوازن الصفري هو مسألة تمويل للعمل الجديد. لا يعني في حد ذاته أن المفتاح غير صحيح

| auth status | المتوقع |
| --- | --- |
| data.accessVerified | true؛ وإلا فأصلح الوصول قبل قراءة النتائج. |
| data.identity.identity.accountId | الحساب الذي قدم المهمة. |
| data.identity.permittedSources | يشمل المصدر الذي تستخدمه المهمة الموفورة. |
| data.identity.identity.recurringAllowed | true قبل استئناف مهمة متكررة. |


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

### لقد تغير الحساب، أو أنا فقط طالبت بتجربة

run_account_mismatch means the save run belong to a different account or API origin. إعادة استخدام اسم الملف لا ينقل ذلك الركض.

| الحالة | الإجراء |
| --- | --- |
| الحساب الخاطئ | تحقق من تجاوزات البيئة، وشخصيات مختارة، ومصدر management/data. أعد الحساب المقصود قبل التعافي |
| المفتاح المتناوب | (ب) استخدام مفتاح بديل للحساب نفسه مع الحصول على إذن المصدر المطلوب. حافظ على الملف الأصلي، دليل الولاية، واهرب ID. |
| التجربة المطالَب بها | ويختلف حساب المالك عن الحساب المؤقت. إقرأْ نواتجَ التجربةَ التي صدّرتَها بالفعل. إستعملْ a تشغيل جديد ID فقط لمهمة المالك الجديدة المعتزمة، إنها تستخدم رصيد المالك |

- [يستعاض عن مفتاح المالك](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [التجربة وربط الحساب](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#owner-result)

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

### Resume an interrupted claim

لربط حساب تمت الموافقة عليه، شغّل auth finish في ملفه الشخصي الأصلي خلال مهلة التسليم البالغة 24 ساعة. يحفظ مفتاح المالك ويتحقق منه ثم يؤكد تثبيته. يفحص الأمر الثاني الوصول المحفوظ في عملية جديدة.

#### الانتهاء من عملية التسليم الحالية

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

- [المطالبة المُفَقَّلة أو ردّ التسجيل المفقود](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#help)
- [بروتوكول التوثيق](https://flashdata.dev/auth.md)

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

## 3. Recover the CLI result

اختر الوضع المنقذ من الخطوة 1. استخدم اسم ملف النواتج الذي لا وجود له. ويتحقق كل من الأمرين من إمكانية الوصول ويحافظ على الركض الأصلي؛ ولا يقدم أي منهما استفساراً بديلاً.

### النجاح المنقذ

#### تصدير النتيجة المحفوظة

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


### الوظائف المقبولة

وقت الاقتراع يتوقف عن الانتظار المحلي أديري أمر التعافي هذا ثانيةً كي أستمر في انتظار نفس العمل

#### انتظروا العمل الأصلي

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


- [إقرأْ a شغل نائي معروف ID](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#job-status)

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

### استرداد تأكيدات قبل استئناف العمل

1. تحقق من شفرة الخروج 0 و ok: true، ثم فتح recovered.json. أما الصادرات المحفوظة - الرجعية فتحتوي على cached: true؛ ويشير الاستخدام إلى التنفيذ الأصلي.
2. حافظ على نفس الحساب، والوصف، والولاية، وإدارة ID عند إعادة فحص هذا الحدث. لا تحذف دفترها أو تُعيد تسمية الركض لإرغامها على العودة.
3. ولا يُستبق الجدول الزمني إلا بعد الوصول إلى الجدول، ويتم التحقق من النتيجة. أعطِ كُلّ حدث جديد مُقرّر له تشغيل ID.

- [راكب متسلسل](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md#slot)
- [توفير النتائج لاستخدامها في وقت لاحق](https://flashdata.dev/ar/docs/guides/save-results/reference.md)

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

## Recover an MCP task

MCP المكالمات لا تخلق CLI سجلاّت التشغيل. (ج) استخدام الصلة القائمة بين شركة MCP للحساب الذي قدم الوظيفة. يستعاض عن الوظيفة ID في هذه السرعة وإرسالها إلى عميلك المتصل

### عروس في عميلك المُتصل

```text
إسترجعي قائمتي FlashData الوظيفة: job_REPLACE_WITH_SAVED_ID.
استخدام الحالي MCP الإتصال. اتصل get_balance مع {} لتفقد الدخول
ثمّ get_job مع هذا job_id.
If the reply contains result_id, finish reading its get_result chunks
و تجمعهم قبل أن يقطعوا JSON.
For job.status قيد النظر أو التجهيز، يقترن بنفس الوظيفة 5 ثواني
حتى 2 دقائق، ثمّ يُبلغُ آخر حالة ويَتوقّفُ.
وللإكمال، وفر الناتج ومصدره URLs واستعماله في هذه المهمة.
On an access mistake, failed job or unavailable result, stop and report the ID.
لا تُديروا أداة مصدر، أو تقدّموا دفعة، أو تُنشئوا وثائق تفويض جديدة.
```

- [Reconnect an MCP host](https://flashdata.dev/ar/docs/guides/agent-access/reference.md)
- [أداة MCP المرجعية](https://flashdata.dev/ar/docs/mcp/reference.md)

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

### اقرأ الوظيفه الأصليه

بالنسبة لزبون من طراز MCP، نقل هذا الجسم إلى callTool بعد استبدال job_id. هذا نداء أداة، وليس قيادة قذيفة، وتتحقق شركة get_job من حساب العمل ومن إذن المصدر؛ ولا يثبت تحقق شركة get_balance وحدها إمكانية الحصول على هذه الوظيفة.

#### get_job

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


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

### تحقق من حالة وظيفة MCP

| استجابة | الإجراء التالي: |
| --- | --- |
| job.status: pending / processing | انتظر، ثم قرأت نفس العمل ID. الوقت المحلي لا يلغيه |
| job.status: completed | إنقاذ الناتج. ويعود استخدامه إلى الاستفسار الأصلي؛ ولا تقدم شركة get_job أي استفسارات جديدة أو توجه إليها. |
| job.status: failed / isError: true | اقرأ الخطأ قبل استخدام أي ناتج. لا تعيدي تشغيل المصدر تلقائياً |
| code: result_unavailable | أعد القراءة لفشل في التسليم وإذا انتهت صلاحية النتيجة الموفرة، استخدم الصادرات السابقة. ويحتفظ بنتائج Async JSON لساعات 24. |


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

### تم تعطيل رد كبير من MCP

إستخدموا المحفوظات result_id مع نفس API المفتاح بدء التعويض 0 لإعادة بناء كل الاستجابة، إذا كنت احتفظت بالقطعة السابقة، استخدام دقيق لهم next_offset بدلاً من ذلك يستعاض عن صاحب المسكن قبل تسمية هذه الأداة.

1. أقدّم كلّ فصّل في النظام، باستخدام next_offset إلى أن يكون null. اخفضوا المركب JSON فقط بعد أخر قطعة
2. المخبأ يدوم 10 دقائق وحافظ على أربعة ردود أكبر على كل مفتاح إذا انقضت أو تم طردك و أنقذت عملاً IDاتصلوا get_job مرة أخرى وقراءة أشيائها الجديدة.
3. ولا يوجد في الاستجابة في الوقت الحقيقي أي وظيفة أساسية مضمونة يمكن استردادها. وبدون وظيفة منقذة من طراز ID أو تصديرها، تحقق من History، وتسأل قبل إجراء استفسار جديد مدفوع الأجر.

#### get_result

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

- [MCP client with chunk handling](https://flashdata.dev/ar/docs/guides/mcp-custom-client/reference.md)

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

## ليس لدي أي وظيفة أو وظيفة ID

افحص ملفات المهمة المحفوظة وسجل أدوات الوكيل وسجل طلبات المالك في History. request_id معرّف تشخيصي، وليس job_id. إذا لم تستطع تأكيد قبول الإرسال، فأبقِ المهمة متوقفة. قد يؤدي تكرار استدعاء المصدر الأصلي إلى رسم آخر.

- [تاريخ الطلب المفتوح](https://flashdata.dev/app/jobs)

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

## اعثر على اصلاح برمز الخطأ

| الإشارة | Fix |
| --- | --- |
| 400 / 422 | تحقق من الحجج ضد الأداة أو الشيمة النهائية وفيما يتعلق بطلبات شركة CLI، يرجى استخدام الاستفسار --dry-run قبل أي مهمة جديدة. |
| 401 / 403 | بالنسبة لـ CLI، تحقق من الدخول في الخطوة 2. وفيما يتعلق بشركة MCP OAuth، دعي البلد المضيف يستأنف عمله؛ وتحتاج المنحة التي ألغيت إلى إعادة وصل معتمدة من المالك. مع API مفتاح، تحقق من سر المضيف وأذن المصدر |
| 402 | توقف عن العمل الجديد حتى يحل المالك التمويل |
| 406 | Use Accept: application/json. وللحصول على نقاط نهائية مدعومة بالمحتوى، يرجى من شركة Markdown أن تطلب إلى شركة X-Respond-With: نقطة انطلاق. |
| 429 | الشرف Retry-After وإستعادة أي عمل معروف قبل أن يقدم مرة أخرى الإنتظار لا يُوضّحُ a فشل سجلّ CLI. |
| الوقت/الساعة الخامسة/الرد المفقود | إستعادة الوظائف المقبولة المعروفة. إبقاء نتائج التقديم غير معروفة متوقفة ومتحققة History. |
| run_id_input_conflict | أعيدي المُدخل الأصلي. والمدخلات الجديدة تحتاج إلى مهمة جديدة متعمدة وتدير ID. |
| run_account_mismatch | استخدم قائمة التحقق عند تغيير الحساب في الخطوة 2؛ معرّف التشغيل الجديد ليس اختصارًا لاستعادة العمل. |
| output_exists | اختر اسم ملف جديد للناتج أبقوا المنقذين يهربون |
| result_unavailable | For MCPتحقق من العمل أو خطوات الاختناق بالنسبة لـ CLI، استرجعوا الوظيفة النائية المقبولة. النتائج المفاجئة تحتاج لتصدير سابق أو تخزين الخاص بك. |

- [HTTP](https://flashdata.dev/ar/docs/errors/reference.md)
- [Reconnect an MCP host](https://flashdata.dev/ar/docs/guides/agent-access/reference.md)

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

## أرسل تشخيصاً للدعم

For CLIأديري هذا jq تصفية على error.json انقذت بمهمتك وبالنسبة إلى MCP, copy code, http_status and request_id from the tool response, plus the Save job_id or result_id. إدراج نسخة العملاء، نقطة النهاية، وقت النقل إلى الخارج، وما إذا كان القبول مؤكداً أو غير معروف. باستثناء وثائق التفويض والكوكيز والتوقيع على URLs.

### مجالات التشخيص المختارة؛ المحلية فقط

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

- [التواصل مع الدعم](https://flashdata.dev/ar/contact)
