ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

คู่มือ

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

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

ในหน้านี้

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

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

คุณมีใช้
CLI runIdThe CLI ด้านล่างนี้ โดยมีไดเรกทอรีโพรไฟล์ต้นฉบับและสถานะ
MCP งาน ID งาน.get_job สําหรับผู้ที่หากว่าเขา (ผู้ตาย) เป็นผู้มีชีวิต MCP เชื่อมโยง
MCP ผล ID ผลที่ออกมา.get_result ถึง finish การอ่านการตอบสนองอย่างมาก
OpenClaw ทํางาน IDOpenClaw ประวัติการทํางาน จากนั้น 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
ตรวจสอบภายในไม่ API เรียก
: "${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 ในบันทึกการทํางาน

สถานะบันทึกวิธีแก้ไข
succeededCheck 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.accessVerifiedtrue; มิฉะนั้นจะแก้ไขสิทธิ์ในการอ่านได้
data.identity.identity.accountIdบัญชีที่มอบหมายงาน
data.identity.permittedSourcesรวมแหล่งที่ถูกใช้โดยทาสก์ที่บันทึกไว้ด้วย
data.identity.identity.recurringAllowedtrue ก่อนทําการเกิดขึ้นอีกทาสก์

บัญชีเปลี่ยนไป หรือเพิ่งผูกสิทธิ์ทดลองใช้กับบัญชี

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

3. กู้ผล 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

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

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

get_job
{
  "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 แทน แทนที่ตัวแทนที่ของสถานที่ ก่อนที่จะเรียกเครื่องมือนี้

  1. เพิ่มท่อนแต่ละช่องให้เรียงตามลําดับโดยใช้ next_offset จนกว่ามันจะเป็น null. จัดเรียง JSON รวมกันหลังจากชิ้นสุดท้ายเท่านั้น
  2. แคชคงทน 10 นาทีและเก็บการตอบรับใหม่ 4 ครั้งต่อคีย์ ถ้ามันหมดอายุหรือถูกไล่ออก และคุณรักษางานไว้ได้ IDเรียก get_job อ่านอีกครั้งและอ่านชิ้นใหม่
  3. การตอบรับแบบเรียลไทม์ ไม่มีการรับประกันงานเบื้องหลังที่กู้ได้ โดยไม่ต้องมีงานที่บันทึกไว้ ID ตรวจสอบหรือส่งออก History และถามก่อนที่จะทําการค้นหารายใหม่
get_result
{
  "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