문서 둘러보기
가이드
저장된 실행, 작업 또는 결과 ID를 사용하여 중단 된 CLI 또는 MCP 작업을 복구합니다.
이 페이지의 내용
저장되는 ID로 시작하십시오
실패 작업 또는 일정을 일시 중지합니다. 작업 폴더 또는 에이전트 역사에서 영수증을 찾아, 그 후 일치 경로를 따르십시오. 이 IDs는 교환할 수 없습니다.
| 당신은있다 | 제품 정보 |
|---|---|
| CLI runId | 아래 CLI 단계는 원본 프로파일과 state 디렉토리와 함께합니다. |
| MCP 작업 ID · 작업_. | 기존 MCP 연결에 get_job. |
| MCP 결과 ID · 결과 _ . | get_result에 finish는 큰 응답을 읽습니다. |
| OpenClaw 실행 ID | OpenClaw는 역사를 실행하고, FlashData ID는 그 실행에 의해 기록됩니다. |
1. CLI 실행 검사
Bash (Git Bash Windows)를 OS 사용자로, 작업의 출력 폴더에 엽니다. 원래 작업에서 그들과 함께 모든 세 값을 대체합니다. 이 맨끝을 단계 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 | 액세스 확인, 다음 단계 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이 필드를 확인
0 잔액은 새로운 일에 대한 자금 조달 문제입니다. 키가 무효하다는 것을 의미하지 않습니다.
| auth status 필드 | 예상 결과 |
|---|---|
| data.accessVerified | true; 그렇지 않으면 결과를 읽기 전에 액세스 수정. |
| data.identity.identity.accountId | 작업에 제출 된 계정. |
| data.identity.permittedSources | 저장된 작업에 의해 사용 된 소스를 포함합니다. |
| data.identity.identity.recurringAllowed | true는 재발급 업무를 재발급하기 전에. |
계정 변경, 또는 나는 단지 체험을 주장
run_account_mismatch는 저장된 실행이 다른 계정 또는 API 근원에 속한다는 것을 의미합니다. 프로필 이름을 재사용하지 않는 전송을 실행합니다.
| - 연혁 | 조치 |
|---|---|
| 잘못된 계정 | 환경 키 오버라이드, 선택된 프로필 및 management/data 원산지를 확인하십시오. 복구하기 전에 예정된 계정을 복원합니다. |
| 키가 회전 | 필요한 소스 권한과 동일한 계정의 교체 키를 사용합니다. 원래 프로필을 유지, 상태 디렉토리 및 실행 ID. |
| 학회소개 | 소유자 계정은 임시 계정과 다릅니다. 이미 수출된 시험 산출을 읽으십시오. 새로운 실행 ID는 의도 된 새로운 소유자 작업에만; 그것은 소유자의 균형을 사용합니다. |
중단된 청구를 재량
승인 된 청구를 위해 auth finish를 24-hour handoff 창 내의 원래 프로필에서 실행하십시오. 그것은 소유자 키를 저장하고, 그 후에 임명을 인정합니다. 두 번째 명령은 새 프로세스에서 저장된 액세스를 확인합니다.
: "${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-interactiveresuming의 앞에 회복을 확인하십시오
- 종료 코드 0 및 ok: true를 확인한 다음 recovered.json를 엽니다. Saved-result 수출에는 cached: true가 있습니다; 사용법은 본래 실행을 나타납니다.
- 동일한 계정을 유지, 프로필, 상태 및 실행 ID 이 발생을 재발 할 때. 저널을 삭제하거나 재발력을 강제로 이름을 변경하지 마십시오.
- 액세스 후만 예약을 재개하고 결과가 확인됩니다. 각각의 새로운 예정된 발생을 자신의 실행 ID.
MCP 작업을 복구
MCP 통화는 CLI 런 레코드를 만들지 않습니다. 기존 MCP 연결을 사용하여 작업을 제출했습니다. 이 프롬프트에서 작업 ID를 교체하고 연결 에이전트에 보냅니다.
기존 FlashData 작업을 복구하세요: job_REPLACE_WITH_SAVED_ID.
현재 MCP 연결을 사용하세요. get_balance에 {}를 전달하여 접근 권한을 확인한 뒤,
이 job_id로 get_job을 호출하세요.
응답에 result_id가 있으면 get_result의 모든 조각을 읽고
결합한 다음 JSON을 파싱하세요.
job.status가 pending 또는 processing이면 같은 작업을 5초마다 조회하세요.
최대 2분 후 최신 상태를 보고하고 중지하세요.
completed이면 이 작업의 결과, 출처 URL 및 사용량을 저장하세요.
접근 오류, 작업 실패 또는 결과를 사용할 수 없는 경우 중지하고 ID를 보고하세요.
소스 도구 실행, 배치 제출 또는 새 인증 정보 생성은 하지 마세요.원래 일을 읽으십시오
MCP 클라이언트를 위해, job_id를 대체한 후에 callTool에 이 목표를 통과하십시오. 이것은 쉘 명령이 아닌 도구 호출입니다. 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 응답은 중단되었습니다
동일한 API 열쇠를 가진 저장된 result_id를 사용하십시오. 상쇄 0에서 전체 응답을 다시 시작하십시오. 이전 펑크를 유지하면 대신 정확한 next_offset를 사용하십시오. 이 도구를 호출하기 전에 placeholder를 대체합니다.
- next_offset를 사용하여 주문에 각 펑크를 승인하면 null입니다. 마지막 펑크 후 JSON를 결합합니다.
- 캐시는 10 분을 지속하고 열쇠 당 4개의 가장 새로운 큰 응답을 지킵니다. 만료되거나 evicted 되었거나 ID를 저장하면 get_job를 다시 호출하고 새로운 펑크를 읽습니다.
- 실시간 응답은 보장된 회복 가능한 배경 일을 없습니다. 저장된 일 없이 ID 또는 수출은, History를 검사하고 새로운 지불한 조회를 달리기 전에 요구합니다.
{
"name": "get_result",
"arguments": {
"result_id": "REPLACE_WITH_RESULT_ID",
"offset": 0
}
}나는 달리거나 일 ID가 없습니다
작업의 저장된 파일, 에이전트 도구 역사 및 소유자의 요청 History. ₢ 킹 request_id 진단 ID, 아니 job_id. 제출이 허용된지 확인할 수 없는 경우, 작업이 일시적으로 유지됩니다. 원본 소스 통화를 반복하면 다른 충전을 만들 수 있습니다.
오류 코드로 수정하기
| (주) | 해결 |
|---|---|
| 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 런 레코드를 삭제하지 않습니다. |
| Timeout / 5xx / 손실 응답 | Recover known 받아들여진 작업. 알 수없는 제출 결과를 일시 중지하고 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 시간을 포함하고 수락이 확인되거나 알 수 없는지 여부. 자격 증명, 쿠키 및 서명 URLs 제외.
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json