본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

가이드

에이전트 통합을 복구

저장된 실행, 작업 또는 결과 ID를 사용하여 중단 된 CLI 또는 MCP 작업을 복구합니다.

이 페이지의 내용

저장되는 ID로 시작하십시오

실패 작업 또는 일정을 일시 중지합니다. 작업 폴더 또는 에이전트 역사에서 영수증을 찾아, 그 후 일치 경로를 따르십시오. 이 IDs는 교환할 수 없습니다.

당신은있다제품 정보
CLI runId아래 CLI 단계는 원본 프로파일과 state 디렉토리와 함께합니다.
MCP 작업 ID · 작업_.기존 MCP 연결에 get_job.
MCP 결과 ID · 결과 _ .get_result에 finish는 큰 응답을 읽습니다.
OpenClaw 실행 IDOpenClaw는 역사를 실행하고, 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
현지 검사 · 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를 읽으십시오.

기록된 상태해결 방법
succeeded액세스 확인, 다음 단계 3에 저장된 결과를 수출.
accepted액세스 확인, 다음 단계 3에서 허용 된 작업을 복구.
uncertain / intent작업 일시 중지. remoteId, candidateRemoteIds 및 History를 체크하여 다시 제출할 수 있습니다.
failederrorCode를 먼저 수정합니다. 실패한 기록은 유지됩니다; 보충은 새로운 작업이고 신용을 사용할 수 있습니다.
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.accessVerifiedtrue; 그렇지 않으면 결과를 읽기 전에 액세스 수정.
data.identity.identity.accountId작업에 제출 된 계정.
data.identity.permittedSources저장된 작업에 의해 사용 된 소스를 포함합니다.
data.identity.identity.recurringAllowedtrue는 재발급 업무를 재발급하기 전에.

계정 변경, 또는 나는 단지 체험을 주장

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

resuming의 앞에 회복을 확인하십시오

  1. 종료 코드 0 및 ok: true를 확인한 다음 recovered.json를 엽니다. Saved-result 수출에는 cached: true가 있습니다; 사용법은 본래 실행을 나타납니다.
  2. 동일한 계정을 유지, 프로필, 상태 및 실행 ID 이 발생을 재발 할 때. 저널을 삭제하거나 재발력을 강제로 이름을 변경하지 마십시오.
  3. 액세스 후만 예약을 재개하고 결과가 확인됩니다. 각각의 새로운 예정된 발생을 자신의 실행 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 검사는 혼자이 작업에 액세스하지 않습니다.

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 응답은 중단되었습니다

동일한 API 열쇠를 가진 저장된 result_id를 사용하십시오. 상쇄 0에서 전체 응답을 다시 시작하십시오. 이전 펑크를 유지하면 대신 정확한 next_offset를 사용하십시오. 이 도구를 호출하기 전에 placeholder를 대체합니다.

  1. next_offset를 사용하여 주문에 각 펑크를 승인하면 null입니다. 마지막 펑크 후 JSON를 결합합니다.
  2. 캐시는 10 분을 지속하고 열쇠 당 4개의 가장 새로운 큰 응답을 지킵니다. 만료되거나 evicted 되었거나 ID를 저장하면 get_job를 다시 호출하고 새로운 펑크를 읽습니다.
  3. 실시간 응답은 보장된 회복 가능한 배경 일을 없습니다. 저장된 일 없이 ID 또는 수출은, History를 검사하고 새로운 지불한 조회를 달리기 전에 요구합니다.
get_result
{
  "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 / 403CLI의 경우, 단계 2에 액세스할 수 있습니다. MCP OAuth의 경우 호스트가 새로워집니다. 재조합된 보조금은 소유자 승인 재연결을 필요로 합니다. API 키로 호스트의 비밀과 소스 권한을 확인합니다.
402소유자가 기금을 해결 할 때까지 새로운 작업을 중지합니다.
406Accept를 사용하십시오: application/json. 지원되는 내용 엔드포인트를 위해, X-Respond-With를 가진 Markdown를 요구하십시오: 감쇠.
429Honor Retry-After와 다시 제출하기 전에 알려진 작업을 복구합니다. 대기는 실패한 CLI 런 레코드를 삭제하지 않습니다.
Timeout / 5xx / 손실 응답Recover known 받아들여진 작업. 알 수없는 제출 결과를 일시 중지하고 History를 확인하십시오.
run_id_input_conflict원래 입력을 복원합니다. 새로운 입력은 새로운 작업을 정의하고 ID를 실행해야합니다.
run_account_mismatch단계 2의 계정 교환 체크리스트를 사용하십시오. 새로운 실행 ID는 복구 단축키가 아닙니다.
output_exists새로운 출력 파일명 선택. 저장된 실행을 유지하십시오.
result_unavailableMCP의 경우, 위의 작업 또는 펑크 단계를 확인하십시오. 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