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

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

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/agent-recovery
Разработчик: 2026-11-05 by FlashData

<a id="start"></a>

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

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

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

- [Восстановление CLI](https://flashdata.dev/ru/docs/guides/agent-recovery/reference.md#inspect)
- [Восстановление MCP](https://flashdata.dev/ru/docs/guides/agent-recovery/reference.md#mcp)
- [OpenClaw История](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md#inspect-test)

<a id="inspect"></a>

## 1. Проверить запуск CLI

Откройте Bash (Git Bash на Windows) в качестве исходного пользователя OS, в папке вывода задачи. Замените все три значения ниже на те, которые были получены при выполнении первоначальной задачи. Держите этот терминал открытым для шагов 2 и 3. Отключение FLASHDATA_API_KEY позволяет CLI использовать ключ, сохраненный в этом профиле.

### Выберите существующую задачу - этот терминал

```bash
# 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

```bash
: "${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
```


<a id="run-status"></a>

### Выберите действия по восстановлению

Прочитайте data.status, data.remoteId и data.errorCode в записи пробега.

| Записанный статус | Что делать |
| --- | --- |
| succeeded | Проверьте доступ, затем экспортируйте сохраненный результат в шаге 3. |
| accepted | Проверьте доступ, а затем восстановите принятую работу в шаге 3. |
| uncertain / intent | Держите задание на паузе. Проверьте remoteId, candidateRemoteIds и History, прежде чем принимать решение о повторной отправке. |
| failed | Сначала исправьте errorCode. Неудачная запись сохраняется; замена - новая задача и может использовать кредиты. |
| partial | Сохраняйте доступные результаты. Восстановление известных рабочих мест; для объемных работ проверьте каждый ряд перед заменой неисправных предметов. |
| run_not_found | Проверьте профиль, пользователя OS и каталог состояния. Ищите сохраненные квитанции или History, если журнал потерян. |

- [История открытых запросов](https://flashdata.dev/app/jobs)
- [Восстановление объемных результатов](https://flashdata.dev/ru/docs/guides/bulk/reference.md)

<a id="decide"></a>

## 2. Проверьте доступ к учетной записи CLI

Эти бесплатные чеки требуют доступа к исходной учетной записи и источникам API. Устранение любой ошибки аутентификации перед восстановлением результатов.

### Проверить доступ и прочитать баланс

```bash
: "${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
```


<a id="access-result"></a>

### Проверьте эти поля

Нулевой баланс – это вопрос финансирования новой работы. Это не означает, что ключ недействителен.

| поле auth status | Ожидаемый |
| --- | --- |
| data.accessVerified | true; в противном случае исправьте доступ перед чтением результатов. |
| data.identity.identity.accountId | Счет, который выдал задание. |
| data.identity.permittedSources | Включает в себя источник, используемый сохраненной задачей. |
| data.identity.identity.recurringAllowed | true перед повторным выполнением задачи. |


<a id="account-change"></a>

### Аккаунт изменился, или я только что потребовал суд.

run_account_mismatch означает, что сохраненный запуск принадлежит другой учетной записи или API. Повторное использование имени профиля не переносит этот запуск.

| Положение | Меры |
| --- | --- |
| Неправильный аккаунт | Проверяйте оверрайд ключа окружающей среды, выбранный профиль и происхождение management/data. Восстановите предполагаемый счет до восстановления. |
| Ключ вращается | Используйте ключ замены для той же учетной записи с необходимым разрешением источника. Сохраните исходный профиль, каталог состояния и запустите ID. |
| Пробный доступ привязан к аккаунту | Счет владельца отличается от временного счета. Прочитайте результаты испытаний, которые вы уже экспортировали. Используйте новый запуск ID только для предполагаемой новой задачи владельца; он использует баланс владельца. |

- [Заменить ключ владельца](https://flashdata.dev/ru/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Пробный доступ и привязка к аккаунту](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#owner-result)

<a id="handoff"></a>

### Возобновить прерванное требование

Для утвержденной заявки запустите auth finish в своем первоначальном профиле в окне передачи 24-час. Он сохраняет и проверяет ключ владельца, а затем подтверждает установку. Вторая команда проверяет сохраненный доступ в новом процессе.

#### Завершите существующую передачу

```bash
: "${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
```

- [Исчезнувшая претензия или утерянный регистрационный ответ](https://flashdata.dev/ru/docs/guides/agent-onboarding/reference.md#help)
- [Протокол аутентификации](https://flashdata.dev/auth.md)

<a id="recover"></a>

## 3. Восстановление результата CLI

Выберите сохраненный статус из шага 1. Используйте выходное имя файла, которого не существует. Обе команды проверяют доступ и сохраняют исходный запуск; ни одна из них не отправляет запрос на замену.

### Спасти успех

#### Экспорт сэкономленного результата

```bash
: "${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
```


### Принятая работа Async

Тайм-аут для голосования останавливает местное ожидание. Запустите эту команду восстановления снова, чтобы продолжать ждать той же работы.

#### Подождите оригинальную работу

```bash
: "${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
```


- [Удаленная работа ID](https://flashdata.dev/ru/docs/guides/async-batch/reference.md#job-status)

<a id="verify"></a>

### Подтвердить восстановление до возобновления

1. Проверьте код выхода 0 и ok: true, затем откройте recovered.json. Экспорт сэкономленных результатов имеет cached: true; использование относится к первоначальному исполнению.
2. Сохраняйте одну и ту же учетную запись, профиль, состояние и запустите ID при повторном использовании этого события. Не удаляйте его журнал или не переименовывайте прогон, чтобы заставить повторную попытку.
3. Расписание резюме только после доступа и результат проверяется. Каждое новое запланированное событие имеет свой собственный запуск ID.

- [Повторяющийся бегун](https://flashdata.dev/ru/docs/guides/recurring-tasks/reference.md#slot)
- [Сохранить результаты для последующего использования](https://flashdata.dev/ru/docs/guides/save-results/reference.md)

<a id="mcp"></a>

## Восстановление задачи MCP

Звонки MCP не создают записи запуска CLI. Используйте существующее соединение MCP для учетной записи, которая предоставила работу. Замените работу ID в этой подсказке и отправьте ее своему подключенному агенту.

### Вставьте свой подключенный агент

```text
Восстановите свою существующую работу 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](https://flashdata.dev/ru/docs/guides/agent-access/reference.md)
- [Инструмент MCP](https://flashdata.dev/ru/docs/mcp/reference.md)

<a id="mcp-job"></a>

### Прочитайте оригинальную работу

Для пользовательского клиента MCP передайте этот объект callTool после замены job_id. get_job проверяет учетную запись вакансии и разрешение источника; успешная проверка get_balance сама по себе не доказывает доступ к этой работе.

#### get_job

```json
{
  "name": "get_job",
  "arguments": {
    "job_id": "job_REPLACE_WITH_SAVED_ID"
  }
}
```


<a id="mcp-status"></a>

### Проверьте статус работы MCP

| Ответ | Следующее действие |
| --- | --- |
| job.status: pending / processing | Подождите, а затем прочитайте ту же работу ID. Местный тайм-аут не отменяет его. |
| job.status: completed | Экономьте выход. Его использование относится к исходному запросу; get_job не отправляет и не взимает плату за новый запрос. |
| job.status: failed / isError: true | Прочитайте ошибку перед использованием любого вывода. Не перезагружайте источник автоматически. |
| code: result_unavailable | Повторите прочтение для временной неисправности доставки. Если сэкономленный результат истек, используйте более ранний экспорт. Результаты Async JSON сохраняются в течение часов 24. |


<a id="mcp-chunks"></a>

### Большой ответ MCP был прерван

Используйте сохраненный result_id с тем же ключом API. Начните с офсета 0, чтобы восстановить весь ответ; если вы сохранили предыдущие фрагменты, используйте их точный next_offset вместо этого. Замените заполнитель, прежде чем вызывать этот инструмент.

1. Приведите каждый фрагмент в порядок, используя next_offset, пока он не станет null. Парсировать комбинированный JSON можно только после последнего куска.
2. Кэш длится 10 минуты и сохраняет четыре самых новых больших ответа на ключ. Если он истек или был выселен, и вы сохранили работу ID, позвоните в get_job снова и прочитайте его новые куски.
3. Реакция в режиме реального времени не имеет гарантированной восстановимой фоновой работы. Без сохраненной работы ID или экспорта, проверьте History и спросите перед запуском нового платного запроса.

#### get_result

```json
{
  "name": "get_result",
  "arguments": {
    "result_id": "REPLACE_WITH_RESULT_ID",
    "offset": 0
  }
}
```

- [Клиент MCP с обработкой кусков](https://flashdata.dev/ru/docs/guides/mcp-custom-client/reference.md)

<a id="missing-id"></a>

## У меня нет работы или работы ID

Проверьте сохраненные файлы задачи, историю инструментов агента и запрос владельца History. request_id — это диагностический ID, а не job_id. Если вы не можете подтвердить, было ли представление принято, сделайте паузу. Повторение исходного вызова может создать еще один заряд.

- [История открытых запросов](https://flashdata.dev/app/jobs)

<a id="errors"></a>

## Найти исправление по коду ошибки

| сигнальный сигнал | исправлять |
| --- | --- |
| 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 верните принятую удаленную работу. Полученные результаты требуют более раннего экспорта или собственного хранения. |

- [Ссылка на ошибку HTTP](https://flashdata.dev/ru/docs/errors/reference.md)
- [Подключите хост MCP](https://flashdata.dev/ru/docs/guides/agent-access/reference.md)

<a id="support"></a>

## Отправить диагностику для поддержки

Для CLI запустите этот фильтр jq на error.json, сохраненный вашей задачей. Для MCP, код копирования, http_status и request_id из ответа инструмента, а также сохраненный job_id или result_id. Включите клиентскую версию, конечную точку, время UTC и подтверждено ли принятие или неизвестно. Исключите учетные данные, файлы cookie и подписанные URLs.

### Выберите диагностические поля - только локальные

```bash
# Read a saved CLI error envelope; no network request.
jq '{ok, runId, error: (.error | {
  code, httpStatus, retryAfter, runId, remoteId
})}' error.json
```

- [Связаться с поддержкой](https://flashdata.dev/ru/contact)
