Переглянути документацію
Посібники
Відновити переривання завдання CLI або MCP за допомогою його збереженого ходу, роботи або результату ID.
На цій сторінці
Почати з ID Ви збережені
Застосувати завдання або розклад. Знайдіть свою квитанцію в папці або історії агента, після чого слідуйте за відповідними шляхами. Ці IDs не взаємозамінні.
| У вас є | Зареєструватися |
|---|---|
| CLI runId | Заходи CLI нижче, з оригінальним профілем та державним каталогом. |
| MCP робота ID · робота_. | get_job на існуючому підключенні MCP. |
| MCP результат ID · результат_. | get_result до finish читання великої відповіді. |
| Запуск OpenClaw ID | OpenClaw запускає історію, потім FlashData ID записаний цим ходом. |
1. Огляд забігу CLI
Відкрити Bash (Git Bash на Windows) як оригінальний користувач OS, у вашій папці вихідного завдання. Замініть всі три значення нижче з тих, хто з оригінального завдання. Зберігайте цей термінал відкритим для кроків 2 і 3. Unsetting 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. A 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