# กู้คืนการเชื่อมต่อเอเจนต์

ฟื้นการขัดจังหวะ CLI หรือ MCP งานที่ใช้โปรแกรมบันทึกการทํางาน, งาน หรือผลลัพธ์ ID.

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/agent-recovery
Recorder: 2026-11-05 โดย FlashData

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

## เริ่มด้วย ID ที่คุณบันทึก

หยุดงานหรือกําหนดการที่ล้มเหลว ค้นหาใบเสร็จของมันในโฟลเดอร์งานหรือประวัติตัวแทนของคุณ แล้วตามพาธที่เข้าคู่กับมัน พวกนี้ IDs ไม่สามารถสลับกันได้

| คุณมี | ใช้ |
| --- | --- |
| CLI runId | The CLI ด้านล่างนี้ โดยมีไดเรกทอรีโพรไฟล์ต้นฉบับและสถานะ |
| MCP งาน ID งาน. | get_job สําหรับผู้ที่หากว่าเขา (ผู้ตาย) เป็นผู้มีชีวิต MCP เชื่อมโยง |
| MCP ผล ID ผลที่ออกมา. | get_result ถึง finish การอ่านการตอบสนองอย่างมาก |
| OpenClaw ทํางาน ID | OpenClaw ประวัติการทํางาน จากนั้น FlashData ID บันทึกโดยการทํางานที่ |

