เรียกดูเอกสาร
คู่มือ
ฟื้นการขัดจังหวะ CLI หรือ MCP งานที่ใช้โปรแกรมบันทึกการทํางาน, งาน หรือผลลัพธ์ ID.
ในหน้านี้
เริ่มด้วย ID ที่คุณบันทึก
หยุดงานหรือกําหนดการที่ล้มเหลว ค้นหาใบเสร็จของมันในโฟลเดอร์งานหรือประวัติตัวแทนของคุณ แล้วตามพาธที่เข้าคู่กับมัน พวกนี้ IDs ไม่สามารถสลับกันได้
| คุณมี | ใช้ |
|---|---|
| CLI runId | The CLI ด้านล่างนี้ โดยมีไดเรกทอรีโพรไฟล์ต้นฉบับและสถานะ |
| MCP งาน ID งาน. | get_job สําหรับผู้ที่หากว่าเขา (ผู้ตาย) เป็นผู้มีชีวิต MCP เชื่อมโยง |
| MCP ผล ID ผลที่ออกมา. | get_result ถึง finish การอ่านการตอบสนองอย่างมาก |
| OpenClaw ทํางาน ID | OpenClaw ประวัติการทํางาน จากนั้น FlashData ID บันทึกโดยการทํางานที่ |
1. แสดงเฉพาะหมายเลขของ CLI
เปิด Bash (Git Bash บน Windows) เป็นต้นฉบับ OS ผู้ใช้, ในโฟลเดอร์ส่งออกเสียงของทาสก์ แทนที่ค่าทั้งหมด 3 ค่าด้านล่างนี้ ด้วยข้อมูลจากงานเดิม ให้เทอร์มินัลนี้เปิดสําหรับขั้นตอน 2 ถึง 3. ยกเลิกการตั้งค่า FLASHDATA_API_KEY ให้ CLI ใช้กุญแจที่บันทึกไว้ในโพรไฟล์นี้
# 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: "${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เลือกการกระทําการกู้คืน
อ่าน 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 ถ้าบันทึกสูญหาย |
2. ตรวจสอบ CLI สิทธิ์ในการใช้งานบัญชีผู้ใช้
เช็คฟรีเหล่านี้ต้องการเข้าถึงบัญชีเดิมและ API ต้นกําเนิด ตรวจหาข้อผิดพลาดในการตรวจสอบสิทธิ์ก่อนที่จะเรียกคืนผล
: "${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ตรวจสอบช่องข้อมูลเหล่านี้
ความ สมดุล ที่ ไม่ มี ใด เหมือน เป็น ประเด็น เรื่อง การ หา ทุน สําหรับ งาน ใหม่. มันไม่ได้หมายความว่ากุญแจนั้นใช้งานไม่ได้
| auth status ช่องข้อมูล | คาดหวัง |
|---|---|
| data.accessVerified | true; มิฉะนั้นจะแก้ไขสิทธิ์ในการอ่านได้ |
| data.identity.identity.accountId | บัญชีที่มอบหมายงาน |
| data.identity.permittedSources | รวมแหล่งที่ถูกใช้โดยทาสก์ที่บันทึกไว้ด้วย |
| data.identity.identity.recurringAllowed | true ก่อนทําการเกิดขึ้นอีกทาสก์ |
บัญชีเปลี่ยนไป หรือเพิ่งผูกสิทธิ์ทดลองใช้กับบัญชี
run_account_mismatch หมายความว่าการทํางานแบบบันทึกเป็นบัญชีอื่น หรือ API ต้นกําเนิด การเปลี่ยนชื่อโพรไฟล์ไม่ได้ทําการโอนไปยังที่ทํางานอยู่
| สถานการณ์ | การกระทํา |
|---|---|
| บัญชีผู้ใช้ไม่ถูกต้อง | โปรดตรวจสอบส่วนoverride ของปุ่มแวดล้อม, โพรไฟล์ที่เลือกไว้ และ management/data ต้นกําเนิด เรียกคืนบัญชีที่ตั้งใจไว้ก่อนที่จะฟื้นตัว |
| หมุนคีย์ | ใช้กุญแจที่ใช้แทนที่บัญชีผู้ใช้เดียวกันนี้ โดยมีการอนุญาตจากแหล่งต่าง ๆ คงโพรไฟล์เดิม, ไดเร็กทอรีสถานะไว้ และทํางาน ID. |
| การ พิจารณา คดี ที่ อ้าง ว่า เป็น | บัญชี เจ้าของ ต่าง จาก บัญชี ชั่ว คราว. อ่านผลลัพธ์การทดสอบที่คุณส่งออกไปเรียบร้อยแล้ว ใช้การประมวลผลใหม่ ID สําหรับงานของเจ้าของใหม่เท่านั้น มันใช้ความสมดุลของเจ้าของ |
ทําการเรียกร้องที่ขัดใจต่อไป
สําหรับคําอ้างที่ได้รับอนุญาตทํางาน auth finish ในโพรไฟล์เดิมภายใน 24- หน้าต่างห้องออก มันบันทึกและตรวจสอบกุญแจเจ้าของ แล้วยอมรับการติดตั้ง คําสั่งที่สองการตรวจสอบการเข้าใช้ที่บันทึกไว้ในโพรเซสใหม่
: "${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-interactive3. กู้ผล CLI ใหม่
เลือกสถานะที่ถูกบันทึกจาก 1 ใช้ชื่อแฟ้มผลลัพธ์ที่ยังไม่มีอยู่ คําสั่งทั้งสองตัวตรวจสอบสิทธิ์และเก็บค่าเดิมที่ประมวลผลได้ และไม่มีการส่งคําค้นแทน
: "${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การลงคะแนนหยุดการรอคอยท้องถิ่น ประมวลผลคําสั่งการกู้คืนนี้อีกครั้งเพื่อให้ยังคงรอการทํางานเดียวกัน
: "${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ยืนยันการฟื้นตัวก่อนที่จะทําการเรียกคืนข้อมูล
- ตรวจสอบว่ารหัสออกเป็น 0 และ ok: true จากนั้นเปิด recovered.json การส่งออกผลลัพธ์ที่บันทึกไว้จะมี cached: true โดย usage อ้างอิงการประมวลผลครั้งเดิม
- เก็บบัญชี, โพรไฟล์, รัฐและการทํางานเดียวกัน ID เมื่อพยายามกลับค่าการเกิดขึ้นอีก ไม่ต้องลบบันทึกประจําวันหรือเปลี่ยนชื่อการประมวลผลเพื่อบังคับให้ทําอีกครั้ง
- ดําเนินการต่อไป หลังจากเข้าถึง และผลการตรวจสอบแล้ว ให้แต่ละตารางการทํางานของมันเอง ID.
กู้ MCP งาน
MCP การเรียกไม่ได้สร้าง CLI ตรวจประวัติ ใช้รายการที่มีอยู่แล้ว MCP การเชื่อมต่อสําหรับบัญชีผู้ใช้ที่ส่งงานไป แทนที่งาน ID ในการกระตุ้นนี้ และส่งมันไปยังตัวแทนที่เกี่ยวข้องของคุณ
ฟื้นตัวของฉันที่มีอยู่ 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 ลูกความ, ส่งวัตถุนี้ไปที่ callTool หลังการแทนที่ job_id. นี่คือเครื่องมือเรียก ไม่ใช่คําสั่งเชลล์ get_job ตรวจสอบสิทธิ์ที่อนุญาตของบัญชีผู้ใช้และแหล่งงาน; สําเร็จ get_balance การตรวจสอบเพียงอย่างเดียวไม่ได้พิสูจน์ว่าเข้าถึงงานนี้ได้
{
"name": "get_job",
"arguments": {
"job_id": "job_REPLACE_WITH_SAVED_ID"
}
}เช็คดูสิ MCP สถานะงาน
| คำตอบ | การกระทําถัดไป |
|---|---|
| job.status: pending / processing | เดี๋ยว, แล้วอ่านงานเดิม ID เวลาหมดเวลาภายในเครื่องไม่ได้ยกเลิก |
| job.status: completed | บันทึกการแสดงผล การใช้งานของมันเป็นของคําค้นดั้งเดิม get_job ไม่ส่งหรือคิดค่าใช้จ่ายสําหรับการสอบถามใหม่ |
| job.status: failed / isError: true | อ่านข้อผิดพลาดก่อนจะทําการส่งออก อย่าเรียกแหล่งใหม่โดยอัตโนมัติ |
| code: result_unavailable | ลองอ่านใหม่ สําหรับความล้มเหลวชั่วคราว ถ้าผลที่ได้บันทึกไว้หมดอายุ ให้ใช้การส่งออกก่อนหน้านี้ Async JSON ผลตรวจยังคงใช้ได้ 24 ชั่วโมง |
ใหญ่ MCP การตอบรับถูกขัดจังหวะ
ใช้ที่บันทึกไว้ result_id เหมือนกัน API กุญแจ เริ่มที่ออฟเซ็ต 0 เพื่อสร้างการตอบสนองทั้งหมด; ถ้าคุณเก็บชิ้นก่อนหน้านี้ใช้ที่แน่นอนของพวกเขา next_offset แทน แทนที่ตัวแทนที่ของสถานที่ ก่อนที่จะเรียกเครื่องมือนี้
- เพิ่มท่อนแต่ละช่องให้เรียงตามลําดับโดยใช้ next_offset จนกว่ามันจะเป็น null. จัดเรียง JSON รวมกันหลังจากชิ้นสุดท้ายเท่านั้น
- แคชคงทน 10 นาทีและเก็บการตอบรับใหม่ 4 ครั้งต่อคีย์ ถ้ามันหมดอายุหรือถูกไล่ออก และคุณรักษางานไว้ได้ IDเรียก get_job อ่านอีกครั้งและอ่านชิ้นใหม่
- การตอบรับแบบเรียลไทม์ ไม่มีการรับประกันงานเบื้องหลังที่กู้ได้ โดยไม่ต้องมีงานที่บันทึกไว้ ID ตรวจสอบหรือส่งออก History และถามก่อนที่จะทําการค้นหารายใหม่
{
"name": "get_result",
"arguments": {
"result_id": "REPLACE_WITH_RESULT_ID",
"offset": 0
}
}ผมไม่มีการทํางานหรืองาน ID
ตรวจสอบแฟ้มของทาสก์ที่บันทึกไว้, ประวัติเครื่องมือตัวแทน และการร้องขอของเจ้าของ History A request_id คือการวินิจฉัย IDไม่ใช่ job_id. หากคุณไม่สามารถยืนยันได้ว่ามีการยอมรับหรือไม่ ให้หยุดงานไว้ก่อน การโทรซ้ําสายต้นฉบับ สามารถเรียกค่าบริการได้
ค้นหาแก้ไขโดยใช้รหัสผิดพลาด
| สัญญาณ | แก้ไข |
|---|---|
| 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 คืนตําแหน่งงานระยะไกลที่ได้รับการยอมรับคืน ผลการหมดอายุต้องการการส่งออกก่อนหน้านี้ หรือส่วนจัดเก็บของคุณ |
ส่งการวินิจฉัยไปสนับสนุน
สําหรับ CLIวิ่งสิ jq กรองบน error.json บันทึกไว้โดยงานของคุณ สําหรับ MCPก๊อปปี้โค้ด http_status ถึง request_id จากการตอบสนองเครื่องมือ, บวกบันทึก job_id หรือ result_id. รวมรุ่นของไคลเอนต์, จุดปลาย, เวลา UTC และการยอมรับที่ได้รับการยืนยันหรือไม่รู้จัก Usclude access, คุกกี้และลงนาม URLs
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json