Обзор документации
Руководства
Восстановление прерванной задачи CLI или MCP с помощью сохраненного выполнения, задания или результата ID.
На этой странице
Начните с ID, который вы сохранили
Приостановите невыполнимую задачу или график. Найдите его квитанцию в папке задач или истории агентов, а затем следуйте по пути соответствия. IDs не является взаимозаменяемым.
| У тебя есть | Использовать |
|---|---|
| CLI runId | Шаги CLI ниже, с оригинальным профилем и каталогом состояния. |
| MCP Работа ID · Работа | get_job на существующем соединении MCP. |
| ID результата MCP · result_… | 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Проверьте эти поля
Нулевой баланс – это вопрос финансирования новой работы. Это не означает, что ключ недействителен.
| поле 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-час. Он сохраняет и проверяет ключ владельца, а затем подтверждает установку. Вторая команда проверяет сохраненный доступ в новом процессе.
: "${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; использование относится к первоначальному исполнению.
- Сохраняйте одну и ту же учетную запись, профиль, состояние и запустите 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 минуты и сохраняет четыре самых новых больших ответа на ключ. Если он истек или был выселен, и вы сохранили работу 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. Для поддерживаемых конечных точек контента запрашивайте 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 и подтверждено ли принятие или неизвестно. Исключите учетные данные, файлы cookie и подписанные URLs.
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
code, httpStatus, retryAfter, runId, remoteId
})}' error.json