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

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

Канонічне посилання: https://flashdata.dev/uk/docs/guides/agent-recovery
Переглянуто: 2026-11-05 від FlashData

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

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

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

| У вас є | Зареєструватися |
| --- | --- |
| CLI runId | Заходи CLI нижче, з оригінальним профілем та державним каталогом. |
| MCP робота ID · робота_. | get_job на існуючому підключенні MCP. |
| MCP результат ID · результат_. | get_result до finish читання великої відповіді. |
| Запуск OpenClaw ID | OpenClaw запускає історію, потім FlashData ID записаний цим ходом. |

- [CLI відновлення](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md#inspect)
- [MCP відновлення](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md#mcp)
- [Історія запуску OpenClaw](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md#inspect-test)

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

## 1. Огляд забігу CLI

Відкрити Bash (Git Bash на Windows) як оригінальний користувач OS, у вашій папці вихідного завдання. Замініть всі три значення нижче з тих, хто з оригінального завдання. Зберігайте цей термінал відкритим для кроків 2 і 3. Unsetting 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/uk/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/uk/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Пробний доступ і прив’язування облікового запису](https://flashdata.dev/uk/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/uk/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
```


### Прийнята робота з асинхроном

Час випилювання припиняє локальне очікування. Запустіть цю команду відновлення знову, щоб зберегти очікування на тій же роботі.

#### Зачекайте оригінальну роботу

```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/uk/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/uk/docs/guides/recurring-tasks/reference.md#slot)
- [Заощаджуйте результати для подальшого використання](https://flashdata.dev/uk/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/uk/docs/guides/agent-access/reference.md)
- [MCP інструмент посилання](https://flashdata.dev/uk/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/uk/docs/guides/mcp-custom-client/reference.md)

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

## У мене немає запуску або роботи ID

Перевірити збережені файли, історію інструментів агента та запит власника History. A 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/uk/docs/errors/reference.md)
- [Від'єднати MCP хост](https://flashdata.dev/uk/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/uk/contact)
