# एक एजेंट एकीकरण को पुनर्प्राप्त करें

एक बाधित CLI या MCP कार्य को अपने बचाया रन, जॉब या परिणाम ID का उपयोग करके पुनर्प्राप्त करें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/guides/agent-recovery
समीक्षित: 2026-11-05 द्वारा FlashData

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

## आप बचा लिया ID के साथ शुरू

असफल कार्य या अनुसूची का भुगतान करें। अपने कार्य फ़ोल्डर या एजेंट इतिहास में अपनी रसीद का पता लगाएं, फिर मिलान पथ का पालन करें। ये IDs विनिमेय नहीं हैं।

| आप | उपयोग |
| --- | --- |
| CLI runId | CLI नीचे दिए गए चरणों, मूल प्रोफ़ाइल और राज्य निर्देशिका के साथ। |
| MCP नौकरी ID · नौकरी_. | मौजूदा MCP कनेक्शन पर get_job. |
| MCP परिणाम ID | get_result to finish एक बड़ी प्रतिक्रिया पढ़ने। |
| OpenClaw दौड़ना ID | OpenClaw इतिहास चलाएं, फिर इतिहास चलाएं FlashData ID उस रन से रिकॉर्ड किया गया। |

- [CLI वसूली](https://flashdata.dev/hi/docs/guides/agent-recovery/reference.md#inspect)
- [MCP वसूली](https://flashdata.dev/hi/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw दौड़ इतिहास](https://flashdata.dev/hi/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. CLI रन का निरीक्षण करें

ओपन Bash (Git Bash on Windows) मूल OS उपयोगकर्ता के रूप में, अपने कार्य के आउटपुट फ़ोल्डर में। उन लोगों के साथ नीचे दिए गए सभी तीन मूल्यों को मूल कार्य से बदल दें। इस टर्मिनल को चरणों 2 और 3 के लिए खुला रखें। Unsetting 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
```

### No 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 और data.errorCode को रन रिकॉर्ड में पढ़ें।

| रिकॉर्ड की स्थिति | क्या करें |
| --- | --- |
| succeeded | पहुँच की जाँच करें, फिर चरण 3 में सहेजे गए परिणाम का निर्यात करें। |
| accepted | पहुँच की जाँच करें, फिर चरण 3 में स्वीकृत नौकरी को पुनर्प्राप्त करें। |
| uncertain / intent | कार्य को रोकें। चेक remoteId, candidateRemoteIds और History यह तय करने से पहले कि क्या फिर से कुछ जमा करना है। |
| failed | पहले errorCode को ठीक करें। एक असफल रिकॉर्ड बनाए रखा है; एक प्रतिस्थापन एक नया काम है और क्रेडिट का उपयोग कर सकते हैं। |
| partial | उपलब्ध आउटपुट रखें। ज्ञात नौकरियों को पुनर्प्राप्त करें; थोक काम के लिए, असफल वस्तुओं को बदलने से पहले प्रत्येक पंक्ति का निरीक्षण करें। |
| run_not_found | प्रोफ़ाइल, OS उपयोगकर्ता और राज्य निर्देशिका की जाँच करें। यदि जर्नल खो गया है तो सहेजी गई रसीदों या History के लिए देखो। |

- [ओपन अनुरोध इतिहास](https://flashdata.dev/app/jobs)
- [थोक परिणामों को पुनर्प्राप्त करें](https://flashdata.dev/hi/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 का मतलब है कि बचाया रन एक अलग खाता या API मूल के अंतर्गत आता है। प्रोफ़ाइल नाम का पुन: उपयोग करने से उस रन को ट्रांसफर नहीं होता है।

| स्थिति | कार्रवाई |
| --- | --- |
| Wrong खाता | पर्यावरण कुंजी ओवरराइड, चयनित प्रोफ़ाइल और management/data मूल की जाँच करें। वसूली से पहले इच्छित खाते को पुनर्स्थापित करें। |
| कुंजी घुमाया | आवश्यक स्रोत अनुमति के साथ उसी खाते के लिए प्रतिस्थापन कुंजी का उपयोग करें। मूल प्रोफ़ाइल, राज्य निर्देशिका रखें और ID चलाएं। |
| दावा परीक्षण | मालिक खाता अस्थायी खाते से भिन्न होता है। आप पहले से ही निर्यात किया गया परीक्षण उत्पादन पढ़ें। केवल एक नए मालिक के काम के लिए एक नए रन ID का उपयोग करें; यह मालिक के संतुलन का उपयोग करता है। |

- [मालिक कुंजी बदलें](https://flashdata.dev/hi/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [ट्रायल और खाता लिंक करना](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md#owner-result)

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

### एक बाधित दावा फिर से शुरू करें

एक अनुमोदित दावा के लिए, 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
```

- [Expired दावा या खो पंजीकरण प्रतिक्रिया](https://flashdata.dev/hi/docs/guides/agent-onboarding/reference.md#help)
- [प्रमाणीकरण प्रोटोकॉल](https://flashdata.dev/auth.md)

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

## 3. CLI परिणाम को पुनर्प्राप्त करें

चरण 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
```


### स्वीकृत async नौकरी

एक मतदान समय-बाहर स्थानीय प्रतीक्षा बंद हो जाता है। इस वसूली आदेश को फिर से उसी नौकरी के लिए इंतजार रखने के लिए चलाएं।

#### मूल नौकरी के लिए प्रतीक्षा करें

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


- [एक ज्ञात दूरस्थ नौकरी ID पढ़ें](https://flashdata.dev/hi/docs/guides/async-batch/reference.md#job-status)

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

### पुनः प्राप्त करने से पहले वसूली की पुष्टि करें

1. बाहर निकलें कोड 0 और ok: true, फिर खुला recovered.json. सेव्ड-रिज़ल्ट निर्यात में cached: true है; उपयोग मूल निष्पादन को संदर्भित करता है।
2. इस घटना को फिर से शुरू करते समय उसी खाते, प्रोफ़ाइल, राज्य और ID को चलाएं। अपनी पत्रिका को न हटाएं या फिर किसी रिट्री को मजबूर करने के लिए रन का नाम बदल दें।
3. फिर से शुरू करने के बाद ही पहुँच और परिणाम सत्यापित कर रहे हैं। प्रत्येक नए निर्धारित घटना को अपने स्वयं के रन ID दें।

- [Recurring-task धावक](https://flashdata.dev/hi/docs/guides/recurring-tasks/reference.md#slot)
- [बाद में उपयोग के लिए परिणाम सहेजें](https://flashdata.dev/hi/docs/guides/save-results/reference.md)

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

## एक MCP कार्य को पुनर्प्राप्त करें

MCP कॉल CLI रन रिकॉर्ड नहीं बनाते हैं। उस खाते के लिए मौजूदा MCP कनेक्शन का उपयोग करें जिसने नौकरी जमा की थी। इस प्रॉम्प्ट में नौकरी ID को बदलें और इसे अपने जुड़े एजेंट को भेजें।

### अपने जुड़े एजेंट में पेस्ट करें

```text
मेरी मौजूदा FlashData नौकरी को पुनर्प्राप्त करें: job_REPLACE_WITH_SAVED_ID.
वर्तमान MCP कनेक्शन का उपयोग करें। get_balance को {} के साथ एक्सेस की जांच के लिए कॉल करें,
उसके बाद इस job_id के साथ get_job.
यदि उत्तर में result_id, finish शामिल हैं, तो उसके get_result चंक्स को पढ़ना
और उन्हें JSON को पार्स करने से पहले गठबंधन करें।
job.status लंबित या प्रसंस्करण के लिए, प्रत्येक 5 सेकंड में एक ही काम पर मतदान करें
2 मिनट तक के लिए, फिर नवीनतम स्थिति और स्टॉप की रिपोर्ट करें।
पूरा करने के लिए, आउटपुट और उसके स्रोत URLs को बचाओ और इस कार्य में उपयोग करें।
एक अभिगम त्रुटि पर, असफल नौकरी या अनुपलब्ध परिणाम, बंद करो और ID की रिपोर्ट करें।
एक स्रोत उपकरण नहीं चलाते हैं, बैच जमा करते हैं, या नए क्रेडेंशियल बनाते हैं।
```

- [एक MCP होस्ट को फिर से जोड़ने](https://flashdata.dev/hi/docs/guides/agent-access/reference.md)
- [MCP उपकरण संदर्भ](https://flashdata.dev/hi/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 प्रतिक्रिया बाधित हुई थी

उसी API कुंजी के साथ बचाया result_id का उपयोग करें। पूरी प्रतिक्रिया का पुनर्निर्माण करने के लिए ऑफसेट 0 पर शुरू करें; यदि आपने पहले के हिस्से को रखा है, तो इसके बजाय उनके सटीक next_offset का उपयोग करें। इस टूल को कॉल करने से पहले प्लेसहोल्डर को बदलें।

1. प्रत्येक भाग को क्रम में कनवर्ट करें, जब तक कि यह null है तब तक next_offset का उपयोग नहीं किया जाता है। केवल पिछले हिस्से के बाद संयुक्त 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 क्लाइंट विथ चंकण हैंडलिंग](https://flashdata.dev/hi/docs/guides/mcp-custom-client/reference.md)

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

## मेरे पास कोई रन या नौकरी नहीं है ID

कार्य की सहेजी गई फ़ाइलों, एजेंट टूल इतिहास और मालिक के अनुरोध History की जाँच करें। एक request_id एक नैदानिक ID है, एक job_id नहीं है। यदि आप इस बात की पुष्टि नहीं कर सकते कि प्रस्तुतीकरण स्वीकार किया गया है, तो कार्य को रोक दें। मूल स्रोत कॉल को दोहराना एक अन्य शुल्क बना सकता है।

- [ओपन अनुरोध इतिहास](https://flashdata.dev/app/jobs)

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

## त्रुटि कोड द्वारा एक निर्धारण खोजें

| संकेत | फिक्स |
| --- | --- |
| 400 / 422 | टूल या एंडपॉइंट स्कीमा के खिलाफ तर्कों की जांच करें। CLI अनुरोधों के लिए, किसी भी नए कार्य से पहले क्वेरी --dry-run का उपयोग करें। |
| 401 / 403 | CLI के लिए, चरण 2 में पहुंच की जांच करें। MCP OAuth के लिए, मेजबान को ताज़ा करने दें; एक रद्द अनुदान को मालिक-अनुमोदित पुनर्संयोजन की आवश्यकता होती है। एक API कुंजी के साथ, मेजबान के गुप्त और स्रोत अनुमतियों की जांच करें। |
| 402 | जब तक मालिक फंडिंग को हल नहीं करता है तब तक नए काम को रोकें। |
| 406 | Accept का प्रयोग करें: application/json. समर्थित सामग्री समापन बिंदुओं के लिए, X-Respond-With के साथ Markdown का अनुरोध करें: मार्कडाउन। |
| 429 | Honor Retry-After और फिर से जमा करने से पहले किसी भी ज्ञात काम को ठीक कर देता है। वेटिंग एक असफल CLI रन रिकॉर्ड को साफ़ नहीं करता है। |
| टाइमआउट / 5xx / खोई हुई प्रतिक्रिया | मान्यता प्राप्त नौकरियों को पुनर्प्राप्त करें। अज्ञात प्रस्तुतीकरण परिणाम रोकें और History की जांच करें। |
| run_id_input_conflict | मूल इनपुट को पुनर्स्थापित करें। नया इनपुट एक जानबूझकर नया कार्य की जरूरत है और ID चलाते हैं। |
| run_account_mismatch | चरण 2 में खाता परिवर्तन चेकलिस्ट का उपयोग करें; एक नया रन ID एक रिकवरी शॉर्टकट नहीं है। |
| output_exists | एक नया आउटपुट फ़ाइल नाम चुनें। बचे हुए रन को रखें। |
| result_unavailable | MCP के लिए, ऊपर नौकरी या चंकने के चरणों की जांच करें। CLI के लिए, स्वीकृत दूरस्थ नौकरी को पुनर्प्राप्त करें। Expired परिणाम पहले निर्यात या अपने खुद के भंडारण की जरूरत है। |

- [HTTP त्रुटि संदर्भ](https://flashdata.dev/hi/docs/errors/reference.md)
- [एक MCP होस्ट को फिर से जोड़ने](https://flashdata.dev/hi/docs/guides/agent-access/reference.md)

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

## समर्थन करने के लिए एक नैदानिक भेजें

CLI के लिए, अपने कार्य द्वारा बचाया error.json पर इस jq फ़िल्टर को चलाएं। MCP, प्रतिलिपि कोड, http_status और request_id के लिए उपकरण प्रतिक्रिया से बचाया job_id या result_id. क्लाइंट संस्करण, समापन बिंदु, UTC समय को शामिल करें और क्या स्वीकृति की पुष्टि या अज्ञात है। एक्सक्लूड क्रेडेंशियल, कुकीज़ और हस्ताक्षरित 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/hi/contact)
