Перейти к содержимому
RU
Ключ API
Обзор документации

Руководства

Восстановление агентной интеграции

Восстановление прерванной задачи CLI или MCP с помощью сохраненного выполнения, задания или результата ID.

На этой странице

Начните с ID, который вы сохранили

Приостановите невыполнимую задачу или график. Найдите его квитанцию в папке задач или истории агентов, а затем следуйте по пути соответствия. IDs не является взаимозаменяемым.

У тебя естьИспользовать
CLI runIdШаги CLI ниже, с оригинальным профилем и каталогом состояния.
MCP Работа ID · Работаget_job на существующем соединении MCP.
ID результата MCP · result_…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, прежде чем принимать решение о повторной отправке.
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. 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