Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

Відновлення інтеграції агента

Відновити переривання завдання CLI або MCP за допомогою його збереженого ходу, роботи або результату ID.

На цій сторінці

Почати з ID Ви збережені

Застосувати завдання або розклад. Знайдіть свою квитанцію в папці або історії агента, після чого слідуйте за відповідними шляхами. Ці IDs не взаємозамінні.

У вас єЗареєструватися
CLI runIdЗаходи CLI нижче, з оригінальним профілем та державним каталогом.
MCP робота ID · робота_.get_job на існуючому підключенні MCP.
MCP результат ID · результат_.get_result до finish читання великої відповіді.
Запуск OpenClaw IDOpenClaw запускає історію, потім 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
Місцева перевірка · немає 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 перед тим, як вирішити, чи подати щось ще раз.
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 походження. Відновити ім'я профілю не передається, що виконується.

СитуаціяДія
Рахунок на вузькому рахункуПеревірити зовнішній вигляд, вибраний профіль і 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; використання відноситься до оригінального виконання.
  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 і зберігає чотири нові відповіді на ключ. Якщо це вибухнув або був випробований, і ви врятували роботу 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Перевірити аргументи проти інструменту або кінцевої точки схеми. Для запитів 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