- [CLI ฟื้น](https://flashdata.dev/th/docs/guides/agent-recovery/reference.md#inspect)
- [MCP ฟื้น](https://flashdata.dev/th/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw ประวัติการทํางาน](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. แสดงเฉพาะหมายเลขของ CLI

เปิด Bash (Git Bash บน Windows) เป็นต้นฉบับ OS ผู้ใช้, ในโฟลเดอร์ส่งออกเสียงของทาสก์ แทนที่ค่าทั้งหมด 3 ค่าด้านล่างนี้ ด้วยข้อมูลจากงานเดิม ให้เทอร์มินัลนี้เปิดสําหรับขั้นตอน 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 ถึง data.errorCode ในบันทึกการทํางาน

| สถานะบันทึก | วิธีแก้ไข |
| --- | --- |
| succeeded | Check access, แล้วส่งออกผลที่ได้จากการบันทึกเป็นขั้นตอน 3. |
| accepted | ตรวจสอบสิทธิ์ จากนั้นก็เรียกงานที่ได้รับกลับมาในขั้นตอน 3 |
| uncertain / intent | ให้งานหยุดชั่วคราว ตรวจสอบ remoteId, candidateRemoteIds ถึง History ก่อนที่จะตัดสินใจว่าจะส่งอะไรอีกครั้ง |
| failed | แก้ไข errorCode ก่อน มีการบันทึกล้มเหลว; การแทนที่คืองานใหม่และสามารถใช้เครดิตได้ |
| partial | เก็บค่าผลลัพธ์ที่ใช้ได้ เรียกคืนงานพิมพ์ที่รู้จัก; สําหรับงานจํานวนมาก ให้ตรวจสอบแต่ละแถวก่อนที่จะแทนที่รายการที่ล้มเหลว |
| run_not_found | เช็คประวัติ OS ผู้ใช้และไดเร็กทอรีของรัฐ หาใบเสร็จที่บันทึกไว้ หรือ History ถ้าบันทึกสูญหาย |

- [เปิดประวัติการร้องขอ](https://flashdata.dev/app/jobs)
- [เรียกคืนผลจํานวนมาก](https://flashdata.dev/th/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 ต้นกําเนิด การเปลี่ยนชื่อโพรไฟล์ไม่ได้ทําการโอนไปยังที่ทํางานอยู่

| สถานการณ์ | การกระทํา |
| --- | --- |
| บัญชีผู้ใช้ไม่ถูกต้อง | โปรดตรวจสอบส่วนoverride ของปุ่มแวดล้อม, โพรไฟล์ที่เลือกไว้ และ management/data ต้นกําเนิด เรียกคืนบัญชีที่ตั้งใจไว้ก่อนที่จะฟื้นตัว |
| หมุนคีย์ | ใช้กุญแจที่ใช้แทนที่บัญชีผู้ใช้เดียวกันนี้ โดยมีการอนุญาตจากแหล่งต่าง ๆ คงโพรไฟล์เดิม, ไดเร็กทอรีสถานะไว้ และทํางาน ID. |
| การ พิจารณา คดี ที่ อ้าง ว่า เป็น | บัญชี เจ้าของ ต่าง จาก บัญชี ชั่ว คราว. อ่านผลลัพธ์การทดสอบที่คุณส่งออกไปเรียบร้อยแล้ว ใช้การประมวลผลใหม่ ID สําหรับงานของเจ้าของใหม่เท่านั้น มันใช้ความสมดุลของเจ้าของ |

- [แทนที่กุญแจเจ้าของ](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [ทดลองใช้และเชื่อมโยงบัญชี](https://flashdata.dev/th/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
```

- [การแจ้งสิทธิ์หมดอายุหรือถูกปฏิเสธการลงทะเบียน](https://flashdata.dev/th/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/th/docs/guides/async-batch/reference.md#job-status)

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

### ยืนยันการฟื้นตัวก่อนที่จะทําการเรียกคืนข้อมูล

1. ตรวจสอบว่ารหัสออกเป็น 0 และ ok: true จากนั้นเปิด recovered.json การส่งออกผลลัพธ์ที่บันทึกไว้จะมี cached: true โดย usage อ้างอิงการประมวลผลครั้งเดิม
2. เก็บบัญชี, โพรไฟล์, รัฐและการทํางานเดียวกัน ID เมื่อพยายามกลับค่าการเกิดขึ้นอีก ไม่ต้องลบบันทึกประจําวันหรือเปลี่ยนชื่อการประมวลผลเพื่อบังคับให้ทําอีกครั้ง
3. ดําเนินการต่อไป หลังจากเข้าถึง และผลการตรวจสอบแล้ว ให้แต่ละตารางการทํางานของมันเอง ID.

- [เริ่มทํางานใหม่](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md#slot)
- [บันทึกผลสําหรับใช้ในภายหลัง](https://flashdata.dev/th/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 ด้วย {} เพื่อตรวจสอบความเข้าถึง
งั้น get_job ด้วยสิ่งนี้ job_id.
ถ้าคําตอบมี result_id, finish อ่านมัน get_result ก้อน
และรวมมันเข้าด้วยกัน ก่อนที่จะเรียง JSON
สําหรับ job.status อยู่ระหว่างดําเนินการ หรือการประมวลผล โพลงานเดียวกันทุก 5 วินาที
สําหรับถึง 2 นาที แล้วรายงานสถานะล่าสุดและหยุด
สําหรับการแสดงผลเรียบร้อยแล้ว, จัดเก็บผลลัพธ์และแหล่งของมัน URLs และใช้ในงานนี้
เมื่อมีข้อผิดพลาดในการเข้าใช้งาน, งานล้มเหลว หรือผลที่ไม่สามารถทํางานได้ ให้หยุดและรายงาน ID
ไม่ต้องประมวลผลเครื่องมือต้นทาง, หรือสร้างเอกสารกํากับใหม่
```

- [เชื่อมต่อ MCP โฮสต์](https://flashdata.dev/th/docs/guides/agent-access/reference.md)
- [MCP อ้างอิงเครื่องมือ](https://flashdata.dev/th/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 นาทีและเก็บการตอบรับใหม่ 4 ครั้งต่อคีย์ ถ้ามันหมดอายุหรือถูกไล่ออก และคุณรักษางานไว้ได้ 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/th/docs/guides/mcp-custom-client/reference.md)

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

## ผมไม่มีการทํางานหรืองาน ID

ตรวจสอบแฟ้มของทาสก์ที่บันทึกไว้, ประวัติเครื่องมือตัวแทน และการร้องขอของเจ้าของ History A request_id คือการวินิจฉัย IDไม่ใช่ job_id. หากคุณไม่สามารถยืนยันได้ว่ามีการยอมรับหรือไม่ ให้หยุดงานไว้ก่อน การโทรซ้ําสายต้นฉบับ สามารถเรียกค่าบริการได้

- [เปิดประวัติการร้องขอ](https://flashdata.dev/app/jobs)

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

## ค้นหาแก้ไขโดยใช้รหัสผิดพลาด

| สัญญาณ | แก้ไข |
| --- | --- |
| 400 / 422 | ตรวจสอบการโต้แย้งกับเครื่องมือหรือจุดปลาย Sheema สําหรับ CLI ร้องขอ, ใช้คําค้น --dry-run ก่อนที่จะมีภารกิจใหม่ |
| 401 / 403 | สําหรับ CLIเช็กความเข้าในขั้นตอน 2. สําหรับ MCP OAuthให้โฮสต์รีเฟรช การให้ทุนยกเลิกต้องการการติดต่อเจ้าของใหม่ ด้วย API กุญแจ, ตรวจดูเคล็ดลับและสิทธิ์ที่อนุญาตของโฮสต์ |
| 402 | หยุดการทํางานใหม่จนกว่าเจ้าของจะแก้ไขเงินทุน |
| 406 | ใช้ Accept: application/json. สําหรับค่าปลายบรรทัดที่รองรับ Markdown ด้วย X-Respond-Withนับถอยหลัง |
| 429 | เกียรติ Retry-After และเรียกงานใด ๆ ที่รู้จักกันก่อนการส่งข้อมูลอีกครั้ง การรอยังไม่เป็นการล้างความล้มเหลว CLI ตรวจสอบประวัติ |
| หมดเวลา / 5xx / ถูกปฏิเสธการตอบสนอง | การซ่อมแซมงานที่ได้รับการยอมรับ เก็บผลลัพธ์การส่งข้อมูลที่ไม่รู้จักไว้หยุดชั่วคราวและตรวจสอบ History. |
| run_id_input_conflict | เรียกคืนค่านําเข้าดั้งเดิม การป้อนข้อมูลใหม่ต้องการทาสก์ตัวใหม่แล้วทํางาน ID. |
| run_account_mismatch | ใช้รายการที่เปลี่ยนแปลงบัญชีผู้ใช้ในขั้นตอน 2สืบค้นใหม่ ID ไม่ใช่ทางลัดที่กู้กลับมาได้ |
| output_exists | เลือกชื่อแฟ้มส่งออกใหม่ เก็บบันทึกการทํางาน. |
| result_unavailable | สําหรับ MCP. ตรวจดูงานหรือชิ้นเนื้อบน. สําหรับ CLI คืนตําแหน่งงานระยะไกลที่ได้รับการยอมรับคืน ผลการหมดอายุต้องการการส่งออกก่อนหน้านี้ หรือส่วนจัดเก็บของคุณ |

- [HTTP การอ้างอิงผิดพลาด](https://flashdata.dev/th/docs/errors/reference.md)
- [เชื่อมต่อ MCP โฮสต์](https://flashdata.dev/th/docs/guides/agent-access/reference.md)

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

## ส่งการวินิจฉัยไปสนับสนุน

สําหรับ CLIวิ่งสิ jq กรองบน error.json บันทึกไว้โดยงานของคุณ สําหรับ MCPก๊อปปี้โค้ด http_status ถึง request_id จากการตอบสนองเครื่องมือ, บวกบันทึก job_id หรือ result_id. รวมรุ่นของไคลเอนต์, จุดปลาย, เวลา UTC และการยอมรับที่ได้รับการยืนยันหรือไม่รู้จัก Usclude access, คุกกี้และลงนาม 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/th/contact)
